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 を使用してください。詳細は下記のWeb とモバイルアプリで別々の Pixel ID が必要ですか?を参照してください。
   
   
5. 必要に応じて、OpenAI に送信する追加イベントを設定し、「OpenAI Event Name」にマッピングします
   
   
6. 「 Save 」をクリックして完了します。

「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 リンクを作成する

1. 次に移動します: Singular > Attribution > Manage Links
2. 左側のアプリ一覧からモバイルアプリを選択します
3. 次を選択します: "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
4. ステップごとのリンク作成手順に沿って進めます。
5. リダイレクト先を設定します。 アプリがインストールされていないユーザーの遷移先です。デフォルトはアプリのストア URL です。そのユーザーを自社サイトに遷移させる場合は、Web URL オプションを選択し、遷移先を入力します。サイト上でコンバージョンが発生する Web キャンペーンでは、このオプションを使用します。
6. (任意) 追加のパラメーターやマクロが必要な場合は、Additional Parametersセクションで追加します。生成後のリンクを直接編集せず、ここで追加してください。
7. 次をクリックします: "Generate"
8. 次のステップで使用するため、 "Click-through Tracking Link" をコピーします

生成されたリンクには、キャンペーンパラメーターと OpenAI Ads の動的マクロがすでに含まれています。すべてのパラメーターはリダイレクト先に転送され、Singular Web SDK がそれを読み取って Web コンバージョンをアトリビューションします。生成されたリンクは次のような形式です:

https://yourapp.sng.link/XXXXX/YYYY?_dl=yourapp%3A%2F%2Fmy_default_deeplink&_smtype=3&wpcl={oppref}&wpscid={ad_group_id}&pcid={campaign_id}&_forward_params=1&pscid={ad_group_id}&pcrid={ad_id}&wpcrid={ad_id}&cl={oppref}&wpsrc=ChatGPT%20Web%20CAPI&wpcid={campaign_id}

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

1. OpenAI Ads Manager でキャンペーンを作成し、Ad Group のステップに進みます。
2. 上記で作成した Singular リンクを「Default Ad Destination URL」に入力します:
   
3. リンク内のマクロはそのままにしてください。OpenAI Ads がクリック時に {campaign_id}、{ad_group_id}、{ad_id}、{oppref} を置き換えるため、手動での置換なしにキャンペーンの内訳が Singular に届きます。

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

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

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

いいえ。OpenAI Pixel ID は、プラットフォームごとではなく、広告主・ブランド・連携パートナーの送信先ごとに 1 つ使用します。Singular では、Web、iOS、Android の測定に同じ Pixel ID と Conversions API Key を使用します。

Singular は各イベントにプラットフォームを自動的に設定します。Web イベントには action_source: "web"、iOS および Android イベントには action_source: "mobile_app" が設定されます。このための設定作業はありません。

OpenAI は現在ネイティブモバイルのデータソースに対応していないため、アプリ種別のデータソースを作成することはできません。Web のデータソースを作成し、その Pixel ID を測定対象のすべてのプラットフォームで使用してください。

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

各キャンペーンのディメンションは 2 回ずつ含まれます。アプリ側のパラメーターはアプリインストールをアトリビューションし、Web 側のパラメーターは Singular Web SDK が Web サイト上で発生したコンバージョンをアトリビューションする際に読み取る値です。1 本のリンクで両方の成果に対応します。

リンクには次の制御パラメーターも含まれます:

• wpsrc=ChatGPT%20Web%20CAPI は Singular Web アトリビューションの Source を指定し、OpenAI Ads のポストバックが送信されるために必須です。変更しないでください。
• _forward_params=1 は、リンクのパラメーターをストアおよび Web のリダイレクト先に転送します。
• _dl には、アプリがインストールされている場合にリンクが開くディープリンクの遷移先が入ります。
• _smtype=3 は、トラッキングリンクで確率的アトリビューションが有効な場合に付与されます。そのリンクで確率的アトリビューションを無効にしている場合、このパラメーターは追加されません。

トラッキングリンクが取得するのは、キャンペーン・広告グループ・広告の ID であり、名称は取得しません。Singular は OpenAI Ads Data Connector から名称を取得し、リンクで取得した ID と照合するため、レポートではクリックやインストールに対して読みやすい名称が表示されます。

そのため、名称はリンクには含まれません。ID は安定した結合キーであるため、キャンペーン名を変更しても過去のクリックに対して正しくレポートされます。