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

API情報

このコネクタは、次のベンダーAPIを使用します。

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

バッチ制限

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

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

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

Pixel ID
- （必須）コンバージョンイベントが属するReddit広告アカウントのPixel ID。
- Pixel IDを確認するには、Reddit Ads UIでConversion Events > Pixel IDに移動します。
- Reddit広告アカウントには、adsread、history、adsconversions、adsleadgendownloaderの権限が必要です。
- 詳細については、Reddit：認証を参照してください。
Conversion Access Token
- コンバージョンアクセストークンは、有効期限のない安全なキーで、コンバージョンイベントデータをReddit Conversions APIに送信するために使用します。
- ビジネス内の任意の広告アカウントの管理者は、簡単に生成でき、共有可能で長期間有効なこのアクセストークンを使用できます。
- Redditでは、Conversions APIに開発者アクセストークンまたはOAuthを使用するよりも、コンバージョンアクセストークンを使用することを推奨しています。
- 詳細については、Reddit：コンバージョンアクセストークンを参照してください。
- コンバージョンアクセストークンを使用しない場合は、Establish Connectionボタンを使用してOAuth認証ワークフローを開始します。
- OAuthからコンバージョンアクセストークンに移行するには、コンバージョンアクセストークンフィールドにトークンを入力します。これにより、コネクタはOAuthトークンの代わりにそのトークンを使用します。
- イベントごとにこのトークンを上書きするには、Send Conversion V3アクションのConversion Access Token Overrideフィールドをマッピングします。

コネクタの構成が完了したら、Doneをクリックします。

Webイベントの重複排除

このコネクタでReddit Pixelタグからのイベントを重複排除するには、次の命名規則に従ってイベント属性として送信されるイベントIDを使用します。

reddit_pixel_event_id_{REDDIT_EVENT}_{TAG_UID}

タグのUIDは、タグ管理のTagsテーブルまたはタグの詳細画面で確認できます。

たとえば、UIDが168のタグから送信されるPurchaseイベントには、次の属性値が含まれます。

{
  "reddit_pixel_event_id_Purchase_168": "028b2ade7478..."
}

同じタグから送信されるAdd To Cartイベントには、次の属性値が含まれます。

