データコネクタを追加
- Data Integrations > Data Connectors、クリック Add Data Connector をクリックし、コネクタを検索します: 「ChatGPT (OpenAI Ads)」。
- 次を貼り付けます: OpenAI Ads API key。キーを生成するには、OpenAI Ads Manager アカウントで次のタブを開き、 Settings API キーを生成します。
- Submit。
概要情報
| API Version | API (OpenAI Ads API v1, https://api.ads.openai.com/v1) |
| 認証 | OpenAI Ads Manager の次の場所で生成した Bearer API キー: Settings。広告アカウントごとに1つのキーです。 |
| データの内訳（セグメンテーション） |
OpenAI Ads は、次のすべてのディメンションで分類したデータを提供します（用語は以下のデータマッピングを参照）:
国はレポートの内訳として返されるのではなく、各キャンペーンのターゲティング設定から導出されます。既知の制限事項を参照してください。 |
| データの取得期間 | Singular は毎日、7日前までのデータを取得します。 |
| タイムゾーン | OpenAI アカウントに設定されているタイムゾーンです。 |
| データはクリエイティブ（広告）レベルで利用できますか？ | はい。 |
| Singularはクリエイティブアセットを表示しますか？ | はい。Singular は各広告のクリエイティブタイプ、タイトル、本文、ターゲット URL、画像 URL を取得します。 |
| 既知の制限/問題 | 以下の既知の制限事項を参照してください。 |
データマッピング
用語に関する注記:
- "Campaign" は Singular における "Campaign" （OpenAI Ads）に相当します
- "Sub-Campaign" は OpenAI の "Ad Group"
- "Creative" は OpenAI の "Ad"
すべてのフィールドの説明については、次を参照してください: Singular の指標とディメンションの用語集。
| Field in Singular UI | Field in Singular API | Field in OpenAI Ads |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id |
id from /v1/ad_account
|
| Account Name | adn_account_name |
name from /v1/ad_account
|
| Network Campaign ID | adn_campaign_id |
campaign_id |
| Network Campaign Name | adn_campaign_name |
campaign_name |
| Network Sub Campaign ID | adn_sub_campaign_id |
ad_group_id |
| Network Sub Campaign Name | adn_sub_campaign_name |
ad_group_name |
| Network Creative ID | adn_creative_id |
ad_id |
| Network Creative Name | adn_creative_name |
ad_name |
| Country | country_field |
Derived from the campaign's targeting.locations.countries
|
| Date | date_field |
Given as a parameter when querying OpenAI Ads (time_ranges[], daily granularity) |
| Metrics | ||
| Cost | adn_cost |
spend |
| Impressions | adn_impressions |
impressions |
| Clicks | adn_clicks |
clicks |
コストは広告アカウントの通貨でレポートされ、その値は OpenAI 広告アカウントの currency_code から取得されます。
クリエイティブアセット
Singular は、OpenAI の次のエンドポイントから取得したクリエイティブメタデータで各広告を補強します: /v1/ads クリエイティブタイプ、タイトル、本文、ターゲット URL、画像 URL、および広告のステータスと審査ステータスです。これらがクリエイティブプレビューと Creative IQ レポートを支えています。
FAQ とトラブルシューティング
OpenAI Ads が提供する指標のうち、Singular の連携ではパフォーマンスマーケティングに関連する指標を収集します:
- Impressions
- Clicks
- Cost
OpenAI Ads は現在、レポート API 経由でインストールやコンバージョンを返さないため、Singular のレポートの Installs 指標は Singular 独自のアトリビューションのみに基づいています。
OpenAI のレポート API は、消費額、インプレッション、クリックを返します。アトリビューションされたインストールとアプリ内イベントは Singular のアトリビューションパイプラインから取得され、共通の Campaign、Sub-Campaign、Creative ID で OpenAI のコストと結合されます。これにより、Singular は OpenAI Ads の支出に対する ROI と eROAS を表示できます。
この結合が機能するには、キャンペーンで Singular のトラッキングリンクを使用している必要があります。OpenAI Ads のアトリビューションガイドを参照してください。
可能ですが、API キー1つで対応できるのは広告アカウント1つのため、広告アカウントごとにデータコネクタが必要です。または、OpenAI の広告主サポートにマルチアカウント API アクセスをリクエストすることもできます。
可能です。Singular の Extract 製品は、campaign、ad group、ad、insights の各ストリームを含む OpenAI Ads のデータを BI スタックに直接配信できます。次を参照してください: Extract のソースとしての OpenAI Ads。
- 広告アカウントごとに API キー1つです。 OpenAI がマルチアカウント API アクセスを許可しない限り、複数の広告アカウントには複数のデータコネクタが必要です。
- 国はキャンペーンのターゲティングから導出され、最初にターゲットとした国のみが反映されます。 OpenAI の insights エンドポイントは地域の内訳を返さないため、Singular はキャンペーンのターゲティング設定を使用します。複数の国をターゲットにしているキャンペーンでは、デフォルトでターゲティングリストの最初の国のみが "Country" ディメンションとしてレポートされます。