Reddit コンバージョンコネクタ構成ガイド
この記事では、Reddit コンバージョンコネクタの構成方法について説明します。
API 情報
このコネクタは以下のベンダー API を使用します:
- API 名:Reddit API
- API バージョン:v2.0
- API エンドポイント:
https://ads-api.reddit.com/api/v2.0 - ドキュメント:Reddit API
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:1000
- 最古のリクエストからの最大時間:60分
- リクエストの最大サイズ:1 MB
構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します:
- アカウント ID
- (必須)コンバージョンイベントが属するReddit広告アカウントのIDです。
- Reddit広告アカウントIDを見つけるには、Reddit広告UIで コンバージョンイベント > ピクセルID に移動します。
- Reddit広告アカウントには、
adsread、history、adsconversions、およびadsleadgendownloaderの権限が必要です。 - 詳細については、Reddit: 認証を参照してください。
- コンバージョンアクセストークン
- コンバージョンアクセストークンは、RedditのコンバージョンAPIにコンバージョンイベントデータを送信するための、期限のない安全なキーです。
- この簡単に生成され、共有可能で長期間有効なアクセストークンは、ビジネス内の任意の広告アカウントの任意の管理者によって使用できます。
- Redditは、コンバージョンAPI用の開発者アクセストークン/ OAuthよりもコンバージョンアクセストークンの使用を推奨しています。
- 詳細については、Reddit: コンバージョンアクセストークンを参照してください。
- コンバージョンアクセストークンを使用していない場合は、OAuth認証ワークフローを開始するために 接続を確立 ボタンを使用します。
- OAuthからコンバージョンアクセストークンに移行するには、コンバージョンアクセストークンフィールドにトークンを入力し、コネクタはそのトークンをOAuthトークンの代わりに使用します。
ウェブイベントの重複排除
このコネクタを構成して、Reddit Pixelタグからのイベントを重複排除するには、次の命名規則を使用してイベントIDをイベント属性として送信します:
reddit_pixel_event_id_{REDDIT_EVENT}_{TAG_UID}
タグのUIDは、Tealium iQのタグテーブルまたはタグの詳細画面で見つけることができます:
たとえば、UIDが168のタグからの購入イベントは、次の属性値を送信します:
{
"reddit_pixel_event_id_Purchase_168": "028b2ade7478..."
}
同じタグからのカートに追加イベントは、次の属性値を送信します:
{
"reddit_pixel_event_id_AddToCart_168": "084b1cda7461..."
}
各タイプのイベントに対して別のアクションを使用します。イベント固有のイベントID属性を Event ID にマッピングし、一致するイベント名を Event Name にマッピングします。たとえば:
| Tealium属性 | Redditパラメータ |
|---|---|
reddit_pixel_event_id_Purchase_168 (属性) |
Event ID |
"Purchase" (カスタムテキスト) |
Event Name |
タグUIDなしで命名形式 reddit_pixel_event_id_{REDDIT_EVENT} を使用してイベントID属性のみを受け取っている場合は、タグを更新することをお勧めします。詳細については、Reddit Pixel タグ構成ガイドを参照してください。
自動重複排除
自動重複排除値が入力されている場合、コネクタは対応するイベントID属性を探します。このセクションが入力されていてTealium iQを使用している場合、Event IDを追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用している場合は、次のアプローチが必要になる場合があります。
コネクタは次の操作順序に従います:
- 自動重複排除が入力され、データレイヤーでその値が見つかった場合、その値は
Event IDにマッピングされたものよりも優先されます。たとえば、reddit_pixel_event_id_Purchase_30。 - 自動重複排除が入力されているが、タグIDバージョンを見つけることができないが、レガシーバージョン(IDなし)を見つけることができる場合、その値が使用されます。たとえば、
reddit_pixel_event_id_Purchase。 - 自動重複排除が入力されているが、値が見つからない場合は、
Event IDが入力されている場合に使用されます。
アクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| コンバージョン送信 | ✗ | ✓ |
アクション名を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
コンバージョン送信
Reddit PixelタグとRedditコンバージョンコネクタの両方を実装している場合のみ、コンバージョンID構成を使用することをお勧めします。この値が不適切に渡されると、帰属とキャンペーンのパフォーマンスに影響を与える可能性があります。
パラメータ
| パラメータ | 説明 |
|---|---|
| イベント名 | コンバージョントラッキングイベントの種類。イベント名はリストされた値のいずれかであるか、カスタムの文字列値である可能性があります。 |
| イベント時間 | コンバージョンイベントが発生した時のRFC3339タイムスタンプ。デフォルトでは、コネクタは現在の時間を送信します。 |
| コンバージョンID | 特定のコンバージョンイベントに対応するユニークなコンバージョンID。コンバージョンIDは重複排除に使用され、複数回送信された場合でも同じコンバージョンイベントが複数回処理されるのを防ぎます。 |
| 取引価値(小数) | 通貨の基本単位での取引の価値。 |
| 通貨 | 提供された価値のための3文字のISO 4217通貨コード。 |
| アイテム数 | イベント内のアイテム数。 |
| テストモード | API統合をテストするために true に構成します。アカウントにデータは投稿されません。 |
| RedditクリックID | 単一の広告クリックに関連付けられたReddit生成のID。 |
| 電話番号(既にSHA256ハッシュ化) | 空白トリム、小文字化、およびSHA256ハッシュ化された電話番号を提供します。 |
| 電話番号(SHA256ハッシュを適用) | プレーンテキストの電話番号を提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。 |
| メールアドレス(既にSHA256ハッシュ化) | 空白トリム、小文字化、およびSHA256ハッシュ化されたメールアドレスを提供します。 |
| メールアドレス(SHA256ハッシュを適用) | プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。 |
| IPアドレス | コネクタはマップされたIPアドレスをSHA256ハッシュ化します。 |
| ユーザーエージェント | ユーザーのブラウザのユーザーエージェント。 |
| 外部ID(既にSHA256ハッシュ化) | ユーザーに対して広告主が割り当てた永続的な識別子(RedditクリックIDまたは追加の帰属信号を伴う必要があります)。すでに空白トリム、小文字化、およびSHA256ハッシュ化された値を提供します。 |
| 外部ID(SHA256ハッシュを適用) | ユーザーに対して広告主が割り当てた永続的な識別子(Redditクリック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から。 |
| アカウントIDオーバーライド | コンバージョンイベントに関連付けられたReddit広告アカウントのID。このマッピングを使用してアカウントIDを動的にオーバーライドし、必要に応じて1つのコネクタインスタンスで複数のRedditアカウントを使用します。 |
製品データ
| パラメータ | 説明 |
|---|---|
| 製品ID | 製品IDの配列。 |
| 製品名 | 製品名の配列。 |
| 製品カテゴリ | 製品カテゴリの配列。 |
処理データ
| パラメータ | 説明 |
|---|---|
| モード | このコンバージョンイベントのデータ処理モード。 |
| 国 | ISO 3166-1 alpha-2国コード。 |
| 地域 | ISO 3166-2地域コード。国のプレフィックスなしで地域コードのみも受け付けます。 |
自動重複排除
| パラメータ | 説明 |
|---|---|
| Tealium iQタグID | Tealium iQタグUIDが提供されると、TealiumはTealium iQから送信されたイベントID値を自動的に検索します。 |
最終更新日 :: 2025年December月17日