{
  "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タグ構成ガイドを参照してください。

自動重複排除

Automatic Deduplicationの値が構成されている場合、コネクタは対応するイベントID属性を検索します。このセクションが構成されており、タグ管理を使用している場合は、Event IDをマッピングする必要はありません。ただし、タグ管理を使用せずにEventStreamを使用する場合は、次の方法が引き続き必要になることがあります。

コネクタは次の順序で処理します。

Automatic Deduplicationが構成され、その値がデータレイヤーに存在する場合、その値はEvent IDにマッピングされた値より優先されます。例：reddit_pixel_event_id_Purchase_30。
Automatic Deduplicationが構成されていて、タグIDを含むバージョンが見つからないものの、従来のバージョン（IDなし）が見つかった場合は、その値が使用されます。例：reddit_pixel_event_id_Purchase。
Automatic Deduplicationが構成されているものの値が見つからない場合、構成されていれば、マッピングされたEvent IDが使用されます。

アクション

アクション名	訪問プロファイル	イベントデータ
Send Conversion V3	✗	✓
Send Conversion V2（非推奨）	✗	✓

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

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

Send Conversion V3

パラメータ

パラメータ	説明
Event Type Data	標準イベントのトラッキングタイプ：Add to Cart、Add to Wishlist、Lead、Page Visit、Purchase、Search、Sign Up、View Content、Custom。
Custom Event Type	トラッキングタイプを`CUSTOM`に構成した場合のカスタムイベント名。自由形式で大文字と小文字が区別され、スペースを含めて最大64文字です。たとえば、`Promotion Event`と`PromotionEvent`は別々のイベントとして扱われます。Redditでは、既存のイベントと一致しない値に構成することを推奨しています。
Event Testing	Reddit Test IDを指定してテストを有効にします。

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

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

パラメータ	説明
Event At	コンバージョンイベントが発生した時点のUnixエポックタイムスタンプ（ミリ秒単位）。デフォルトでは、コネクタによって`tealium_timestamp_epoch`が自動的にマッピングされます。
Conversion ID	個別のコンバージョンイベントに対応する一意のコンバージョンID。Conversion IDは重複排除に使用され、同じコンバージョンイベントが複数回送信された場合に、複数回処理されるのを防ぎます。
Value	通貨の基本単位で表したトランザクションの値。
Currency	指定された値に使用する3文字のISO 4217通貨コード。
Item Count	イベント内のアイテム数。

ユーザーデータ

各コンバージョンイベントには、少なくとも1つのアトリビューションシグナルが必要です。アトリビューションの精度とパフォーマンスを向上させるため、Redditでは可能な限り多くのシグナルを送信することを推奨しています。Click ID、メールアドレス、IPアドレス + ユーザーエージェント + 画面サイズ、IDFA、AAIDのいずれかを指定する必要があります。

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

商品データ

パラメータ	説明
商品ID	商品IDの配列。
商品名	商品名の配列。
商品カテゴリー	商品カテゴリーの配列。
数量	商品の個数。これらの商品レベルの属性は、イベントレベルの「値」および「アイテム数」パラメータの代わりにはなりません。
商品単価	商品1個あたりの価格。これらの商品レベルの属性は、イベントレベルの「値」および「アイテム数」パラメータの代わりにはなりません。

データ処理オプション

パラメータ	説明
モード	このコンバージョンイベントのデータ処理モードの配列。Redditでサポートされているのは`LDU`（Limited Data Use）のみです。
国	ISO 3166-1 alpha-2規格のユーザーの国コード。
地域	ISO 3166-2規格のユーザーの地域コード、または国のプレフィックスを含まない地域コード。
Pixel IDの上書き	コンバージョンイベントが属するReddit広告アカウントのPixel ID。
コンバージョンアクセストークンの上書き	このイベントについて、コネクタ構成で指定されたコンバージョンアクセストークンを上書きします。イベントを複数のReddit広告アカウントにルーティングする場合や、安全な属性からトークンを割り当てる場合に使用します。このフィールドが空であるか、マッピングされていない場合、コネクタは構成済みの値を使用します。どちらも構成されていない場合、イベントはスキップされます。上書きトークンが異なるイベントは、個別のリクエストに分割されます。
自動重複排除	Tag ManagementタグのUIDが指定されている場合、コネクタはTealiumから送信されたConversion IDまたはEvent IDの値を自動的に検索します。
アクションソース	コンバージョンイベントの発生元。サポートされている値は、WEBSITE、APP、PHYSICAL_STORE、OTHERです。空白の場合、コネクタはデフォルトでWEBSITEを使用します。
イベントソースURL	コンバージョンイベントが発生したWebページの完全なURL。クリックIDの自動抽出によってアトリビューションを改善できるよう、Redditではクエリパラメータを含めることを推奨しています。空白で、E-Commerce Automappingが有効になっている場合、コネクタは現在のページURLを自動的にマッピングします。

自動マッピングの無効化

パラメータ	説明
識別子の自動マッピングを無効化	有効にすると、識別子シグナルの自動マッピングが抑制されます。対象には、Reddit Click ID（`rdt_cid`から取得）、UUID（`_rdt_uuid` Cookieから取得）、IPアドレス（Tealium Client IP属性から取得）、およびユーザーエージェントが含まれます。明示的なマッピングが常に優先されます。
E-Commerceの自動マッピングを無効化	有効にすると、識別子以外のシグナルの自動マッピングが抑制されます。対象には、画面サイズ（Tealium Collectのビューポートフィールドから取得）、Event Atタイムスタンプのフォールバック、およびEvent Source 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	1回の広告クリックに関連付けられた、Redditが生成したID。
電話番号（SHA256ハッシュ化済み）	前後の空白を削除し、小文字に変換してSHA256でハッシュ化済みの電話番号を指定します。
電話番号（SHA256ハッシュを適用）	プレーンテキストの電話番号を指定します。コネクタは内線番号と数字以外のすべての文字を削除し、番号が`+`で始まる（E.164形式）ことを確認した後、結果をSHA256でハッシュ化します。
メールアドレス（SHA256ハッシュ化済み）	前後の空白を削除し、小文字に変換してSHA256でハッシュ化済みのメールアドレスを指定します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを指定します。コネクタはアドレスを小文字に変換し、メールエイリアスを削除（たとえば、`user+alias@example.com`を`user@example.com`に変換）し、ユーザー名から英数字以外の文字を削除した後、結果をSHA256でハッシュ化します。
IPアドレス	IPv4またはIPv6形式のユーザーのIPアドレス。指定された形式のままRedditに送信されます（ハッシュ化されません）。
ユーザーエージェント	ユーザーのブラウザーのユーザーエージェント。
外部ID（SHA256ハッシュ化済み）	広告主がユーザーに割り当てた永続的な識別子（RedditクリックIDまたは追加のアトリビューションシグナルと併せて指定する必要があります）。前後の空白を削除し、小文字に変換してSHA256でハッシュ化済みの値を指定します。
外部ID（SHA256ハッシュを適用）	広告主がユーザーに割り当てた永続的な識別子（RedditクリックIDまたは追加のアトリビューションシグナルと併せて指定する必要があります）。コネクタはこの値の前後の空白を削除し、小文字に変換してSHA256でハッシュ化します。
IDFA（SHA256ハッシュ化済み）	ユーザーのデバイスのIDFA。前後の空白を削除し、小文字に変換してSHA256でハッシュ化済みの値を指定します。
IDFA（SHA256ハッシュを適用）	ユーザーのデバイスのIDFA。コネクタは、SHA256でハッシュ化する前に、この値をハイフン付きの大文字UUID形式に正規化します。`00000000-0000-0000-0000-000000000000`などのプレースホルダー値は破棄されます。
AAID（SHA256ハッシュ化済み）	ユーザーのデバイスのAAID。前後の空白を削除し、小文字に変換してSHA256でハッシュ化済みの値を指定します。
AAID（SHA256ハッシュを適用）	ユーザーのデバイスのAAID。コネクタは、SHA256でハッシュ化する前に、この値をハイフン付きの小文字UUID形式に正規化します。`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を動的に上書きし、必要に応じて1つのコネクタインスタンスで複数のReddit広告アカウントを使用できます。

商品データ

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

データ処理

パラメータ	説明
モード	このコンバージョンイベントのデータ処理モード。
国	ISO 3166-1 alpha-2国コード。
地域	ISO 3166-2地域コード。国の接頭辞を含まない地域コードのみでも指定できます。

自動重複排除

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