Reddit Conversions コネクタ構成ガイド | サーバーサイドコネクタ

API情報

このコネクタは以下のベンダーAPIを使用します：

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

バッチ制限

このコネクタは、ベンダーへの大量のデータ転送をサポートするために、バッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

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

コネクタアクション

アクション名	AudienceStream	EventStream
コンバージョンの送信	✗	✓

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。

コネクタを追加した後、以下の構成を構成します：

アカウントID
必須。コンバージョンイベントが所属するReddit AdアカウントのID。Reddit AdアカウントIDを見つけるには、Reddit Ads UIのConversions Events > Pixel IDに移動します。Reddit Adアカウントには、次の権限が必要です：adsread、history、adsconversions、およびadsleadgendownloader。詳細については、Reddit: 認証を参照してください。

アクション

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

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

コンバージョンの送信

Reddit PixelタグとReddit Conversionsコネクタの両方を実装している場合に限り、Reddit ConversionsコネクタのConversion ID構成の使用を推奨します。Conversion ID構成を使用すると、同じコンバージョンイベントが両方のソースで送信された場合に二重にカウントされるのを防ぐことができます。この値が不適切に渡されると、アトリビューションとキャンペーンパフォーマンスに影響を与えます。

パラメータ

パラメータ	説明
イベント名	コンバージョントラッキングイベントのタイプ。イベント名は、リストされた値のいずれか、またはカスタムの文字列値にすることができます。
イベント時間	コンバージョンイベントが発生したRFC3339タイムスタンプ。デフォルトでは、コネクタは現在の時間を送信します。
コンバージョンID	特定のコンバージョンイベントに対応する一意のコンバージョンID。コンバージョンIDは重複排除に使用され、同じコンバージョンイベントが複数回送信された場合に、それが一度以上処理されるのを防ぎます。
トランザクション値（小数）	通貨の基本単位でのトランザクションの値。
通貨	提供された値のISO 4217通貨コードの3文字。
アイテム数	イベント内のアイテム数。
テストモード	API統合をテストするために`true`に構成します。データはアカウントに投稿されません。
Reddit Click ID	単一の広告クリックに関連付けられたRedditが生成したID。
メールアドレス（既にSHA256でハッシュ化済み）	既に空白をトリムし、小文字にし、SHA256でハッシュ化したメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	プレーンテキストのメールアドレスを提供し、コネクタはこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
IPアドレス	コネクタはマップされたIPアドレスをSHA256ハッシュ化します。
ユーザーエージェント	ユーザーのブラウザのユーザーエージェント。
外部ID（既にSHA256でハッシュ化済み）	ユーザーに対する広告主が割り当てた永続的な識別子（Reddit Click IDまたは追加のアトリビューション信号を伴う必要があります）。既に空白をトリムし、小文字にし、SHA256でハッシュ化した値を提供します。
外部ID（SHA256ハッシュを適用）	ユーザーに対する広告主が割り当てた永続的な識別子（Reddit Click 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`から。