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分
- リクエストの最大サイズ：2MB
重複排除
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を使用している場合、Event IDを追加する必要はありません。ただし、Tealium iQを使用せずにEventStreamを使用している場合は、以下のアプローチが必要になる場合があります。
コネクタの操作順序は次のとおりです：
- Automatic Deduplicationが入力されており、その値がデータレイヤーで見つかる場合（例：
6V5xX1T0n9pC42luElKD）、この値はEvent IDにマッピングされたものを上書きします。 - Automatic Deduplicationが入力されているが、タグIDバージョンを見つけることができず、レガシーバージョン（IDが付いていないもの）を見つけることができる場合、その値が使用されます（例：
6V5xX1T0n9pC42luElKD）。 - Automatic Deduplicationが入力されているが、その値が見つからない場合、マッピングされたEvent IDが使用されます（入力されている場合）。
コネクタアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| Send Conversion V3 | ✓ | ✓ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタ概要を参照してください。
コネクタを追加した後、以下の構成を構成します：
- Long Lived Token：この認証方法は3-legged OAuthフローを必要とせず、有効期限がありません。詳細については、Snap: Static Long Lived Tokensを参照してください。
アクション構成 - パラメータとオプション
次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - Send Conversion V3
パラメータ
| パラメータ | 説明 |
|---|---|
| イベントタイプ | ドロップダウンリストからイベントタイプを選択します。 |
| イベントコンバージョンタイプ | イベントが発生した場所。例えば、OFFLINE、WEB、またはMOBILE_APP。 |
コンバージョンデータ
| パラメータ | 説明 |
|---|---|
| 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。 |
| Data Processing Options | 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 を使用している広告主には、Event Source URL フィールドに完全な宛先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が無効になっている場合、デフォルトで自動マッピングされたパラメータはベンダーに送信されません。 |
最終更新日 :: 2024年December月5日