Snapchat Conversionsコネクタ構成ガイド
この記事では、Snapchat Conversionsコネクタの構成方法について説明します。
仕組み
Snapchat ConversionsコネクタはSnap Conversions APIを使用します。Snap Conversions APIは、構造化されたプライバシー重視のインターフェースで、Web、アプリ、オフラインのイベントをサーバー間（S2S）統合を通じて直接Snapに渡すことができます。このAPIは、Snap Pixelと同様のイベントトラッキングをサポートし、コンバージョンを行ったデバイスタイプによっても分割されます。このトリガーにより、モバイルコンバージョンにはSnap App IDを、WebおよびオフラインのコンバージョンイベントにはPixel IDを使用することができます。
Snap Conversions APIは、単独でデプロイすることも、クライアント側のSnap Pixelと併用することもできます。
SnapのConversions APIについての詳細は、Snap: Conversion APIを参照してください。
API情報
このコネクタは以下のベンダーAPIを使用します：
- API名：Snapchat Marketing API - Conversion API
- APIバージョン：v3
- APIエンドポイント：
https://tr.snapchat.com/v3/conversion
前提条件
- コネクタを追加した後、asintegrations@tealium.comをSnapchat BusinessマネージャーにMemberロールで招待し、適用可能なAdアカウントにData Managerロールを割り当てる必要があります。
この手順は承認までに最大3営業日かかる場合があります。招待が受け入れられたかどうかは、Snapchat Adsアカウントのユーザーを表示することで確認できます。
詳細については、Snap: メンバーとロールの管理を参照してください。
考慮事項
- キャンペーンの最適化を解除するためには、イベントが発生したらすぐに送信することをお勧めします。理想的には、イベントが発生した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、App、またはOffline）である
- 選択したイベントが2つ以上のソースに追加されている
Tealiumは、統合構成に基づいて重複排除の推奨事項を提供しています：
- 単一ソースの冗長性 - 同じ統合で送信されたイベントの重複。
同じ統合ソースを通じて複数回コンバージョンを送信する場合、情報の一貫性を保つことを強く推奨します。 - クロスソースの冗長性 - 複数の統合から送信されたイベントの重複。
複数の統合からデータを送信する場合、最適化、ターゲティング、測定能力を最大限に活用するために、冗長なデータを送信することを推奨します。
重複排除のユースケースに応じて、以下のパラメータを使用します：
- イベントID - Webとオフラインチャネルの一意のイベントを重複排除します。48時間の重複排除ウィンドウを許可します。
- トランザクションID - すべてのチャネル（Web、モバイル、オフライン）の購入イベントの重複排除が可能です。30日間の重複排除ウィンドウを許可します。
- モバイル広告ID - AAIDやハッシュ化されたIDFVのような共有デバイス識別子を使用して、一意のイベントの重複排除を行います。
詳細については、Snap: ベストプラクティス - 重複排除を参照してください。
自動重複排除
バージョン3では、コネクタはClient Dedup IDの代わりにEvent IDを重複排除に使用します。
Automatic Deduplicationの値がTealium iQタグUIDで入力されている場合、コネクタは対応するイベント属性を探します。このセクションが入力されており、Tealium iQを使用している場合、Event IDを追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用する場合は、以下のアプローチが必要となる場合があります。
コネクタの操作順序は以下の通りです：
- Automatic Deduplicationが入力されており、その値がデータレイヤーで見つかる場合（例：
6V5xX1T0n9pC42luElKD）、この値はEvent IDにマッピングされたものを上書きします。 - Automatic Deduplicationが入力されているが、タグIDバージョンを見つけることができず、レガシーバージョン（IDが付いていないもの）を見つけることができる場合、その値が使用されます（例：
6V5xX1T0n9pC42luElKD）。 - Automatic Deduplicationが入力されているが、その値が見つからない場合、マッピングされたEvent IDが使用されます（入力されている場合）。
タグのUIDは、Tealium iQのTagsテーブルまたはタグ詳細画面で見つけることができます：
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| Send Conversion V3 | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な手順については、コネクタ概要を参照してください。
コネクタを追加した後、以下の構成を構成します：
- Long Lived Token：この認証方法は3-legged OAuthフローを必要とせず、有効期限がありません。詳細については、Snap: Static Long Lived Tokensを参照してください。
アクション構成 - パラメータとオプション
Nextをクリックするか、Actionsタブに移動します。ここでコネクタアクションを構成します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - Send Conversion V3
パラメータ
| パラメータ | 説明 |
|---|---|
| Event Type | ドロップダウンリストからイベントタイプを選択します。 |
| Event Conversion Type | イベントが発生した場所。例えば、OFFLINE、WEB、またはMOBILE_APP。 |
Conversion Data
| パラメータ | 説明 |
|---|---|
| Pixel ID | Adアカウントに関連付けられたPixel ID。 |
| App ID | 特定のアプリケーションに割り当てられた一意のID。iOSのIDは数値で、AndroidのIDはGoogle Advertising ID（GAID）です。 |
| Snap App ID | アプリに関連付けられたSnap App ID。これはAds Managerで生成された一意のコードで、MMPダッシュボードに含まれています。 |
| Event Tag | カスタムイベントセットラベル。例えば、店内、週末のセール、バック・トゥ・スクールキャンペーンなど。このパラメータは、将来のタグ付けやオーディエンスターゲティングに使用できます。 |
| Event Time | このコンバージョンのエポックタイムスタンプ。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。 |
| Event Source URL | イベントソースのURL。 |
| Event ID | イベントID。 |
| データ処理オプション | WEBイベントのオプトインまたはオプトアウトを示します。iOS 14.5以上のユーザーでオプトアウトする場合、このパラメータの値をLMUの値を持つ単一要素のリストに構成します。それ以外の場合、このパラメータを構成しないでください。現在受け付けている値は：LMU、DELETEです。 |
| 広告主トラッキング有効 | MOBILE_APPイベントのオプトインまたはオプトアウトを示します。受け付けている値は：オプトインの場合はTrue、オプトアウトの場合はFalseです。 |
| テストイベントコード | イベントテストコード。 |
| 説明 | 追加情報のための文字列説明。 |
| レベル | ゲームのコンテキストでのレベルを表します。 |
| インテグレーション | インテグレーションには2つのタイプがあります。直接またはパートナーを通じて。パートナーインテグレーションを使用している場合、このパラメータをパートナーまたはコネクタ名で構成します。例えば、tealiumやmparticleなど。 |
コンテンツデータ
| パラメータ | 説明 |
|---|---|
| コンテンツカテゴリ | アイテムのカテゴリ。 |
| コンテンツID | コンテンツのID。 |
| コンテンツ名 | イベントに関連するページまたは製品の名前。 |
| コンテンツタイプ | content_typeフィールドは、content_idsまたはcontentsのキーが何を表しているかを示します。個々のアイテムの場合はproduct、サイズ、色、その他のバリエーションが複数あるアイテムの場合はproduct_groupを選択します。 |
| 通貨 | 標準のISO 4217コード、例えばEUR、USD、JPY。 |
| アイテム数 | アイテム数（整数、単一の値）。このフィールドが配列にマップされている場合、配列要素の合計に変換されます。 |
| 注文ID | 購入した注文のID。 |
| 予測寿命価値 | コンバージョンイベントの予測寿命価値。 |
| 値 | 特定のイベントに関連する購入価値。PURCHASEイベントには必須です。 |
| 検索文字列 | 検索されたテキスト。 |
| サインアップ方法 | サインアップ方法を示す文字列、Facebook、Email、Xなど。 |
| ブランド | コンバージョンイベントのitem_idsに関連するブランド。 |
コンテンツ情報
| パラメータ | 説明 |
|---|---|
| ID | アイテムID。 |
| 数量 | アイテムの数量。 |
| アイテム価格 | アイテムの価格。 |
| 配送カテゴリ | 注文に使用された配送方法。 |
ユーザー情報
| パラメータ | 説明 |
|---|---|
| 電話番号 | (SHA256ハッシュを適用) 小文字のプレーンテキストのメールアドレスを提供し、コネクタがSnapchatが期待する形式でこの値をハッシュ化します。空またはnullのハッシュ値は無視されます。 |
| 電話番号 | (すでにSHA256ハッシュ化されている) SHA256ハッシュ化された電話番号を提供します。 |
| モバイル広告ID | モバイル広告主ID。 |
| IPアドレス | デバイスのIPアドレス。 |
| ベンダー識別子 | プレーンテキストのベンダー識別子を提供し、コネクタがSnapchatが期待する形式でこの値をハッシュ化します。 |
| 名 | 名は小文字のみで記入します。 |
| 姓 | 姓は小文字のみで記入します。 |
| 性別 | 顧客の性別。サポートされている値：fは女性、mは男性。 |
| 市区町村 | コンバージョンに関連する市区町村。小文字のみで記入します。 |
| 州 | コンバージョンに関連する州。 |
| 郵便番号 | 小文字の郵便番号または郵便番号。 |
| 国 | イベントに関連する国。 |
| 外部ID | ロイヤリティカードIDやその他の識別子などの一意のID。 |
| サブスクリプションID | このイベントを生成したユーザーのサブスクリプションID。 |
| リードID | Snapchatリード広告に関連する識別子。 |
| Anon ID | このパラメータはアプリイベント専用です。それは一意のアプリケーションインストールIDを表します。 |
| ダウンロードID | アプリダウンロードイベントに関連するID |
| クリックID | ランディングページURLの**&ScCid=クエリパラメータに格納されているID値。このIDを使用すると、広告測定のパフォーマンスが向上します。また、Click IDを使用している広告主には、完全な宛先URLをEvent Source URL**フィールドに渡すことをお勧めします。詳細については、Snap: Click IDの送信を参照してください。 |
| Cookie1 | Pixel SDKを使用している場合、ドメインの_scid値を見てファーストパーティクッキーにアクセスできます。 |
| クライアントユーザーエージェント | ユーザーのウェブブラウザのユーザーエージェント文字列。 |
| メールアドレス | (すでにSHA256ハッシュ化されている) SHA256ハッシュ化されたメールアドレスを提供します。 |
ダイナミックトラベル広告
| パラメータ | 説明 |
|---|---|
| チェックイン日 | ホテルのタイムゾーンでの希望のホテルチェックイン日。受け付けている形式は`YYYYMMDD`, `YYYY`-MM-`DD`, `YYYY`-MM-DDThh:mmTZD および `YYYY`-MM-DDThh:mm:ssTZDです。 |
| 旅行終了 | 旅行の終了日。 |
| 旅行開始 | 旅行の開始日。 |
| 提案された目的地 | 提案された目的地。 |
| 目的地空港 | 目的地空港のIATAコード。 |
| 国 | ユーザーが訪れる予定の場所に基づいた国。 |
| 市区町村 | ユーザーが訪れる予定の場所に基づいた市区町村。 |
| 地域 | ユーザーが興味を持っている州、地区、または地域。 |
| 近隣 | ユーザーが興味を持っている近隣。 |
| 出発出発日 | 旅行の開始日と時間。 |
| 出発到着日 | 旅行の目的地での到着日と時間。 |
| 大人の数 | 宿泊する大人の数。 |
| 空港コード | 出発空港の公式IATAコード。 |
| 帰国出発日 | 帰国旅行の開始日と時間。 |
| 帰国到着日 | 帰国旅行が完了する日と時間。 |
| 子供の数 | 宿泊する子供の数。 |
| ホテルスコア | ホテルのスコア、他のホテルに対する広告主の相対的なスコア。 |
| 郵便番号 | 郵便番号またはZIPコード。 |
| 乳児の数 | 宿泊する乳児の数。 |
| 優先近隣 | 滞在のための優先近隣。 |
| 優先スターレーティング | 最小と最大のホテルスターレーティングをタプルとして提供します。例えば、star1,star2または["star1", "star2"]。 |
| 提案されたホテル | 提案されたホテル。 |
| 目的地ID | カタログ内の目的地を代表するID。 |
拡張デバイス情報
必要なパラメータ：
| パラメータ | 説明 |
|---|---|
| バージョン | バージョン。 |
| アプリパッケージ名 | アプリのパッケージ名。 |
| 短いバージョン | アプリケーションの短いバージョン。例えば、1。 |
| 長いバージョン | アプリケーションの長いバージョン。例えば、1.0.12.1。 |
| OSバージョン | OSのバージョン。 |
| デバイスモデル名 | デバイスのモデル名。 |
| ロケール | ロケール。 |
| タイムゾーン略称 | タイムゾーンの略称。 |
| キャリア | キャリア。 |
| 画面幅 | 画面の幅。 |
| 画面高さ | 画面の高さ。 |
| 画面密度 | 画面の密度。 |
| CPUコア数 | CPUのコア数。 |
| 外部保存サイズ（GB） | 外部保存のサイズ（GB）。 |
| 外部保存の空き容量（GB） | 外部保存の空き容量（GB）。 |
| デバイスのタイムゾーン | デバイスのタイムゾーン。 |
自動重複排除
| パラメータ | 説明 |
|---|---|
| Automappingの無効化 | Automappingが無効になっている場合、デフォルトで自動マップされたパラメータはベンダーに送信されません。 |
最終更新日 :: 2025年January月31日