Reddit コンバージョンコネクタ構成ガイド | サーバーサイドコネクター

API 情報

このコネクタは以下のベンダー API を使用します：

API 名：Reddit API
API バージョン：v2.0
API エンドポイント：https://ads-api.reddit.com/api/v2.0
ドキュメント：Reddit API

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

最大リクエスト数：1000
最古のリクエストからの最大時間：60分
リクエストの最大サイズ：1 MB

コネクタアクション

アクション名	AudienceStream	EventStream
コンバージョン送信	✗	✓

構成の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

アカウントID
- 必須。コンバージョンイベントが属するReddit広告アカウントのIDです。
- Reddit広告アカウントIDを見つけるには、Reddit広告UIでコンバージョンイベント > ピクセルIDに移動します。
- Reddit広告アカウントには、adsread、history、adsconversions、adsleadgendownloaderの権限が必要です。
- 詳細については、Reddit: 認証を参照してください。
コンバージョンアクセストークン
- コンバージョンアクセストークンは、RedditのコンバージョンAPIにコンバージョンイベントデータを送信するための、有効期限のない安全なキーです。
- この簡単に生成できる、共有可能な長期間有効なアクセストークンは、ビジネス内の任意の広告アカウントの任意の管理者によって使用することができます。
- Redditは、コンバージョンAPI用の開発者アクセストークン/ OAuthよりもコンバージョンアクセストークンの使用を推奨しています。
- 詳細については、Reddit: コンバージョンアクセストークンを参照してください。
- コンバージョンアクセストークンを使用していない場合は、接続を確立ボタンを使用してOAuth認証ワークフローを開始します。
- OAuthからコンバージョンアクセストークンに移行するには、コンバージョンアクセストークンフィールドにトークンを入力し、コネクタはそのトークンをOAuthトークンの代わりに使用します。

アクション

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

コンバージョン送信

Reddit コンバージョンコネクタのコンバージョンID構成は、Reddit PixelタグとReddit コンバージョンコネクタの両方を実装している場合にのみ使用することをお勧めします。コンバージョンID構成を使用すると、同じコンバージョンイベントが両方のソースから送信された場合に二重にカウントされるのを防ぐことができます。この値が不適切に渡されると、帰属とキャンペーンのパフォーマンスに影響を与える可能性があります。

パラメータ

パラメータ	説明
イベント名	コンバージョン追跡イベントのタイプ。イベント名はリストされた値のいずれか、またはカスタムの文字列値にすることができます。
イベント時間	コンバージョンイベントが発生したRFC3339タイムスタンプ。デフォルトでは、コネクタは現在の時間を送信します。
コンバージョンID	特定のコンバージョンイベントに対応する一意のコンバージョンID。コンバージョンIDは重複排除に使用され、同じコンバージョンイベントが複数回送信された場合にそれが複数回処理されるのを防ぎます。
取引価値（小数）	通貨の基本単位での取引の価値。
通貨	提供された値のための3文字のISO 4217通貨コード。
アイテム数	イベント内のアイテム数。
テストモード	`true`に構成すると、API統合をテストします。アカウントにデータは投稿されません。
RedditクリックID	単一の広告クリックに関連付けられたReddit生成のID。
電話番号（既にSHA256ハッシュ化されている）	すでに空白トリム、小文字化、SHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
メールアドレス（既にSHA256ハッシュ化されている）	すでに空白トリム、小文字化、SHA256ハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
IPアドレス	マップされたIPアドレスをSHA256ハッシュ化します。
ユーザーエージェント	ユーザーのブラウザのユーザーエージェント。
外部ID（既にSHA256ハッシュ化されている）	ユーザーに対して広告主が割り当てた永続的な識別子（Reddit Click IDまたは追加の帰属信号を伴う必要があります）。すでに空白トリム、小文字化、SHA256ハッシュ化された値を提供します。
外部ID（SHA256ハッシュを適用）	ユーザーに対して広告主が割り当てた永続的な識別子（Reddit Click IDまたは追加の帰属信号を伴う必要があります）。コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
IDFA（既にSHA256ハッシュ化されている）	ユーザーのデバイスのIDFA。すでに空白トリム、小文字化、SHA256ハッシュ化された値を提供します。
IDFA（SHA256ハッシュを適用）	ユーザーのデバイスのIDFA。コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
AAID（既にSHA256ハッシュ化されている）	ユーザーのデバイスのAAID。すでに空白トリム、小文字化、SHA256ハッシュ化された値を提供します。
AAID（SHA256ハッシュを適用）	ユーザーのデバイスのAAID。コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
オプトアウト	ユーザーがトラッキングをオプトアウトしたかどうかを示すフラグ。
画面の高さ	ユーザーの画面の高さ（ピクセル単位）。画面の高さを構成しない場合、`events.user.screen_dimensions`はTealium Collectイベントデータから取得されます。例えば、`data.com.viewport_height`からです。
画面の幅	ユーザーの画面の幅（ピクセル単位）。画面の幅を構成しない場合、`events.user.screen_dimensions`はTealium Collectイベントデータから取得されます。例えば、`data.com.viewport_width`からです。