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

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トークンの代わりに使用します。
- イベントごとにこのトークンを上書きするには、Send Conversion V3アクションで コンバージョンアクセストークンオーバーライド フィールドをマップします。

Webイベントの重複排除

このコネクタを構成して、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
Send Conversion V3	✗	✓
Send Conversion V2 (非推奨)	✗	✓

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

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

Send Conversion V3

パラメータ

パラメータ	説明
イベントタイプデータ	標準イベントのトラッキングタイプ：カートに追加、ウィッシュリストに追加、リード、ページ訪問、購入、検索、サインアップ、コンテンツ表示、カスタム。
カスタムイベントタイプ	トラッキングタイプが `CUSTOM` に構成されている場合のカスタムイベント名。自由形式、大文字小文字を区別し、スペースを含む64文字まで。たとえば、`Promotion Event` と `PromotionEvent` は異なるイベントとみなされます。Redditは、既存のイベントと一致しない値を構成することを推奨しています。
イベントテスト	RedditテストIDを提供することでテストを有効にします。

本番トラフィックに対してイベントテストを有効にしないでください。Redditはテストイベントを秒間10イベントに制限しています。この制限を超えるリクエストはHTTP 429エラーを返すことがあります。本番トラフィックを送信する場合はイベントテストを空のままにしてください。

コンバージョンイベントパラメータ

パラメータ	説明
イベント発生時	コンバージョンイベントが発生したときのUnixエポックタイムスタンプ（ミリ秒単位）。デフォルトでは、コネクタは自動的に `tealium_timestamp_epoch` をマップします。
コンバージョンID	それぞれのコンバージョンイベントに対応する一意のコンバージョンID。コンバージョンIDは重複排除に使用され、複数回送信された場合でも同じコンバージョンイベントが複数回処理されるのを防ぎます。
値	通貨の基本単位での取引の値。
通貨	提供された値のための3文字のISO 4217通貨コード。
アイテム数	イベント内のアイテム数。

ユーザーデータ

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

パラメータ	説明
Reddit クリック ID	単一の広告クリックに関連付けられたReddit生成のID。コネクタは、このフィールドのマッピングを構成しない限り、`rdt_cid`クエリパラメータからこの値を自動的にマッピングします。
メールアドレス	(SHA256ハッシュを適用) プレーンテキストのメールアドレスを提供します。コネクタはこの値を正規化してからハッシュ化します：アドレスを小文字に変換、メールエイリアスを削除（`+`から`@`までのすべてを削除）、ユーザー名から非英数字を削除、その後SHA-256で結果をハッシュ化します。
電話番号	(SHA256ハッシュを適用) プレーンテキストの電話番号を提供します。コネクタはこの値を正規化してからハッシュ化します：拡張子を削除、すべての非数字文字を削除、番号が`+`（E.164形式）で始まることを確認、その後SHA-256で結果をハッシュ化します。
IPアドレス	ユーザーのIPアドレス（IPv4またはIPv6形式）。Redditに提供されたまま送信されます（ハッシュ化されません）。
ユーザーエージェント	ユーザーのブラウザのユーザーエージェント。
外部ID	(SHA256ハッシュを適用) ユーザーに対して広告主が割り当てた永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。
IDFA	(SHA256ハッシュを適用) ユーザーのデバイスのIDFA。コネクタはこの値をハッシュ化する前にダッシュ付きの大文字UUID形式に正規化します。`00000000-0000-0000-0000-000000000000`のようなプレースホルダー値は破棄されます。
AAID	(SHA256ハッシュを適用) ユーザーのデバイスのAAID。コネクタはこの値をハッシュ化する前にダッシュ付きの小文字UUID形式に正規化します。`00000000-0000-0000-0000-000000000000`のようなプレースホルダー値は破棄されます。
画面の高さ	ユーザーの画面の高さ（ピクセル単位）。
画面の幅	ユーザーの画面の幅（ピクセル単位）。
UUID	ドメイン上のファーストパーティピクセル`_rdt_uuid`クッキーからの値。完全な値またはUUID部分のみを使用します。この値はハッシュ化されません。コネクタは、このフィールドのマッピングを構成しない限り、`_rdt_uuid`クッキーからこの値を自動的にマッピングします。

製品データ

パラメータ	説明
製品ID	製品IDの配列。
製品名	製品名の配列。
製品カテゴリ	製品カテゴリの配列。
数量	製品の単位数。これらの製品レベルの属性は、イベントレベルのValueおよびItemCountパラメータを置き換えるものではありません。
アイテム価格	製品の単位あたりの価格。これらの製品レベルの属性は、イベントレベルのValueおよびItemCountパラメータを置き換えるものではありません。

データ処理オプション

パラメータ	説明
モード	このコンバージョンイベントのデータ処理モードの配列。Redditは`LDU`（Limited Data Use）のみをサポートします。
国	ユーザーの国コード（ISO 3166-1 alpha-2標準）。
地域	ユーザーの地域コード（ISO 3166-2標準または国のプレフィックスなしの地域コード）。
アカウントIDオーバーライド	コンバージョンイベントが属するReddit広告アカウントのID。
コンバージョンアクセストークンオーバーライド	このイベントのためにコネクタ構成で構成されたコンバージョンアクセストークンをオーバーライドします。複数のReddit広告アカウントにイベントをルーティングするためにこのフィールドを使用するか、セキュア属性からトークンを割り当てます。このフィールドが空またはマッピングされていない場合、コネクタは構成された値を使用します。構成されていない場合、イベントはスキップされます。異なるオーバーライドトークンを持つイベントは別々のリクエストに分割されます。
自動重複排除	Tealium iQタグUIDが提供された場合、コネクタは自動的にTealiumから送信されたConversion IDまたはEvent ID値を検索します。
アクションソース	コンバージョンイベントのソース。サポートされる値はWEBSITE、APP、PHYSICAL_STORE、およびOTHERです。空白の場合、コネクタはデフォルトでWEBSITEに構成されます。
イベントソースURL	コンバージョンイベントが発生したウェブページの完全なURL。Redditは自動クリックID抽出を通じて帰属を改善するためにクエリパラメータを含むことを推奨します。空白の場合、かつE-Commerce Automappingが有効な場合、コネクタは現在のページURLを自動マッピングします。

