OpenAI Ads (ChatGPT) 데이터 커넥터

팔로우
Avatar
Fernando Cabral
Updated
ChatGPT Ads 설정 
데이터 커넥터(비용 집계)
데이터 커넥터 설정 

 

데이터 커넥터 추가

  1. Data Integrations > Data Connectors, 클릭 Add Data Connector를 클릭한 다음 커넥터를 검색합니다: “ChatGPT (OpenAI Ads)”.
    Singular Data Connectors page with ChatGPT typed in the connector search and the Add Data Connector button highlighted
     
  2. 다음을 붙여넣습니다: OpenAI Ads API key. 키를 생성하려면 OpenAI Ads Manager 계정에서 다음 탭을 열고 Settings API 키를 생성하세요.
    OpenAI Ads Manager Settings page with the Create New API Key dialog, naming the key Singular API Key
    Singular ChatGPT Configuration panel with the OpenAI Ads API key entered and Automatically pull historical data checked
  3. Submit.
     

빠른 세부 정보

API Version API (OpenAI Ads API v1, https://api.ads.openai.com/v1)
인증 OpenAI Ads Manager에서 다음 위치에 생성한 Bearer API 키입니다: Settings. 광고 계정당 키 하나입니다.
데이터 분류(세분화)

OpenAI Ads는 다음 모든 기준으로 분류된 데이터를 제공합니다(용어는 아래 데이터 매핑 참조):

  • 계정
  • 캠페인
  • 하위 캠페인(OpenAI "Ad Group")
  • 크리에이티브(OpenAI "Ad")

국가는 리포팅 분류 기준으로 반환되지 않고, 각 캠페인의 타겟팅 설정에서 파생됩니다. 알려진 제한 사항을 참조하세요.
데이터를 얼마나 오래 거슬러 올라가는지 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 및 문제 해결

Singular는 OpenAI Ads에서 어떤 지표을 가져오나요?

OpenAI Ads가 제공하는 지표 중에서 Singular 연동은 퍼포먼스 마케팅과 관련된 지표을 수집합니다:

  • Impressions
  • Clicks
  • Cost

OpenAI Ads는 현재 리포팅 API를 통해 설치수나 전환수를 반환하지 않으므로, Singular 리포트의 Installs 지표은 Singular 자체 어트리뷰션에서만 나옵니다.

OpenAI의 전환 또는 설치 데이터가 비용 리포트에 표시되지 않는 이유는 무엇인가요?

OpenAI의 리포팅 API는 비용, 노출수, 클릭수를 반환합니다. 어트리뷰션된 설치와 인앱 이벤트는 Singular의 어트리뷰션 파이프라인에서 나오며, 공통 Campaign, Sub-Campaign, Creative ID를 기준으로 OpenAI 비용과 결합됩니다. 이 덕분에 Singular는 OpenAI Ads 비용에 대한 ROI와 eROAS를 보여줄 수 있습니다.

이 결합이 작동하려면 캠페인에서 Singular 트래킹 링크를 사용해야 합니다. OpenAI Ads 어트리뷰션 가이드를 참조하세요.
 

OpenAI 광고 계정을 여러 개 Singular로 가져올 수 있나요?

 

가능하지만 API 키 하나가 광고 계정 하나만 담당하므로, 광고 계정마다 데이터 커넥터를 하나씩 추가해야 합니다. 또는 OpenAI 광고주 지원팀에 다중 계정 API 접근을 요청할 수 있습니다.

OpenAI Ads 원시 데이터를 자체 데이터 웨어하우스로 받을 수 있나요?

가능합니다. Singular의 Extract 제품은 campaign, ad group, ad, insights 스트림을 포함한 OpenAI Ads 데이터를 BI 스택으로 직접 전달할 수 있습니다. 다음을 참조하세요: Extract 소스로서의 OpenAI Ads.

 

알려진 제한 사항
  • 광고 계정당 API 키 하나입니다. OpenAI가 다중 계정 API 접근을 허용하지 않는 한, 광고 계정이 여러 개이면 데이터 커넥터도 여러 개 필요합니다.
  • 국가는 캠페인 타겟팅에서 파생되며, 첫 번째 타겟 국가만 반영합니다. OpenAI의 insights 엔드포인트는 지역 분류를 반환하지 않으므로, Singular는 캠페인의 타겟팅 설정을 사용합니다. 여러 국가를 타겟팅하는 캠페인의 경우, 기본적으로 타겟팅 목록의 첫 번째 국가만 'Country' 기준으로 리포트됩니다.