Snapchat Conversionsコネクタ構成ガイド

仕組み

Snapchat ConversionsコネクタはSnap Conversions APIを使用します。Snap Conversions APIは、構造化されたプライバシー重視のインターフェースで、Web、アプリ、オフラインのイベントをSnapに直接サーバー間(S2S)統合で渡すことができます。この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

前提条件

• コネクタを追加した後、asintegrations@tealium.comをSnapchat BusinessマネージャーにMemberロールで招待し、適用可能なAdアカウントにData Managerロールを割り当てる必要があります。

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

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

考慮事項

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

バッチ制限

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

• リクエストの最大数：2000
• 最古のリクエストからの最大時間：10分
• リクエストの最大サイズ：2 MB

重複排除

Snap Conversions APIは、単独のAPIとして使用することも、他のSnapchatソリューションと併用することもできます。信号損失を最小限に抑え、より効率的な結果を得るために、Snap Pixelで構成した同じイベントをSnap Conversion APIに渡すことをお勧めします。

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

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

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

• 単一ソースの冗長性 - 同じ統合で送信されたイベントの重複。
  同じ統合ソースを通じて複数回コンバージョンを送信する場合、一貫した情報を渡すことを強く推奨します。
• クロスソースの冗長性 - 複数の統合から送信されたイベントの重複。
  複数の統合からデータを送信する場合、最適な最適化、ターゲティング、測定機能を確保するために、冗長なデータを送信することを推奨します。

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

• クライアント重複排除ID - Webとオフラインチャネルのユニークなイベントを重複排除します。48時間の重複排除ウィンドウを許可します。
• トランザクションID - すべてのチャネル（Web、モバイル、オフライン）の購入イベントを重複排除するための適格性。30日間の重複排除ウィンドウを許可します。
• モバイル広告ID - AAIDやハッシュ化されたIDFVのような共有デバイス識別子を使用して、ユニークなイベントの重複排除を行います。

詳細については、Snap Conversions APIドキュメンテーションの重複排除セクションを参照してください。

自動重複排除

自動重複排除の値が入力されている場合、コネクタは対応するイベント属性を探します。このセクションが入力されていて、Tealium iQを使用している場合、クライアント重複排除IDを追加する必要はもうありません。ただし、Tealium iQを使用せずにEventStreamを使用する場合は、以下のアプローチがまだ必要となる場合があります。

コネクタの操作順序は以下の通りです：

• 自動重複排除が入力されており、その値がデータレイヤーで見つかる場合（例：6V5xX1T0n9pC42luElKD）、この値はクライアント重複排除IDにマッピングされたものを上書きします。
• 自動重複排除が入力されているが、タグIDバージョンを見つけることができず、レガシーバージョン（IDが付いていないもの）を見つけることができる場合、その値が使用されます（例：6V5xX1T0n9pC42luElKD）。
• 自動重複排除が入力されているが、その値が見つからない場合、マッピングされたクライアント重複排除IDが使用されます（入力されている場合）。

コネクタアクション

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

構成の構成

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

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

• ロングリブドトークン：この認証方法は3-legged OAuthフローを必要とせず、有効期限がありません。詳細については、Snapchat: Static Long Lived Tokensを参照してください。

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

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

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

アクション - コンバージョンの送信

パラメータ

パラメータ	説明
イベントタイプ	ドロップダウンリストからイベントタイプを選択します。
イベントコンバージョンタイプ	イベントが発生した場所。例えば、オフライン、Web、モバイルアプリなど。
Pixel ID	Adアカウントに関連付けられたPixel ID。
App ID	特定のアプリケーションに割り当てられた一意のID。 iOSの場合は数値。 Google Android Advertising ID (AAID)。
Snap App ID	アプリに関連付けられたSnap App ID（Ads Managerで生成され、MMPダッシュボードに含まれる一意のコード）。
イベントタグ	カスタムイベントセットラベル。 例：店内、週末のセール、バック・トゥ・スクールキャンペーン 将来的なタグ付けとオーディエンスターゲティングに使用可能。
タイムスタンプ	コンバージョンが発生したエポックタイムスタンプ。 このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。
説明	追加情報のための文字列説明。
Number Items	アイテムの数（整数、単数値）。 このフィールドが配列にマッピングされている場合、配列要素の合計に変換されます。
Currency	標準のISO 4217コード。 例：EUR、USD、JPY。
Transaction ID	コンバージョンイベントに関連付けられたトランザクションIDまたは注文ID。
Level	ゲームのコンテキストにおけるレベルを表します。
Client Dedup ID	この単一のリクエストを識別するために使用されるID。 同じバッチ内の他のリクエストと区別するために使用されます。 注：これは高度な機能です。重複キーとして使用する場合は、まず自分のアプローチに自信があることを確認してください。
Data Use	iOS 14.5以上のユーザーの場合、イベントをオプトインまたはオプトアウトとして扱うべきかを示します。 OPT_OUTユーザーイベントの場合、値はlmuの値のみを含むリストです。
Search String	検索されたテキスト。
Page Url	イベントが発生したウェブページのURL。 プロトコルを含める必要があります。
Sign Up Method	サインアップ方法を示す文字列、例えばFacebook、Email、またはX。
Item Category	アイテムのカテゴリ。
Item ID	適用可能な場合は国際記事番号（EAN）、または他の製品またはカテゴリ識別子。 配列とリストの値をSnapchatに渡すためのキーにマップします。 すべての配列とリストは等しい長さであるべきです。 単一値属性は単一値を含む配列に変換されます。
Price	アイテムの価格。
Email Address (apply SHA256 hashed)	小文字のプレーンテキストのメールアドレスを提供し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。 空またはnullのハッシュ値は無視されます。
Email Address (already SHA256 hash)	SHA256でハッシュ化されたメールアドレスを提供します。
Mobile Ad ID (already SHA256 hashed)	モバイル広告IDを提供します。 例：iOS、IDFA、またはAAIDがSHA256でハッシュ化されています。 空またはnullのハッシュ値は無視されます。
Mobile Ad ID (apply SHA256 hash)	小文字のプレーンテキストのモバイル広告IDを提供します。 例：iOS、IDFA、またはAAIDとコネクタはSnapchatが期待する形式でこの値をハッシュ化します。
Phone Number (already SHA256 hashed)	SHA256でハッシュ化された電話番号を提供します。 空またはnullのハッシュ値は無視されます。
Phone Number (apply SHA256 hash)	プレーンテキストの電話番号を提供し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。
IP Address (already SHA256 hashed)	SHA256でハッシュ化されたIPアドレスを提供します。 空またはnullのハッシュ値は無視されます。
IP Address (apply SHA256 hash)	プレーンテキストのIPアドレスを提供し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。 クライアントIP属性を使用することを推奨します。
Vendor Identifier (already SHA256 hashed)	SHA256でハッシュ化されたベンダー識別子を提供します。 空またはnullのハッシュ値は無視されます。
Vendor Identifier (apply SHA256 hash)	プレーンテキストのベンダー識別子を提供し、コネクタはSnapchatが期待する形式でこの値をハッシュ化します。
User Agent	User Agent属性を使用します。 このフィールドがEventStreamでマッピングされていない場合、自動的にUser Agent属性にマッピングされます。 このフィールドがAudienceStreamでマッピングされていない場合、自動的に訪問の最後のUser Agentにマッピングされます。

自動重複排除

パラメータ	説明
Tealium iQ Tag ID	Tealium iQ Tag IDが提供されると、コネクタは自動的にTealium iQから送信されるClient Dedup IDの値を探します。