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 広告 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}

Tealium iQ のタグテーブルまたはタグの詳細画面でタグの UID を見つけることができます：

たとえば、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は可能な限り多くの信号を送信することを推奨しており、帰属の精度とパフォーマンスが向上します。次のうち少なくとも1つを入力する必要があります：クリックID、メールアドレス、IPアドレス + ユーザーエージェント + 画面サイズ、IDFA、AAID。

パラメータ	説明
Reddit クリック ID	単一の広告クリックに関連付けられたReddit生成のID。
メールアドレス	(SHA256ハッシュを適用) プレーンテキストのメールアドレスを提供します。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。
電話番号	(SHA256ハッシュを適用) プレーンテキストの電話番号を提供します。コネクタはこの値を空白トリム、正規化し、SHA256を使用してハッシュします。
IPアドレス	コネクタはマップされたIPアドレスをSHA256でハッシュします。
ユーザーエージェント	ユーザーのブラウザのユーザーエージェント。
外部ID	(SHA256ハッシュを適用) 広告主が割り当てたユーザーの永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。
IDFA	(SHA256ハッシュを適用) ユーザーのデバイスのIDFA。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。
AAID	(SHA256ハッシュを適用) ユーザーのデバイスのAAID。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュします。
画面の高さ	ユーザーの画面の高さ（ピクセル単位）。
画面の幅	ユーザーの画面の幅（ピクセル単位）。
UUID	ドメイン上のファーストパーティピクセル `_rdt_uuid` クッキーからの値。全体の値またはUUID部分のみを使用します。

製品データ

パラメータ	説明
製品ID	製品IDの配列。
製品名	製品名の配列。
製品カテゴリ	製品カテゴリの配列。

データ処理オプション

パラメータ	説明
モード	このコンバージョンイベントのデータ処理モードの配列。Redditは `LDU`（限定データ使用）のみをサポートします。
国	ユーザーの国コード（ISO 3166-1 alpha-2標準）。
地域	ユーザーの地域コード（ISO 3166-2標準）または国の接頭辞なしの地域コード。
アカウントIDオーバーライド	コンバージョンイベントが属するReddit広告アカウントのID。

Send Conversion (非推奨)

RedditはConversions API v3を導入したため、このアクションは非推奨となりました。既存のアクションマッピングを Send Conversion V3 アクションに移行するために Copy Mappings to an Action の使用を推奨します。