どのようにお手伝いできますか?

ChatGPT Ads(OpenAI) | 連携設定

  • 更新

概要:ChatGPT AdsはOpenAIの広告プラットフォームであり、AppsFlyerの連携済みパートナーです。連携を設定すると、ChatGPT Adsキャンペーンによるモバイルアプリのインストール、アプリ内イベント、Webサイトのコンバージョンを計測し、アトリビューションを行えます。

ChatGPT Adsとの連携について

AppsFlyerとChatGPT Ads(OpenAI)を連携すると、ChatGPT Adsキャンペーンによるアプリのインストール、アプリ内イベント、Webサイトのコンバージョンを計測し、アトリビューションを行えます。モバイルアプリとWebサイトの両方の計測に対応しています。

  • モバイルアプリ:AppsFlyerがインストールとリエンゲージメントをChatGPT Adsキャンペーンにアトリビューションし、アプリ内イベントのポストバックを送信します。
  • Webサイト:ChatGPT AdsのJavaScriptピクセルと併用するか、その代わりにAppsFlyer Web SDKを使用して、ページ閲覧、コンテンツ閲覧、購入などのWebイベントを取得し、ChatGPT AdsのConversions API(CAPI)に転送します。

WebサイトでChatGPT Adsピクセルも使用している場合、ChatGPT Adsは共通のイベントIDを使って、Conversions API(CAPI)経由で送信されるサーバー側のイベントとピクセル経由のイベントの重複を排除します。これにより、コンバージョン数を重複してカウントすることなく、CAPIとピクセルを併用できます。

AppsFlyerに送信するイベントのペイロードに、この共通IDをaf_customer_event_idとして含めてください。詳しくは、後述のWebサイトの連携を参照してください。

連携の設定

計測するモバイルアプリとWebサイトごとに、個別に連携を設定します。それぞれの設定には、ChatGPT Ads(OpenAI)の広告マネージャーアカウントで取得したピクセルIDとAPIキーが必要です。

事前準備:

  • 連携を設定する前に、ChatGPT Adsのアカウントを開設してください。
  • AppsFlyerにモバイルアプリとWebサイトアプリを登録しておいてください。詳細はこちら

連携の設定手順:

  1. 連携を有効にする場合:AppsFlyerのサイドメニューから、連携 > パートナー連携 > Marketplaceタブを選択します。
    設定を編集する場合:AppsFlyerのサイドメニューから、連携 > パートナー連携 > 有効な連携タブを選択します。
  2. 連携する対象に応じて、以下の設定を行います。
  • モバイルアプリ:インストール、リエンゲージメント、アプリ内イベントをChatGPT Adsキャンペーンにアトリビューションします。
  • Webサイト:WebコンバージョンイベントをChatGPT AdsのConversions APIに転送し、ChatGPT Adsピクセル経由のイベントとの重複を排除します。

モバイルアプリの連携

以下の手順で、モバイルアプリにおけるChatGPT Adsのアトリビューションとアプリ内イベントのポストバックを設定します。

モバイルアプリの連携手順:

  1. AppsFlyerのサイドメニューから、連携 > パートナー連携 > Marketplaceタブを選択します。
  2. ドロップダウンメニューからモバイルアプリを選択します。
    注意:Androidアプリ、iOSアプリなど、アプリが対応するプラットフォームごとに、この手順を繰り返す必要があります。
  3. ChatGPT Ads(OpenAI)を検索し、連携をクリックします。
  4. 以下の説明に沿って、各タブの設定を行います。

「連携」タブ

パートナーの有効化

連携を有効にするには:

「パートナーを有効にする」をオンにします。

重要な注意:ChatGPT Adsを利用している間は、この設定を常にオンにしておく必要があります。連携を無効にすると、キャンペーンのアトリビューションとポストバックの送信が停止します。
詳しくは、パートナーの有効化を参照してください。

一般設定

以下の認証情報を入力します。

  • ピクセルID:ChatGPT Adsの広告マネージャーでピクセルを作成します。広告マネージャーアカウントのコンバージョンタブから取得してください。
  • APIキー:Events APIの呼び出しを認証するために必要です。 ChatGPT Adsの広告マネージャーアカウントのコンバージョンタブから取得してください。 
    注意:必要な権限があるのはCAPI用のキーです。広告管理用ではなく、必ずコンバージョンAPI用のAPIキーを使用してください。
高プライバシーモード

高プライバシーモード(AP)のオン・オフによって、広告主側またはパブリッシャー側でIDFAを提供していないiOS 14.5以降のユーザーについて、OpenAIへのイベントの送信方法が変わります。

  • 高プライバシーモードが無効の場合:IDFAが利用できない場合でも、IPアドレスやユーザーエージェントなど、利用可能なすべてのユーザー識別子を含めてイベントを送信します。
  • 高プライバシーモードが有効の場合:openai_intにアトリビューションされたイベントのみを送信します。これらのポストバックには、アトリビューションデータのみが含まれます。送信前に、ユーザーレベルの識別子をすべてポストバックから削除します。

