OpenAI Ads（ChatGPT）のアトリビューションと CAPI

フォローする
Avatar
Samar Perka
Updated
ChatGPT Ads の設定
アトリビューションと Conversions API
トラッキングリンクとポストバックの設定

この記事では、モバイルアプリキャンペーン、PC/コンソールのインストール、Web キャンペーンを対象に、Singular のアトリビューションと Conversions API を使用して OpenAI Ads（ChatGPT）キャンペーンを設定する方法を説明します。

概要

Singular の Web-to-App アトリビューションソリューションにより、マーケティング担当者はモバイル、PC、コンソールの各プラットフォームでアプリインストールを促進する Web キャンペーンを実施できます。Singular の OpenAI Ads Web-to-App 連携は、次のガイドで説明している Direct to Store フローに対応しています: Web-to-App ガイドはこちら 。

Singular で ChatGPT のパートナー設定を追加する

Singular で ChatGPT Ads のパートナー設定を追加する

  1. 次に移動します: Singular > Attribution > Partner Configuration
  2. 「 Add a Partner 」をクリックし、次を入力して選択します:「 OpenAI Ads (ChatGPT) 」
  3. ダイアログで、設定するアプリとアプリ/ウェブサイト（プラットフォーム）を選択します。この連携はモバイル、Web、PC、コンソールのアプリに対応しています
  4. アプリの「 Pixel ID 」と「 Conversions API Key 」を次からコピーして貼り付けます: OpenAI Ads Manager 。
    Pixel ID と Conversions API Key の項目が入力された Singular の OpenAI Ads（ChatGPT）パートナー設定
  5. 必要に応じて、OpenAI に送信する追加イベントを設定し、「OpenAI Event Name」にマッピングします
    収益イベントとアプリ内イベントを OpenAI のイベント名にマッピングし、Send All と Include Revenue を有効にした Singular のポストバック設定
  6. 「 Save 」をクリックして完了します。
「OpenAI Ads (ChatGPT)」に必要なイベント属性

「OpenAI Ads (ChatGPT)」連携に必要なイベント属性

OpenAI Ads（ChatGPT）連携を有効にするには、次のイベント属性を実装して送信してください。大文字と小文字が区別されます。

モバイル

次のイベント属性を送信します:

  • ehash : ユーザーのメールアドレスから前後の空白を削除し、小文字に変換したうえで SHA-256 でハッシュ化した値です。
  • external_id_hash （任意）: お客様のシステムで使用している安定した仮名の顧客識別子を SHA-256 でハッシュ化した値です。
    • 可能であれば、マッチング精度を高めるために ehash と external_id_hash の両方を送信してください。 ehash が利用できない場合は、少なくとも external_id_hash を送信してください。

Web

次のイベント属性を送信します:

  • page_url （必須）: イベントが発生したページの完全な URL です（例: https://shop.example.com/checkout/confirmation ）。
  • ehash : ユーザーのメールアドレスから前後の空白を削除し、小文字に変換したうえで SHA-256 でハッシュ化した値です。
  • external_id_hash （任意）: お客様のシステムで使用している安定した仮名の顧客識別子を SHA-256 でハッシュ化した値です。
    • page_url は必須です。ユーザー関連のフィールドについては、可能であればマッチング精度を高めるために ehash と external_id_hash の両方を送信してください。 ehash が利用できない場合は、少なくとも external_id_hash を送信してください。
「ChatGPT Ads」用の Singular リンクを作成する

「ChatGPT Ads」用の Singular リンクを作成する

  1. 次に移動します: Singular > Attribution > Manage Links
  2. 左側のアプリ一覧からモバイルアプリを選択します
  3. 次を選択します: "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
  4. ステップごとのリンク作成手順に沿って進めます。
  5. 次をクリックします: "Generate"
  6. 次のステップで使用するため、 "Click-through Tracking Link" をコピーします
OpenAI Ads（ChatGPT Ads）キャンペーンを設定する

OpenAI Ads（ChatGPT Ads）キャンペーンを設定する

  1. OpenAI Ads Manager でキャンペーンを作成し、Ad Group のステップに進みます。
  2. 上記で作成した Singular リンクを「Default Ad Destination URL」に入力します:
    Default Ad Destination URL に Singular の sng.link トラッキングリンクを入力した OpenAI Ads の新規キャンペーンの広告グループ設定

よくある質問

Singular は ChatGPT のアトリビューションをどのようにレポートしますか?

アトリビューションが計測されると、ChatGPT のアトリビューションは次のようにレポートされます:

  • Source = "ChatGPT"
  • Tracker Source Name = "ChatGPT"
Pixel ID はどこで確認できますか?
  1. 次のページに移動します: OpenAI Conversions ページ。
  2. 「 Create 」を選択し、「Data Source」を選択します: OpenAI Ads Manager の Conversions ページ。Create new data source ダイアログで Web データソースに Singular Pixel と名前を付けている
  3. 完了したら、新しい Pixel ID をコピーします:
    名前の下に Pixel ID が表示された OpenAI Ads Manager の Singular Pixel データソース一覧
Conversions API Key はどこで確認できますか?
  1. 次のページに移動します: OpenAI Conversions ページ。
  2. 「 Conversion keys 」を選択し、「Create new key」を選択します:
    名前に Singular Conversions API Key を入力した OpenAI Ads Manager の Create New Conversion Key ダイアログ
  3. 新しいキーを Singular の Partner Configuration にコピーします:
    生成されたキーと Copy、Download ボタンが表示された OpenAI Ads Manager の Save your key ダイアログ
Singular は API を介してどのようなデータを送信しますか?
パラメータ 詳細
event_name
  • 標準イベントまたはカスタムイベントの名前です。このフィールドは Singular Event Name に自動的にマッピングされます。この値は OpenAI がイベントを重複排除する際に使用されます。event_id パラメータも重複排除に使用されます。
ハッシュ化されたメールアドレス
  • 任意
  • ハッシュ化されたメールアドレスは、Singular で計測するイベント属性「ehash」として渡すことができます
  • ハッシュ化されたメールアドレスの値は、正規化したうえで SHA-256 でハッシュ化する必要があります
ハッシュ化された外部ユーザー ID
  • 任意
  • ハッシュ化された外部 ID は、Singular で計測するイベント属性「external_id_hash」として渡すことができます
IP アドレス
  • クライアントの IP アドレス
ユーザーエージェント
  • クライアントの User-Agent
イベントの重複排除用（任意）
event_id
  • 重複排除に必要なパラメータ
  • event_id の値は、次の属性名を使用して Event Arguments で Singular に渡してください:「 eventId 」。
  • event_id パラメータは、 Conversions API と OpenAI Pixel の両方 からイベントに追加する必要があります。
  • event_id パラメータは、類似したイベントを一意に区別できる識別子です。