ドキュメントExperience Platformタグ

Snapchat コンバージョン API拡張機能の概要

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者

Snap Conversion API拡張機能は、Edge Network APIの安全なインターフェイスであり、Web サイトでのユーザーアクションに関する情報をSnapchatと直接共有できます。 イベント転送ルールを活用して、Adobe Experience Platform Edge Network​変換API拡張機能を使用して、Snapchat​から​ Snap ​までのデータを送信できます。

Snapchat 前提条件 prerequisites

Snapchat コンバージョン APIを使用するには：

​ データストリーム ​を作成し、​ イベント転送サービス ​を追加します。

コンバージョン APIを使用するには、Snapchat Business Manager アカウントが必要です。 Business Managerは、広告主が​ Snapchat ​のマーケティング活動をビジネス全体および外部パートナーと統合するのに役立ちます。 Business Manager アカウントをお持ちでない場合は、Snapchat ​ ヘルプセンターの記事を参照してください。

[Snap Pixel]をSnapchat Ads Managerで設定し、Pixel IDを表示するためのアクセス権が必要です。 Pixel IDは、[Events Manager] セクションにあります。

静的で長期間有効なAPI トークンが必要です。 このトークンを取得するには、Snapchat Conversions API ドキュメント ​を参照してください。

Snapchat web イベント API拡張機能をインストールして設定します install

拡張機能をインストールするには、Data Collection>Event Forwarding​に移動します。 拡張機能をインストールするプロパティを選択します。

目的のプロパティを選択したら、次の手順に従います。

  1. 左側のナビゲーションパネルで、Extensions​を選択します。

  2. Snap Conversion API Extension​を検索し、Install​を選択します。

    インストールボタンを示す画像

  3. 設定画面で、次の値を入力します。

  • Pixel Id
  • API Token

終了したら「Save」を選択します。

ピクセル IDとAPI トークン ボタンを示す画像

データ要素の作成 create-data-elements

データをSnapchat Conversions API拡張機能に送信するには、各データパラメーターに​ データ要素を作成します。 次の手順に従います。

  1. プロパティの​ Authoring ​画面で​Data Elements>Property Info​に移動し、Add Data Element​を選択します。

    データ要素を追加ボタンを示す画像

  2. データ要素の名前を入力します。

  3. 拡張機能として​Core、データ要素タイプとして​ Path ​を選択します。

  4. ドロップダウンメニューから適切な項目を選択し、右側のパネルのPath フィールドに入力して、スキーマ内の目的のデータを参照します。

    データ要素の作成画面を示す画像

例えば、以下に示すスキーマでsnapClickIdを参照するデータ要素を作成する場合は、

スキーマを示す画像

snapClickIdがXDM スキーマの_snap.inc.exchangeの下にあるので、データ要素を設定する必要があります。

データ要素の編集画面を表示する画像

データ要素の作成について詳しくは、​ イベント転送プロパティのドキュメント ​を参照してください。

コンバージョンイベントをSnapに送信するルールの作成 create-snap-rules

​ ルール ​は、Experience Platformで拡張機能をトリガーするために使用されます。 この節では、イベント転送プロパティ内でルールを作成し、Conversions API拡張機能を使用してコンバージョンイベントをSnapに送信する方法について説明します。

新しいルールの作成

  1. イベント転送プロパティに移動し、オーサリングメニューから「Rules」を選択します。 次に、Create New Rule​をクリックします。

    左側のナビゲーションにルールを表示する画像

  2. ルールに名前を付け、スナップイベントをトリガーするための条件を設定します。 例えば、イベントに注文番号が含まれている場合にPURCHASE イベントを送信するには、ユーザーのインタラクションに有効な注文番号が含まれているかどうかを確認する条件を設定します。

    条件設定画面を示す画像

  3. 条件を保存した後、Snap Conversion APIをトリガーするアクションを追加します。 左側のパネルで、次の操作を行います。

    • Extension ドロップダウンメニューをSnap Conversions API Extensionに設定します。

    • Action Type ドロップダウンメニューをReport Web Conversionsに設定します。

    • ルールに適切な名前を付けます。

    アクション設定画面を示す画像

  4. 右側のパネルの​ セクションで、イベント用に送信するCAPI パラメーター値​ Data Bindings ​を設定します。 拡張機能のフィールドは、次に示すようにCAPI パラメーターにマッピングされます。 各パラメーターについて詳しくは、Snapchat コンバージョン API ドキュメント ​を参照してください。

データバインディングフィールド
CAPI パラメーターをスナップ
イベントタイプ（必須）
event_name
メール
em
電話番号
ph
ユーザーエージェント
client_user_agent
IP アドレス
client_ip_address
クリック ID
sc_click_id
Cookie1
so_cookie1
名
fn
姓
ln
性別
ge
市区町村
ph
都道府県
st
郵便番号
zp
国
country
外部 ID
external_id
パートナーId
partner_id
購読 ID
subscription_id
リード ID
lead_id
項目またはカテゴリ
content_category
コンテンツ名
content_ids
コンテンツタイプ
content_name
目次
contents
説明
description
イベントタグ
event_tag
項目数
num_items
価格
value
通貨
currency
トランザクション ID
order_id （event_idの代わりにclient dedup idDにも送信されます）
予測LTV
predicted_ltv
検索文字列
search_string
サインアップ方法
sign_up_method
クライアント重複排除ID
event_id
データ利用の制限
data_processing_options
ページ Url
event_source_url

必須フィールドと任意フィールド

各イベントにはevent_sourceが必要です。これは常にWEB.に設定されます。一致させるには、次のフィールドまたは組み合わせのうち少なくとも1つが必要です。

  • 電子メール
  • 電話番号
  • IP アドレスとユーザーエージェント

その他のメモ：

  • Purchase イベントの場合、CurrencyおよびPrice フィールドが必要です。

  • Test Mode チェックボックスを有効にすると、イベントがテストイベントとして送信され、標準レポートではなくテストイベントツールに表示されます。 詳しくは、​ ビジネスヘルプセンターの記事を参照してください。

  • contents パラメーターは、次のいずれかのフィールドを含むJSON文字列である必要があります。

    • id
    • item_category
    • brand
    • delivery_category
    • item_price
    • quantity

例：

{
  "id": "id1",
  "brand": "brand1",
  "delivery_category": "c1",
  "item_price": 2.00,
  "quantity": 2
}

​ カスタムコンバージョン値とROAS レポート ​を使用するには、contents フィールドに関連するパラメーターを含めます。 購入イベントの設定の例：brand、item_price、idなど

Purchase イベントの設定例：

データバインディングを示す画像

オプションのフィールドは、次のように設定できます。

オプションのフィールドを表示する画像

前述のようにルールの名前、条件、アクションを設定したら、ルールを保存し、ルールが有効になっていることを確認します。

有効なルールを示す画像

これらの変更をプロパティに公開できるようになりました。 詳しくは、公開フローのドキュメントを参照してください。

トラブルシューティング troubleshoot

トラブルシューティングと設定の最適化については、​ イベント品質スコアの推奨事項を確認して、イベントが可能な限り高い一致率とパフォーマンス成果を達成することを確認してください。

イベント品質スコア​で問題が発生した場合は、改善するための推奨事項について詳しく説明しますこちら。

次の手順 next-steps

このガイドでは、Snap​拡張機能を使用してサーバーサイドのイベントデータを​ Snap Conversions API ​に送信する方法について説明しました。 Experience Platformのイベント転送機能について詳しくは、​ イベント転送の概要を参照してください。

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743