Reddit Conversions コネクタ構成ガイド
この記事では、Reddit Conversions コネクタの構成方法について説明します。
API 情報
このコネクタは以下のベンダー API を使用します:
- API 名:Reddit API
- API バージョン:v3
- API エンドポイント:
https://ads-api.reddit.com/api/v3 - ドキュメント:Reddit 広告 API
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数:1000
- 最古のリクエストからの最大時間:60分
- リクエストの最大サイズ:1 MB
構成
コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、以下の構成を構成します:
- アカウント ID
- (必須)変換イベントが属する Reddit 広告アカウントの ID。
- Reddit 広告アカウント ID を見つけるには、Reddit Ads UI の Conversions Events > Pixel ID に移動します。
- Reddit 広告アカウントには、
adsread、history、adsconversions、adsleadgendownloaderの権限が必要です。 - 詳細については、Reddit: 認証を参照してください。
- 変換アクセストークン
- 変換アクセストークンは、変換イベントデータを Reddit Conversions API に送信するための、期限のない安全なキーです。
- あなたのビジネス内の任意の広告アカウントの管理者が、この簡単に生成できる共有可能な長期アクセストークンを使用できます。
- Reddit は、Conversions API 用の開発者アクセストークン / OAuth よりも変換アクセストークンの使用を推奨しています。
- 詳細については、Reddit: 変換アクセストークンを参照してください。
- 変換アクセストークンを使用していない場合は、接続を確立 ボタンを使用して OAuth 認証ワークフローを開始します。
- OAuth から変換アクセストークンに移行するには、変換アクセストークンフィールドにトークンを入力し、コネクタはそのトークンを OAuth トークンの代わりに使用します。
- イベントごとにこのトークンをオーバーライドするには、Send Conversion V3 アクションで 変換アクセストークンオーバーライド フィールドをマップします。
Web イベントの重複排除
このコネクタを Reddit Pixel タグ からのイベントの重複排除に構成するには、次の命名規則でイベント属性として送信されるイベント ID を使用します:
reddit_pixel_event_id_{REDDIT_EVENT}_{TAG_UID}
タグの UID は、Tealium iQ の Tags テーブルまたはタグの詳細画面で見つけることができます:
たとえば、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 |
|---|---|---|
| Send Conversion V3 | ✗ | ✓ |
| Send Conversion (非推奨) | ✗ | ✓ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
Send Conversion V3
パラメータ
| パラメータ | 説明 |
|---|---|
| イベントタイプデータ | 標準イベントのトラッキングタイプ:カートに追加、ウィッシュリストに追加、リード、ページ訪問、購入、検索、サインアップ、コンテンツ表示、カスタム。 |
| カスタムイベントタイプ | トラッキングタイプが CUSTOM に構成されている場合のカスタムイベント名。自由形式、大文字小文字を区別し、スペースを含む 64 文字まで。たとえば、Promotion Event と PromotionEvent は異なるイベントとみなされます。Reddit は、既存のイベントと一致しない値を構成することを推奨しています。 |
| イベントテスト | Reddit テスト ID を提供することでテストを有効にします。 |
変換イベントパラメータ
| パラメータ | 説明 |
|---|---|
| イベント発生時 | 変換イベントが発生したときの Unix エポックタイムスタンプ(ミリ秒単位)。デフォルトでは、コネクタは自動的に tealium_timestamp_epoch をマップします。 |
| 変換 ID | 特定の変換イベントに対応する一意の変換 ID。変換 ID は重複排除に使用され、同じ変換イベントが複数回送信された場合に一度以上処理されないようにします。 |
| 値 | トランザクションの値(通貨の基本単位)。 |
| 通貨 | 提供された値の通貨に対する 3 文字の ISO 4217 通貨コード。 |
| アイテム数 | イベントのアイテム数。 |
ユーザーデータ
各変換イベントには少なくとも1つの帰属信号が必要です。Redditは可能な限り多くの信号を送信することを推奨しており、帰属の精度とパフォーマンスを向上させます。次のいずれかが入力されている必要があります:クリックID、メールアドレス、IPアドレス + ユーザーエージェント + 画面サイズ、IDFA、AAID。
| パラメータ | 説明 |
|---|---|
| Reddit クリック ID | 単一の広告クリックに関連付けられたReddit生成のID。この値は rdt_cid クエリパラメータから自動的にマッピングされますが、このフィールドに対してマッピングを構成することもできます。 |
| メールアドレス | (SHA256ハッシュを適用) プレーンテキストのメールアドレスを提供します。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。 |
| 電話番号 | (SHA256ハッシュを適用) プレーンテキストの電話番号を提供します。コネクタはこの値を空白トリム、正規化し、SHA256を使用してハッシュします。 |
| IPアドレス | マッピングされたIPアドレスをSHA256でハッシュ化します。 |
| ユーザーエージェント | ユーザーのブラウザのユーザーエージェント。 |
| 外部ID | (SHA256ハッシュを適用) ユーザーに対して広告主が割り当てた永続的な識別子(RedditクリックIDまたは追加の帰属信号を伴う必要があります)。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。 |
| IDFA | (SHA256ハッシュを適用) ユーザーのデバイスのIDFA。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。 |
| AAID | (SHA256ハッシュを適用) ユーザーのデバイスのAAID。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。 |
| 画面の高さ | ユーザーの画面の高さ(ピクセル単位)。 |
| 画面の幅 | ユーザーの画面の幅(ピクセル単位)。 |
| UUID | ドメイン上のファーストパーティピクセル _rdt_uuid クッキーからの値。完全な値またはUUID部分のみを使用します。この値はハッシュされません。このフィールドに対してマッピングを構成しない限り、コネクタは _rdt_uuid クッキーから自動的にこの値をマッピングします。 |
製品データ
| パラメータ | 説明 |
|---|---|
| 製品ID | 製品IDの配列。 |
| 製品名 | 製品名の配列。 |
| 製品カテゴリ | 製品カテゴリの配列。 |
データ処理オプション
| パラメータ | 説明 |
|---|---|
| モード | この変換イベントのデータ処理モードの配列。Redditは LDU(限定データ使用)のみをサポートします。 |
| 国 | ユーザーの国コード(ISO 3166-1 alpha-2標準)。 |
| 地域 | ユーザーの地域コード(ISO 3166-2標準)または国のプレフィックスなしの地域コード。 |
| アカウントIDオーバーライド | 変換イベントが属するReddit広告アカウントのID。 |
| 変換アクセストークンオーバーライド | このイベントのためにコネクタ構成で構成された変換アクセストークンをオーバーライドします。複数のReddit広告アカウントへのイベントのルーティングや、セキュア属性からのトークンの割り当てに使用します。このフィールドが空またはマッピングされていない場合、コネクタは構成された値を使用します。構成されていない場合、イベントはスキップされます。異なるオーバーライドトークンを持つイベントは別々のリクエストに分割されます。 |
自動マッピング無効化
| パラメータ | 説明 |
|---|---|
| 自動マッピング無効化 | 有効にすると、コネクタはデフォルトでベンダーに自動マッピングされた値を送信しません。明示的なマッピングは引き続き適用されます。 |
変換送信(非推奨)
RedditはConversions API v3を導入したため、このアクションは非推奨となりました。既存のアクションマッピングをSend Conversion V3アクションに移行するためにCopy Mappings to an Actionの使用を推奨します。
API情報
このコネクタは次のベンダーAPIを使用します:
- API名:Reddit API
- APIバージョン:v2.0
- APIエンドポイント:
https://ads-api.reddit.com/api/v2.0 - ドキュメント:Reddit API
パラメータ
| パラメータ | 説明 |
|---|---|
| イベント名 | 変換トラッキングイベントのタイプ。イベント名はリストされた値のいずれか、またはカスタムの文字列値にすることができます。 |
| イベント時間 | 変換イベントが発生したときの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クリック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値を検索します。 |
最終更新日 :: 2026年July月1日