OpenAIはiOSデバイスのIDFAを収集・共有しないため、アトリビューションされていないイベントのポストバックを確実に送信するには、高プライバシーモードをオフにする必要があります。

詳細マッチングデータの共有

オンにすると、AppsFlyerに送信されたイベント情報に詳細マッチング用のフィールドが含まれている場合、そのフィールドをChatGPT Adsと共有します。対象には、ハッシュ化されたメールアドレス、電話番号、名、姓などがあります。詳しくは、詳細マッチングデータの共有を参照してください。

デフォルトのポストバック

ポストバックとは、インストールやアプリ内での操作など、アトリビューションされたイベントを報告するために、AppsFlyerからChatGPT Adsへサーバー間で送信する通知です。このセクションには、ポストバックの設定が表示されます。設定方法については、インストールとリアトリビューションのポストバックの設定を参照してください。

詳しくは、デフォルトのポストバック設定を参照してください。

アプリ内イベント設定

ChatGPT Adsにアプリ内イベントのポストバックを送信するには、以下の認証情報を入力します。

  • ピクセルID
  • APIキー

詳しくは、前述の一般設定を参照してください。

アプリ内イベントのポストバック

ChatGPT Adsに送信するアプリ内イベントのポストバックを設定します。詳細はこちら

アプリ内イベントのポストバックを有効にするには:

「アプリ内イベントのポストバック」をオンにします。

アプリ内イベントのポストバック期間

インストール、リアトリビューション、リエンゲージメントの発生後、AppsFlyerからChatGPT Adsにアプリ内イベントのポストバックを送信する期間を設定します。詳細はこちら

イベントのマッピング

送信するイベントをChatGPT Ads側の対応するイベントに紐付けるため、イベント名をマッピングします。詳細はこちら

ChatGPT Adsは以下の標準イベントに対応しています。該当する標準イベントがない場合は、Customを使用できます。

ChatGPT Adsのイベント名 使用するタイミング
page_viewed ユーザーが重要なページにアクセスしたとき、またはそのページを閲覧したとき。
contents_viewed ユーザーが特定の商品、掲載情報、記事、その他の個別コンテンツを閲覧したとき。
items_added ユーザーがカート、セット、または選択リストに1つ以上のアイテムを追加したとき。
checkout_started ユーザーが購入手続きを開始したとき。
order_created 購入が完了したとき。
registration_completed ユーザーがアカウント登録またはイベントへの参加登録を完了したとき。
lead_created ユーザーが見込み顧客情報を入力するフォームを送信したとき、または連絡を希望したとき。
appointment_scheduled ユーザーがミーティング、デモ、相談を予約したとき。
trial_started 無料トライアルが開始されたとき。
subscription_created 有料サブスクリプションが開始されたとき。
app_opened モバイルアプリが起動されたとき。
custom 標準イベントの分類に当てはまらないイベント。

イベントの重複排除

WebサイトでChatGPT Adsピクセルも使用している場合は、AppsFlyerがイベントの重複を排除できるよう、AppsFlyerとChatGPT Adsの両方に同じイベントIDを送信します。

  • AppsFlyerに送信するイベントのペイロードに、af_customer_event_idを含めます。Web SDKではeventValue内、S2S(サーバー間)APIではevent_value内に指定します。
  • 対応するピクセルイベントにも同じ値を指定して送信します。

AppsFlyerは、この値をイベントIDとしてChatGPT Adsに転送します。 ChatGPT AdsはこのIDを使い、AppsFlyerから受信したサーバー側のイベントとピクセルイベントの重複を排除します。これにより、AppsFlyerではコンバージョンが1回だけカウントされます。

af_customer_event_idを送信しない場合、AppsFlyerがイベントIDを自動生成します。このIDは、ピクセルイベントのIDとは一致しません。

詳しくは、「AppsFlyer Web SDKの実装」を参照してください。

 

「アトリビューションリンク」タブ

ChatGPT Ads(OpenAI)はアトリビューションリンクに対応しています。

アトリビューション方法の選択

以下のどちらの方法を使用するかを決めます。

  1. ユーザーをアプリストアに直接誘導する。この場合、キャンペーンの要件とターゲティング設定に応じて、単一プラットフォーム向けのアトリビューションリンクまたはOneLinkを作成し、最終URLとして使用します。 

    または 
     

  2. 広告のリンク先をランディングページにし、そこからSmart ScriptまたはSmart Bannerを使って、アトリビューションに必要なリンクを生成しながら、ユーザーをApp StoreまたはGoogle Playに誘導する。

パラメータの選択

