ChatGPT Ads の設定

アトリビューションと Conversions API
トラッキングリンクとポストバックの設定

Data Connector（コスト集計）
Data Connector の設定

この記事では、モバイルアプリキャンペーン、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 のパートナー設定を追加する

次に移動します: Singular > Attribution > Partner Configuration
「 Add a Partner 」をクリックし、次を入力して選択します:「 OpenAI Ads (ChatGPT) 」
ダイアログで、設定するアプリとアプリ/ウェブサイト（プラットフォーム）を選択します。この連携はモバイル、Web、PC、コンソールのアプリに対応しています
アプリの「 Pixel ID 」と「 Conversions API Key 」を次からコピーして貼り付けます: OpenAI Ads Manager 。
必要に応じて、OpenAI に送信する追加イベントを設定し、「OpenAI Event Name」にマッピングします
「 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 リンクを作成する

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

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

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

OpenAI Ads Manager でキャンペーンを作成し、Ad Group のステップに進みます。
上記で作成した Singular リンクを「Default Ad Destination URL」に入力します:

よくある質問

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

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

Source = "ChatGPT"
Tracker Source Name = "ChatGPT"

Pixel ID はどこで確認できますか?

次のページに移動します: OpenAI Conversions ページ。
「 Create 」を選択し、「Data Source」を選択します:
完了したら、新しい Pixel ID をコピーします:

Conversions API Key はどこで確認できますか?

次のページに移動します: OpenAI Conversions ページ。
「 Conversion keys 」を選択し、「Create new key」を選択します:
新しいキーを Singular の Partner Configuration にコピーします:

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 パラメータは、類似したイベントを一意に区別できる識別子です。

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

概要