Snapchat Conversions Connector セットアップガイド | サーバーサイドコネクタ

動作原理

Snapchat Conversions コネクタは、Snap Conversions API を使用します。Snap Conversions API は、Web、アプリ、オフラインのイベントをSnapに直接渡すための構造化されたプライバシーセントリックなインターフェースです。このAPIは、Snap Pixelと同様のイベントトラッキングをサポートしており、変換を行ったデバイスタイプにも分割されています。このトリガーにより、モバイル変換にSnap App IDを使用し、Webおよびオフラインの変換イベントにはPixel IDを使用することができます。

Snap Conversions API は、スタンドアロンで展開することも、クライアントサイドのSnap Pixelと併用することもできます。

SnapのConversions APIの詳細については、SnapchatのドキュメントのConversion APIの記事を参照してください。

API情報

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

API名：Snapchat Marketing API - Conversion API
APIバージョン：v2
APIエンドポイント：https://tr.snapchat.com/v2/conversion

前提条件

コネクタを追加した後、Snapchat Business Managerにasintegrations@tealium.comを招待し、メンバーの役割でSnapchat Business Managerに割り当てる必要があります。

この手順は承認に最大で3営業日かかる場合があります。Snapchat広告アカウントのユーザーを表示して、招待が受け入れられたかどうかを確認できます。

詳細については、メンバーと役割の管理を参照してください。

考慮事項

キャンペーンの最適化を解除するために、イベントが発生した直後にイベントを送信することをお勧めします。イベントが発生してから1時間以内に送信することが理想です。
データをリアルタイムで送信することを強くお勧めします。これにより、キャンペーンによる結果がより速く表示され、現在のマーケットの需要に対して入札が競争力を保つことができます。
Conversions APIのリクエストは、サーバーイベントをSnapchat広告アカウントにリンクするための一意の識別子に関連付けられています。WebおよびオフラインのイベントにはPixel IDを使用し、アプリのイベントにはSnapchat App IDを使用します。

バッチ制限

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

最大リクエスト数：2000
最も古いリクエストからの経過時間の最大値：10分
リクエストの最大サイズ：2 MB

重複排除

Snap Conversions APIは、スタンドアロンのAPIとして使用することも、他のSnapchatのソリューションと併用することもできます。シグナルの損失を最小限に抑え、より効率的な結果を作成するために、Snap Conversion APIを介して同じイベントをパスすることをお勧めします。

Snap Conversions APIでは、次の条件が満たされる場合にのみイベントの重複排除が表示されます：

Snap App IDおよび/またはPixel IDに複数のソース（API、SDKなど）がある
イベントが同じ変換タイプ（Web、アプリ、またはオフライン）の場合
選択したイベントが2つ以上のソースに追加されている場合

Tealiumでは、統合構成に基づいて重複排除の推奨事項を提供しています：

単一ソースの冗長性 - 同じ統合から複数回送信されるイベントの重複。
同じ統合ソースを介して複数回変換を送信する場合は、一貫した情報を送信することを強くお勧めします。
クロスソースの冗長性 - 複数の統合から送信されるイベントの重複。
複数の統合からデータを送信する場合は、最適化、ターゲティング、および測定機能を確保するために、冗長なデータを送信することをお勧めします。

重複排除のユースケースに応じて、次のパラメータを使用します：

Client dedup ID - Webおよびオフラインチャネルの一意のイベントを重複排除します。48時間の重複排除ウィンドウがあります。
Transaction ID - すべてのチャネル（Web、モバイル、オフライン）の購入イベントを重複排除します。30日の重複排除ウィンドウがあります。
Mobile Ad ID - AAIDやハッシュ化されたIDFVなどの共有デバイス識別子を使用して、一意のイベントを重複排除します。

詳細については、Snap Conversions APIのドキュメントのDeduplication sectionを参照してください。

コネクタのアクション

アクション名	AudienceStream	EventStream
Send Conversion	✓	✓

構成の構成

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

アクションの構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでは、コネクタのアクションを構成します。

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

アクション - Send Conversion

パラメータ