アトリビューションリンクに含めるパラメータを選択します。

  • キャンペーン名やサイトIDなど、アトリビューションリンクに含めるパラメータを選択し、クリックスルールックバック期間を設定します。AppsFlyerが推奨するデフォルト値は7日間です。 ChatGPT Adsキャンペーンで使用するアトリビューションリンクが、AppsFlyerによって自動生成されます。
  • 以下の動的URLマクロを使用すると、ChatGPTが対応する値をURLパラメータに自動入力できます。
    • af_partner_account_id={ad_account_id}
    • af_c_id={campaign_id}
    • af_adset_id={ad_group_id}
    • af_ad_id={ad_id}
    • clickid={oppref}
  • 名称を取得するマクロには対応していません。

重要

  • 広告からApp StoreまたはGoogle Playに直接誘導する場合は、AppsFlyerがChatGPT AdsのクリックIDを取得してChatGPT Adsに返せるよう、必ずclickid={oppref}を使用してください。広告のリンク先がSmart Scriptを設置したランディングページの場合は、受信URLのopprefパラメータを必ず取得し、送信URLのclickidにマッピングしてください。
  • ChatGPT Adsでは、{campaign_id}などのマクロが実際の値に置き換えられるのは、パラメータをトラッキングパラメータ欄に入力した場合のみです。広告のリンク先URL欄では置き換えられません。 af_c_id={campaign_id}などのクエリパラメータはトラッキングパラメータ欄に貼り付け、広告のリンク先URL欄にはリンク先のURLのみを入力してください。

注意:生成されたリンクには、openai_int(AppsFlyerにおけるChatGPT Adsの連携ID)が含まれます。

詳しくは、アトリビューションリンクを参照してください。

「コスト」タブ

現在、ChatGPT AdsとのコストAPI連携には対応していません。 

「広告収益」タブ

ChatGPT Adsから広告収益データを取得することはできません。キャンペーンの最適化に向けて広告収益データを共有するには、ポストバックまたはUAシグナルを使用してください。

「権限」タブ

ChatGPT Adsのチームメンバーにデータへのアクセス権を付与するには、「アドネットワークの権限」をオンにします。オンにしたら、連携の設定、リテンションレポートやコホートレポートへのアクセス、コンバージョンと収益の集計データの閲覧など、付与する権限を個別に選択します。 ChatGPT Adsのアトリビューションを無効にしていても、権限を付与できます。

詳しくは、権限を参照してください。

Webサイトの連携

以下の手順で、Webサイトのイベントをサーバー経由でChatGPT Adsに転送する設定を行います。

Webサイトの連携手順:

  1. AppsFlyerのサイドメニューから、連携 > パートナー連携 > Marketplaceタブを選択します。
  2. ドロップダウンメニューからWebサイトアプリを選択します。
  3. ChatGPT Ads(OpenAI)を検索し、連携をクリックします。
  4. 以下の説明に沿って、「連携」タブの設定を行います。

「連携」タブ

パートナーの有効化

連携を有効にするには:

「パートナーを有効にする」をオンにします。

重要な注意:ChatGPT Adsを利用している間は、この設定を常にオンにしておく必要があります。連携を無効にすると、Webサイトのイベントの転送が停止します。
詳しくは、パートナーの有効化を参照してください。

アプリ内イベント設定

ChatGPT Adsにイベントのポストバックを送信するには、以下の認証情報を入力します。

  • ピクセルID:ChatGPT Adsの広告マネージャーでピクセルを作成します。広告マネージャーアカウントのコンバージョンタブから取得してください。
  • APIキー:Events APIの呼び出しを認証するために必要です。 ChatGPT Adsの広告マネージャーアカウントのコンバージョンタブから取得してください。

詳細マッチングデータの共有:オンにすると、AppsFlyerに送信されたイベント情報に詳細マッチング用のフィールドが含まれている場合、そのフィールドをChatGPT Adsと共有します。対象には、ハッシュ化されたメールアドレス、電話番号、名、姓などがあります。詳しくは、詳細マッチングデータの共有を参照してください。

アプリ内イベントのポストバック

ChatGPT Adsに送信するイベントのポストバックを設定します。詳細はこちら

イベントのポストバックを有効にするには:

「アプリ内イベントのポストバック」をオンにします。

イベントのマッピング

送信するイベントをChatGPT Ads側の対応するイベントに紐付けるため、イベント名をマッピングします。 ChatGPT Adsが対応しているイベントについては、前述の標準イベントの表を参照してください。詳細はこちら

「アトリビューションリンク」タブ

ChatGPT Ads(OpenAI)のWebサイト連携では、外部のアトリビューションリンクは使用しません。 AppsFlyer Web SDKでWebイベントを計測し、ChatGPT AdsのConversions APIに直接転送するため、リンクを使ったアトリビューションの設定は不要です。

「コスト」タブ

ChatGPT AdsとのWebサイト連携では、コストデータは利用できません。

「広告収益」タブ

ChatGPT AdsとのWebサイト連携では、広告収益データは利用できません。

「権限」タブ

ChatGPT AdsとのWebサイト連携では、権限は利用できません。

特性と制限事項

項目 説明
対応国 ChatGPT Adsの広告マネージャーを利用できる国については、対応国の一覧を参照してください。

関連情報