Snapchat コンバージョンコネクタ構成ガイド
この記事では、Snapchat コンバージョンコネクタの構成方法について説明します。
動作原理
Snapchat コンバージョンコネクタは Snap Conversions API を使用します。Snap Conversions API は、構造化されたプライバシー重視のインターフェースで、サーバーからサーバー(S2S)統合を通じて直接 Web、アプリ、オフラインイベントを 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
考慮事項
- キャンペーンの最適化を実現するために、イベントが発生したらできるだけ早く、理想的にはイベント発生後1時間以内にイベントを送信することをお勧めします。
- リアルタイムでデータを送信することを強く推奨します。これにより、キャンペーンによる結果をより早く確認でき、現在の市場需要に対抗して入札を維持することができます。
- Conversions API のリクエストは、サーバーイベントを Snapchat 広告アカウントにリンクする一意の識別子に関連付けられています。Web およびオフラインイベントには Pixel ID を、アプリイベントには Snapchat App ID を使用します。
バッチ制限
このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます:
- 最大リクエスト数: 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: Best Practices - Deduplicationを参照してください。
自動重複排除
バージョン3では、コネクタは Client Dedup ID の代わりに イベント ID を使用して重複排除を行います。
自動重複排除 の値が Tealium iQ タグ UID で入力されている場合、コネクタは対応するイベント属性を検索します。このセクションが入力されており、Tealium iQ を使用している場合、イベント ID を追加する必要はありません。ただし、Tealium iQ なしで EventStream を使用する場合は、次のアプローチが必要になる場合があります。
操作の順序は次のとおりです:
- 自動重複排除 が入力され、データレイヤーで値が見つかった場合(例:
6V5xX1T0n9pC42luElKD
)、この値が イベント ID でマッピングされたものより優先されます。 - 自動重複排除 が入力されているが、タグ ID バージョンが見つからず、レガシーバージョン(ID なし)が見つかった場合、その値が使用されます(例:
6V5xX1T0n9pC42luElKD
)。 - 自動重複排除 が入力されているが、値が見つからない場合は、イベント ID が入力されている場合に使用されます。
Tealium iQ の Tags テーブルまたはタグの詳細画面でタグの UID を見つけることができます:

コネクタアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
Send Conversion V3 | ✓ | ✓ |
構成の構成
コネクタマーケットプレースにアクセスして新しいコネクタを追加します。コネクタを追加する方法については、Connector Overviewを参照してください。
コネクタを追加した後、次の構成を構成します:
- Long Lived Token: この認証方法は3-legged OAuthフローを必要とせず、有効期限がありません。詳細については、Snap: Static Long Lived Tokensを参照してください。
アクション構成 - パラメータとオプション
次へ をクリックするか、アクション タブに進みます。ここでコネクタアクションを構成します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - Send Conversion V3
パラメータ
パラメータ | 説明 |
---|---|
イベントタイプ | ドロップダウンリストからイベントタイプを選択します。 |
イベントコンバージョンタイプ | イベントが発生した場所。例えば、OFFLINE 、WEB 、または MOBILE_APP 。 |
コンバージョンデータ
パラメータ | 説明 |
---|---|
Pixel ID | 広告アカウントに関連付けられた Pixel ID。 |
App ID | 各アプリケーションに割り当てられた一意の ID。iOS ID は数値で、Android ID は Google 広告 ID (GAID ) です。 |
Snap App ID | アプリに関連付けられた Snap App ID で、広告マネージャーで生成され、MMP ダッシュボードに含まれる一意のコードです。 |
イベントタグ | カスタムイベントセットラベル。例えば、店内、週末セール、新学期キャンペーンなど。このパラメータは、将来のタグ付けやオーディエンスターゲティングに使用できます。 |
イベント時間 | このコンバージョンのエポックタイムスタンプ。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。 |
イベントソース URL | イベントソースの URL。 |
イベント ID | イベント ID。 |
データ処理オプション | WEB イベントに対してオプトインまたはオプトアウトを示します。iOS 14.5 以降のユーザーがオプトアウトする場合、このパラメータの値を LMU の単一要素のリストに構成します。それ以外の場合は、このパラメータを構成しないでください。現在受け入れられている値は:LMU 、DELETE 。 |
広告主トラッキング有効 | MOBILE_APP イベントに対してオプトインまたはオプトアウトを示します。受け入れられる値は:True でオプトイン、False でオプトアウト。 |
テストイベントコード | イベントテストコード。 |
説明 | 追加情報のための文字列説明。 |
レベル | ゲームのコンテキストにおけるレベルを表します。 |
コンテンツデータ
パラメーター | 説明 |
---|---|
コンテンツカテゴリ | アイテムのカテゴリ。 |
コンテンツ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リード広告に関連する識別子。 |
匿名ID | このパラメーターはアプリイベント専用です。ユニークなアプリケーションインストールIDを表します。 |
ダウンロードID | アプリダウンロードイベントに関連するID。 |
クリックID | ランディングページURLの &ScCid= クエリパラメーターに格納されているID値。このIDを使用すると広告測定のパフォーマンスが向上します。クリックID を使用する広告主には、イベントソースURL フィールドに完全な宛先URLを渡すことも推奨します。詳細については、Snap: クリック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) | 外部保存の空き容量(ギガバイト)。 |
デバイスタイムゾーン | デバイスのタイムゾーン。 |
自動重複排除
パラメーター | 説明 |
---|---|
自動マッピング無効 | 自動マッピングが無効になっている場合、自動マッピングされたパラメーターはデフォルトでベンダーに送信されません。 |
最終更新日 :: 2025年February月27日