パラメータ	説明
イベントタイプ	ドロップダウンリストからイベントタイプを選択します。
イベント変換タイプ	イベントが発生した場所を選択します。例：オフライン、Web、またはモバイルアプリ。
Pixel ID	Ad Accountに関連付けられたPixel ID。
App ID	特定のアプリケーションに割り当てられた一意のID。 iOSの場合は数値。 Google Android Advertising ID（AAID）。
Snap App ID	アプリに関連付けられたSnap App ID（Ads Managerで生成される一意のコード）。
イベントタグ	カスタムイベントセットのラベル。例：店舗内、週末セール、バックトゥスクールキャンペーン将来のタグ付けやオーディエンスターゲティングに使用できます。
タイムスタンプ	変換が発生するためのエポックタイムスタンプ。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
説明	追加情報のための文字列の説明。
アイテム数	アイテムの数（整数、単一の値）。このフィールドが配列にマッピングされている場合、配列要素の合計に変換されます。
通貨	標準のISO 4217コード。例：`EUR`、`USD`、`JPY`。
トランザクションID	変換イベントに関連付けられたトランザクションIDまたは注文ID。
レベル	ゲームの文脈でのレベルを表します。
クライアント重複ID	この単一のリクエストを識別するために使用されるID。同じバッチ内の他のリクエストと区別するために使用されます。注意：これは高度な機能です。この重複排除キーを使用する場合は、アプローチに自信を持っていることを確認してください。
データの使用	iOS 14.5以降のユーザーの場合、イベントをオプトインまたはオプトアウトとして扱うかどうかを示します。 `OPT_OUT`ユーザーイベントの場合、値は`lmu`のみのリストです。
検索文字列	検索されたテキスト。
ページURL	イベントが発生したWebページのURL。プロトコルを含める必要があります。
サインアップ方法	`Facebook`、`Email`、`Twitter`などのサインアップ方法を示す文字列。
アイテムカテゴリ	アイテムのカテゴリ。
アイテムID	該当する場合は国際商品番号（EAN）または他の製品またはカテゴリ識別子。配列とリストの値をキーにマッピングしてSnapchatに渡す必要があります。すべての配列とリストは同じ長さである必要があります。単一の値属性は、単一の値を含む配列に変換されます。
価格	アイテムの価格。
メールアドレス（SHA256ハッシュ適用済み）	小文字の平文のメールアドレスを指定し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。空またはnullのハッシュ化された値は無視されます。
メールアドレス（既にSHA256ハッシュ化済み）	SHA256ハッシュ化されたメールアドレスを指定します。
モバイル広告ID（既にSHA256ハッシュ化済み）	SHA256ハッシュ化されたモバイル広告ID（例：`iOS`、`IDFA`、または`AAID`）を指定します。空またはnullのハッシュ化された値は無視されます。
モバイル広告ID（SHA256ハッシュ適用済み）	小文字の平文のモバイル広告ID（例：`iOS`、`IDFA`、または`AAID`）を指定し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。
電話番号（既にSHA256ハッシュ化済み）	SHA256ハッシュ化された電話番号を指定します。空またはnullのハッシュ化された値は無視されます。
電話番号（SHA256ハッシュ適用済み）	平文の電話番号を指定し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。
IPアドレス（既にSHA256ハッシュ化済み）	SHA256ハッシュ化されたIPアドレスを指定します。空またはnullのハッシュ化された値は無視されます。
IPアドレス（SHA256ハッシュ適用済み）	平文のIPアドレスを指定し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。 Client IP属性を使用してください（推奨）。
ベンダー識別子（既にSHA256ハッシュ化済み）	SHA256ハッシュ化されたベンダー識別子を指定します。空またはnullのハッシュ化された値は無視されます。
ベンダー識別子（SHA256ハッシュ適用済み）	平文のベンダー識別子を指定し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。
ユーザーエージェント	User Agent属性を使用します。 EventStreamでこのフィールドがマッピングされていない場合、属性User Agentに自動マッピングされます。 AudienceStreamでこのフィールドがマッピングされていない場合、訪問の最後のUser Agentに自動マッピングされます。