Snapchat コンバージョンコネクタ構成ガイド

仕組み

Snapchat コンバージョンコネクタは Snap Conversions API を使用します。Snap Conversions API は、構造化されたプライバシー重視のインターフェースで、サーバーからサーバーへの（S2S）統合を通じてウェブ、アプリ、オフラインイベントを Snap に直接送信することができます。この API は、Snap Pixel によって提供されるトラッキングと同様のイベントトラッキングをサポートし、コンバージョンを行ったデバイスタイプを使用します。この機能により、モバイルコンバージョンには Snap App ID を、ウェブおよびオフラインのコンバージョンイベントには 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 広告アカウントにリンクする一意の識別子に関連付けられています。ウェブおよびオフラインイベントには Pixel ID を、アプリイベントには Snapchat App ID を使用します。

バッチ制限

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

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

重複排除

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

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

Snap App ID、Pixel ID、またはその両方が複数のソース（API、SDK など）を持っている場合
イベントが同じコンバージョンタイプ（ウェブ、アプリ、またはオフライン）に関連している場合
選択されたイベントが2つ以上のソースに追加されている場合

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

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

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

イベント ID - ウェブおよびオフラインチャネルのユニークなイベントを重複排除します。48時間の重複排除ウィンドウが許可されます。
トランザクション ID - すべてのチャネル（ウェブ、モバイル、オフライン）の購入イベントを重複排除するために適格です。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を参照してください。

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

Next をクリックするか、Actions タブに進みます。ここでコネクタアクションを構成します。

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

アクション - Send Conversion 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	このコンバージョンのエポックタイムスタンプ。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。このパラメータは自動マッピングされます。自動マッピングをオーバーライドするには、属性をマップするか、自動マッピングを無効にします。
Event Source URL	イベントソースの URL。
Event ID	イベント ID。
Data Processing Options	`WEB` イベントのオプトインまたはオプトアウトを示します。iOS 14.5 以降のユーザーがオプトアウトする場合、このパラメータの値を `LMU` の値が1つのリストに構成します。それ以外の場合は、このパラメータを構成しないでください。受け入れられる値は：`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、Email、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` 値を見ることで、ファーストパーティクッキーにアクセスできます。このパラメータは自動マッピングされます。自動マッピングをオーバーライドするには、属性をマップするか自動マッピングを無効にします。
クライアントユーザーエージェント	ユーザーのウェブブラウザのユーザーエージェント文字列。このパラメータは自動マッピングされます。自動マッピングをオーバーライドするには、属性をマップするか自動マッピングを無効にします。

ダイナミックトラベル広告

パラメータ	説明
チェックイン日	ホテルのチェックイン日（ホテルのタイムゾーン）。受け入れられる形式は `YYYYMMDD`、`YYYY-MM-DD`、`YYYY-MM-DDThh:mmTZD`、`YYYY-MM-DDThh:mm:ssTZD` です。
旅行終了日	旅行の終了日。
旅行開始日	旅行の開始日。
提案された目的地	提案された目的地。
目的地空港	目的地空港のIATAコード。
国	ユーザーが訪れる予定の場所に基づいた国。
市	ユーザーが訪れる予定の場所に基づいた市。
地域	ユーザーが興味を持っている州、地区、または地域。
近隣地区	ユーザーが興味を持っている近隣地区。
出発出発日	旅行の開始日時。
出発到着日	旅行の目的地での到着日時。
大人数	宿泊する大人の数。
空港コード	出発空港の公式IATAコード。
帰国出発日	帰国旅行の開始日時。
帰国到着日	帰国旅行が完了する日時。
子供の数	宿泊する子供の数。
ホテルスコア	広告主に対する他のホテルとの相対的なホテルのスコア。
郵便番号	郵便番号またはZIPコード。
幼児の数	宿泊する幼児の数。
好ましい近隣地区	宿泊に好ましい近隣地区。
好ましい星評価	最小および最大のホテル星評価をタプルとして提供します。例えば、`star1,star2` または `["star1", "star2"]`。
提案されたホテル	提案されたホテル。
目的地ID	カタログ内の目的地を代表するID。

拡張デバイス情報

パラメータ	説明
バージョン	（必須）バージョン。
OSバージョン	（必須）OSバージョン。
アプリパッケージ名	アプリのパッケージ名。
短いバージョン	アプリケーションの短いバージョン。例えば、`1`。
長いバージョン	アプリケーションの長いバージョン。例えば、`1.0.12.1`。
デバイスモデル名	デバイスのモデル名。
ロケール	ロケール。
タイムゾーン略称	タイムゾーンの略称。
キャリア	キャリア。
画面幅	画面の幅。
画面高さ	画面の高さ。
画面密度	画面の密度。
CPUコア数	CPUコアの数。
外部保存サイズ（GB）	外部保存のサイズ（ギガバイト）。
外部保存の空き容量（GB）	外部保存の空き容量（ギガバイト）。
デバイスタイムゾーン	デバイスのタイムゾーン。

自動重複排除

パラメータ	説明
自動重複排除	Tealium iQタグIDが提供された場合、イベントID値を自動的に検索します。

自動マッピングの無効化

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

構成

パラメータ	説明
長期トークン	Snap 長期トークン (`LLT`) のマッピングは、構成で提供された `LLT` を上書きします。