---
title: Snapchat コンバージョンコネクタ構成ガイド
description: この記事では、Snapchat コンバージョンコネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/snapchat-conversions-connector/
---
## 動作原理

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](https://businesshelp.snapchat.com/s/article/conversions-api?language=en_US)を参照してください。

## API 情報

このコネクタは以下のベンダー API を使用します：

* API 名称: Snapchat Marketing API - Conversion API
* API バージョン: v3
* API エンドポイント: `https://tr.snapchat.com/v3/conversion`

## 考慮事項

* キャンペーンの最適化を実現するために、イベントが発生したらできるだけ早く、理想的にはイベント発生後1時間以内にイベントを送信することをお勧めします。
* リアルタイムでデータを送信することを強く推奨します。これにより、キャンペーンによる結果をより早く確認でき、現在の市場需要に対抗して入札を競争力のあるものに保つことができます。
* Conversions API のリクエストは、サーバーイベントを Snapchat 広告アカウントにリンクする一意の識別子に関連付けられています。ウェブおよびオフラインイベントには [Pixel ID](https://businesshelp.snapchat.com/s/article/pixel-website-install?language=en_US) を、アプリイベントには [Snapchat App ID](https://businesshelp.snapchat.com/s/article/snap-app-id?language=en_US) を使用します。

## バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、[Batched Actions](https://docs.tealium.com/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](https://developers.snap.com/api/marketing-api/Conversions-API/BestPractices#deduplication)を参照してください。

#### 自動重複排除


<blockquote>
バージョン3では、コネクタは **クライアント重複排除 ID** の代わりに **イベント ID** を使用して重複排除を行います。
</blockquote>


**自動重複排除** の値が Tealium iQ タグ UID で入力されている場合、コネクタは対応するイベント属性を検索します。このセクションが入力されており、Tealium iQ を使用している場合、**イベント ID** を追加する必要はありません。ただし、Tealium iQ なしで EventStream を使用する場合は、次のアプローチが必要になる場合があります。

操作の順序は次のとおりです：

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

Tealium iQ の **タグ** テーブルまたはタグの詳細画面でタグの UID を見つけることができます：

![](https://docs.tealium.com/images/server-side-connectors/snap-pixel-uid.png)

## コネクタアクション

| **アクション名** | **AudienceStream** | **EventStream** |
|:----------------|:-------------------|:----------------|
| Send Conversion V3 | ✓                  | ✓               |

## 構成の構成

コネクタマーケットプレースにアクセスして新しいコネクタを追加します。コネクタを追加する一般的な手順については、[Connector Overview](https://docs.tealium.com/about-connectors/)を参照してください。

コネクタを追加した後、次の構成を構成します：

* **Long Lived Token**: この認証方法は3-legged OAuthフローを必要とせず、有効期限がありません。詳細については、[Snap: Static Long Lived Tokens](https://marketingapi.snapchat.com/docs/conversion.html#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 で、Ads Manager で生成され、MMP ダッシュボードに含まれるユニークなコードです。 |
| Event Tag | カスタムイベントセットラベル。例えば、店内、週末セール、新学期キャンペーンなど。このパラメータは、将来のタグ付けやオーディエンスターゲティングに使用できます。 |
| Event Time | このコンバージョンのエポックタイムスタンプ。このフィールドがマッピングされていない場合、現在のタイムスタンプで初期化されます。このパラメータは自動マッピングされます。自動マッピングをオーバーライドするには、属性をマッピングするか、自動マッピングを無効にします。|
| 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、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の送信](https://developers.snap.com/api/marketing-api/Conversions-API/UsingTheAPI#sending-click-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`。 |
| デバイスモデル名 | デバイスのモデル名。 |
| ロケール | デバイスのロケール。デフォルト値は `en-US` です。カスタムロケールを使用する場合は、`xx-YY` 形式の値を入力してください（2文字の言語コード、ダッシュ、2文字の国コード）。 |
| タイムゾーン略称 | タイムゾーンの略称。 |
| キャリア | キャリア。 |
| 画面幅 | 画面の幅。 |
| 画面高さ | 画面の高さ。 |
| 画面密度 | 画面の密度。 |
| CPUコア数 | CPUコアの数。 |
| 外部保存サイズ（GB） | 外部保存のサイズ（ギガバイト）。 |
| 外部保存の空き容量（GB） | 外部保存の空き容量（ギガバイト）。 |
| デバイスタイムゾーン | デバイスのタイムゾーン。 |

#### 自動重複排除

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

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

#### 構成

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