自動マッピング無効化

パラメータ	説明
識別子自動マッピング無効化	有効にすると、識別信号の自動マッピングが抑制されます。この抑制には、RedditクリックID（`rdt_cid`から）、UUID（`_rdt_uuid`クッキーから）、IPアドレス（TealiumクライアントIP属性から）、およびユーザーエージェントが含まれます。明示的なマッピングが常に優先されます。
E-Commerce自動マッピング無効化	有効にすると、識別子以外の信号の自動マッピングが抑制されます。この抑制には、画面サイズ（Tealium Collectビューポートフィールドから）、Event Atタイムスタンプのフォールバック、およびイベントソースURL（現在のページURLから）が含まれます。明示的なマッピングが常に優先されます。

Send Conversion V2（非推奨）

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通貨コード。
アイテム数	イベント内のアイテム数。
テストモード	API統合をテストするために `true` に構成します。テストデータはアカウントに投稿されません。本番トラフィックの場合はこの構成を無効にしてください。
RedditクリックID	単一の広告クリックに関連付けられたReddit生成のID。
電話番号（既にSHA256ハッシュ化済み）	空白トリム、小文字化、およびSHA256ハッシュ化された電話番号を提供してください。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を提供してください。コネクタは拡張子を削除し、すべての非数字文字を削除し、番号が `+`（E.164形式）で始まることを確認した後、SHA256で結果をハッシュ化します。
メールアドレス（既にSHA256ハッシュ化済み）	空白トリム、小文字化、およびSHA256ハッシュ化されたメールアドレスを提供してください。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供してください。コネクタはアドレスを小文字化し、メールエイリアスを削除し（例：`user+alias@example.com` は `user@example.com` になります）、ユーザー名から英数字以外の文字を削除し、その後SHA256で結果をハッシュ化します。
IPアドレス	ユーザーのIPアドレス。IPv4またはIPv6形式で、Redditに提供された通りに送信されます（ハッシュ化されません）。
ユーザーエージェント	ユーザーのブラウザのユーザーエージェント。
外部ID（既にSHA256ハッシュ化済み）	ユーザーに対して広告主が割り当てた永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。すでに空白トリム、小文字化、およびSHA256ハッシュ化された値を提供してください。
外部ID（SHA256ハッシュを適用）	ユーザーに対して広告主が割り当てた永続的な識別子（RedditクリックIDまたは追加の帰属信号を伴う必要があります）。コネクタはこの値を空白トリム、小文字化し、SHA256を使用してハッシュ化します。
IDFA（既にSHA256ハッシュ化済み）	ユーザーのデバイスのIDFA。すでに空白トリム、小文字化、およびSHA256ハッシュ化された値を提供してください。
IDFA（SHA256ハッシュを適用）	ユーザーのデバイスのIDFA。コネクタはこの値をダッシュ付きの大文字UUID形式に正規化し、SHA256でハッシュ化します。`00000000-0000-0000-0000-000000000000`のようなプレースホルダー値は破棄されます。
AAID（既にSHA256ハッシュ化済み）	ユーザーのデバイスのAAID。すでに空白トリム、小文字化、およびSHA256ハッシュ化された値を提供してください。
AAID（SHA256ハッシュを適用）	ユーザーのデバイスのAAID。コネクタはこの値をダッシュ付きの小文字UUID形式に正規化し、SHA256でハッシュ化します。`00000000-0000-0000-0000-000000000000`のようなプレースホルダー値は破棄されます。
オプトアウト	ユーザーがトラッキングからオプトアウトしたかどうかを示すフラグ。
画面の高さ	ユーザーの画面の高さ（ピクセル単位）。画面の高さを構成しない場合、`events.user.screen_dimensions`はTealium Collectイベントデータから取得されます。例えば、`data.com.viewport_height`からです。
画面の幅	ユーザーの画面の幅（ピクセル単位）。画面の幅を構成しない場合、`events.user.screen_dimensions`はTealium Collectイベントデータから取得されます。例えば、`data.com.viewport_width`からです。
アカウントIDオーバーライド	コンバージョンイベントに関連付けられたReddit広告アカウントのID。このマッピングを使用してアカウントIDを動的にオーバーライドし、必要に応じて一つのコネクタで複数のRedditアカウントを使用します。

製品データ

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

処理データ

パラメータ	説明
モード	このコンバージョンイベントのデータ処理モード。
国	ISO 3166-1 alpha-2国コード。
地域	ISO 3166-2地域コード。国のプレフィックスなしで地域コードのみも受け入れます。

自動重複排除

パラメータ	説明
Tealium iQタグID	Tealium iQタグUIDが提供されると、TealiumはTealium iQから送信されたイベントID値を自動的に検索します。