Snapchat Conversions コネクタ構成ガイド

仕組み

Snapchat Conversions コネクタは、Snap Conversions API を使用します。Snap Conversions API は、Server-to-Server（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を使用します。

バッチ処理の上限

このコネクタでは、ベンダーへの大量データ転送をサポートするために、リクエストをバッチ処理します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。

リクエストの最大数：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：ベストプラクティス - 重複排除を参照してください。

自動重複排除

バージョン 3 では、コネクタは重複排除に Client Dedup ID ではなく Event ID を使用します。

自動重複排除の値に Tag Management タグの UID が入力されている場合、コネクタは対応するイベント属性を検索します。このセクションに値が入力されており、Tag Management を使用している場合は、イベント ID を追加する必要はありません。ただし、Tag Management を使用せずに Event Streaming を使用する場合は、次の方法が引き続き必要になることがあります。

コネクタの処理順序は次のとおりです。

自動重複排除に値が入力され、その値がデータレイヤーで検出された場合（例：6V5xX1T0n9pC42luElKD）、その値が イベント ID にマッピングされた値よりも優先されます。
自動重複排除に値が入力されているものの、タグ ID バージョンが見つからず、従来のバージョン（ID がエンリッチメントされていないもの）が見つかった場合は、その値が使用されます（例：6V5xX1T0n9pC42luElKD）。
自動重複排除に値が入力されているものの、その値が見つからない場合は、イベント ID にマッピングされた値が入力されていれば、その値が使用されます。

タグの UID は、Tag Management のタグテーブルまたはタグの詳細画面で確認できます。

コネクタアクション

アクション名	訪問プロファイル	イベントデータ
コンバージョン V3 を送信	✓	✓

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加したら、次の構成を行います。

長期有効トークン：この認証方式では、3-legged OAuth フローは不要で、有効期限もありません。詳細については、Snap：Static Long Lived Tokensを参照してください。

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

続行をクリックして、コネクタアクションを構成します。アクションの名前を入力し、リストからアクションタイプを選択します。

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

パラメータ

パラメータ	説明
イベントタイプ	ドロップダウンリストからイベントタイプを選択します。
イベントコンバージョンタイプ	イベントが発生した場所。例：`OFFLINE`、`WEB`、`MOBILE_APP`。

コンバージョンデータ

パラメータ	説明
Pixel ID	広告アカウントに関連付けられている 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	このコンバージョンの Epoch タイムスタンプ。このフィールドがマッピングされていない場合は、現在のタイムスタンプで初期化されます。このパラメータは自動マッピングされます。自動マッピングを上書きするには、属性をマッピングするか、自動マッピングを無効にします。
Event Source URL	イベントソースの URL。
Event ID	イベント ID。
Data Processing Options	`WEB`イベントに対するオプトインまたはオプトアウトを示します。iOS 14.5 以降のユーザーがオプトアウトする場合は、このパラメータの値を、値`LMU`のみを要素として持つリストに構成します。それ以外の場合は、このパラメータを構成しないでください。指定可能な値：`LMU`、`DELETE`。
Advertiser Tracking Enabled	`MOBILE_APP`イベントに対するオプトインまたはオプトアウトを示します。指定可能な値は、オプトインの場合は`True`、オプトアウトの場合は`False`です。
Description	追加情報を表す文字列の説明。
Level	ゲーム内のレベルを表します。
Tealium Collect Endpoint	Tealium Collect エンドポイントの URL。

コンテンツデータ

パラメータ	説明
コンテンツカテゴリー	アイテムのカテゴリー。
コンテンツID	コンテンツID。
コンテンツ名	イベントに関連付けられたページまたは商品の名前。
コンテンツタイプ	`content_type` フィールドは、`content_ids` または `contents` のキーが何を表すかを示します。個々のアイテムには `product` を、サイズ、色、その他のバリエーションで複数の選択肢があるアイテムには `product_group` を選択します。
通貨	標準のISO 4217コード（例：`EUR`、`USD`、`JPY`）。
アイテム数	アイテム数（整数、単一値）。このフィールドが配列にマッピングされている場合、配列要素の合計に変換されます。
注文ID	購入された注文のID。
予測顧客生涯価値	コンバージョンイベントの予測顧客生涯価値。
値	特定のイベントに関連付けられた購入金額。`PURCHASE` イベントでは必須です。
検索文字列	検索されたテキスト。
登録方法	Facebook、メール、Xなど、登録方法を示す文字列。
ブランド	コンバージョンイベントの `item_ids` に関連付けられたブランド。

コンテンツ情報

パラメータ	説明
ID	アイテムID。
数量	アイテムの数量。
アイテム価格	アイテムの価格。
配送カテゴリー	注文に使用された配送方法。
ブランド	アイテムのブランド。

ユーザー情報

パラメータ	説明
メールアドレス（SHA256ハッシュを適用）	小文字のプレーンテキスト形式のメールアドレスを指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。空またはnullのハッシュ値は無視されます。
メールアドレス（SHA256でハッシュ化済み）	SHA256でハッシュ化されたメールアドレスを指定します。
電話番号（SHA256ハッシュを適用）	小文字のプレーンテキスト形式の電話番号を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。空またはnullのハッシュ値は無視されます。
電話番号（SHA256でハッシュ化済み）	SHA256でハッシュ化された電話番号を指定します。
モバイル広告ID	モバイル広告ID。
IPアドレス	デバイスのIPアドレス。
ベンダー識別子	プレーンテキスト形式のベンダー識別子を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
名（SHA256ハッシュを適用）	小文字の名を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
名（SHA256でハッシュ化済み）	SHA256でハッシュ化された名の値を指定します。
姓（SHA256ハッシュを適用）	小文字の姓を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
姓（SHA256でハッシュ化済み）	SHA256でハッシュ化された姓の値を指定します。
性別（SHA256ハッシュを適用）	性別（女性は `f`、男性は `m`）を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
性別（SHA256でハッシュ化済み）	SHA256でハッシュ化された性別の値を指定します。
市区町村（SHA256ハッシュを適用）	コンバージョンに関連付けられた市区町村を小文字で指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
市区町村（SHA256でハッシュ化済み）	SHA256でハッシュ化された市区町村の値を指定します。
州（SHA256ハッシュを適用）	コンバージョンに関連付けられた州を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
州（SHA256でハッシュ化済み）	SHA256でハッシュ化された州の値を指定します。
郵便番号（SHA256ハッシュを適用）	郵便番号を小文字で指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
郵便番号（SHA256でハッシュ化済み）	SHA256でハッシュ化された郵便番号を指定します。
国（SHA256ハッシュを適用）	イベントに関連付けられた国を指定すると、コネクターがSnapchatで求められる形式でこの値をハッシュ化します。
国（SHA256でハッシュ化済み）	SHA256でハッシュ化された国の値を指定します。
外部ID	ロイヤルティカードIDなどの一意のIDまたはその他の識別子。
サブスクリプションID	このイベントを生成したユーザーのサブスクリプションID。
リードID	Snapchatリード広告に関連付けられた識別子。
匿名ID	このパラメータはアプリイベント専用です。一意のアプリケーションインストールIDを表します。
ダウンロードID	アプリのダウンロードイベントに関連付けられたID。
クリックID	ランディングページURLの `ScCid` クエリ文字列パラメータの値。このIDを使用すると、広告効果測定のパフォーマンスが向上します。クリックIDを使用する広告主には、完全なリンク先URLをイベントソースURLに渡すことを推奨します。詳細については、Snap：クリックIDの送信を参照してください。このパラメータは自動的にマッピングされます。自動マッピングを上書きするには、属性をマッピングするか、自動マッピングを無効にします。
Cookie1	Pixel SDKを使用している場合、ドメイン内の `_scid` 値を参照することでファーストパーティCookieにアクセスできます。このパラメータは自動的にマッピングされます。自動マッピングを上書きするには、属性をマッピングするか、自動マッピングを無効にします。
クライアントユーザーエージェント	ユーザーのWebブラウザーのユーザーエージェント文字列。このパラメータは自動的にマッピングされます。自動マッピングを上書きするには、属性をマッピングするか、自動マッピングを無効にします。

動的旅行広告

パラメータ	説明
チェックイン日	ホテルのタイムゾーンに基づくチェックイン日。使用できる形式は、`YYYYMMDD`、`YYYY-MM-DD`、`YYYY-MM-DDThh:mmTZD`、および `YYYY-MM-DDThh:mm:ssTZD` です。
旅行終了日	旅行の終了日。
旅行開始日	旅行の開始日。
おすすめの目的地	おすすめの目的地。
目的地の空港	目的地の空港のIATAコード。
国	ユーザーが訪問しようとしている場所に基づく国。
市区町村	ユーザーが訪問しようとしている場所に基づく市区町村。
地域	ユーザーが関心を持っている州、地区、または地域。
地区	ユーザーが関心を持っている地区。
往路出発日時	旅行を開始する日時。
往路到着日時	旅行先への到着日時。
大人の人数	宿泊する大人の人数。
空港コード	出発空港の正式なIATAコード。
復路出発日時	復路の出発日時。
復路到着日時	復路が完了する日時。
子供の人数	宿泊する子供の人数。
ホテルスコア	広告主にとっての他のホテルとの相対的なホテルスコア。
郵便番号	郵便番号。
乳児の人数	宿泊する乳児の人数。
希望する地区	宿泊先として希望する地区。
希望する星評価	タプルとして指定されるホテルの星評価の最小値と最大値。例：`star1,star2` または `["star1", "star2"]`。
おすすめのホテル	おすすめのホテル。
目的地ID	カタログ内の目的地を表すID。

拡張デバイス情報

パラメータ	説明
バージョン	（必須）バージョン。
OSバージョン	（必須）OSのバージョン。
アプリパッケージ名	アプリのパッケージ名。
短縮バージョン	アプリケーションの短縮バージョン。例：`1`。
完全バージョン	アプリケーションの完全バージョン。例：`1.0.12.1`。
デバイスモデル名	デバイスのモデル名。
ロケール	デバイスのロケール。デフォルト値は `en-US` です。カスタムロケールを使用するには、`xx-YY` 形式（2文字の言語コード、ハイフン、2文字の国コード）で値を入力します。
タイムゾーンの略称	タイムゾーンの略称。
通信事業者	通信事業者。
画面幅	画面の幅。
画面高さ	画面の高さ。
画面密度	画面密度。
CPUコア数	CPUコアの数。
外部保存容量（GB）	外部保存の容量（ギガバイト単位）。
外部保存の空き容量（GB）	外部保存の空き容量（ギガバイト単位）。
デバイスのタイムゾーン	デバイスのタイムゾーン。

自動重複排除

パラメータ	説明
自動重複排除	Tealium iQタグIDが指定されている場合、タグ管理から送信されたイベントIDの値を自動的に検索します。

自動マッピングの無効化

パラメータ	説明
自動マッピングの無効化	自動マッピングが無効になっている場合、自動マッピングされたパラメータはデフォルトではベンダーに送信されません。

構成

パラメータ	説明
長期有効トークン	Snap 長期有効トークン（`LLT`）をマッピングすると、構成で指定された `LLT` が上書きされます。