Conector de datos de OpenAI Ads (ChatGPT)

Seguir
Avatar
Fernando Cabral
Updated
Configuración de ChatGPT Ads 
Conector de datos (agregación de costos)
Configurar el conector de datos 

 

Agregar el conector de datos

  1. En Data Integrations > Data Connectors, haz clic en Add Data Connector y busca el conector "ChatGPT (OpenAI Ads)".
    Singular Data Connectors page with ChatGPT typed in the connector search and the Add Data Connector button highlighted
     
  2. Pega tu OpenAI Ads API key. Para generar una, ve a tu cuenta de OpenAI Ads Manager, abre la pestaña Settings y genera una API key.
    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. Haz clic en Submit.
     

Detalles rápidos

API Version API (OpenAI Ads API v1, https://api.ads.openai.com/v1)
Autenticación API key de tipo Bearer, generada en OpenAI Ads Manager en Settings. Una clave por cuenta publicitaria.
Desglose de datos (segmentación)

OpenAI Ads proporciona tus datos desglosados por todas las siguientes dimensiones (consulta Mapeo de datos más abajo para la terminología):

  • Cuenta
  • Campaña
  • Subcampaña (el "Ad Group" de OpenAI)
  • Creativo (el "Ad" de OpenAI)

El país se deriva de la configuración de segmentación de cada campaña en lugar de devolverse como un desglose de reportes. Consulta Limitaciones conocidas.
Desde cuándo extraemos datos Todos los días, Singular extrae datos de los últimos 7 días.
Zona horaria La zona horaria configurada en la cuenta de OpenAI.
¿Hay datos disponibles a nivel creativo (anuncio)? Sí.
¿Muestra Singular tus activos creativos? Sí. Singular extrae el tipo de creativo, el título, el cuerpo, la URL de destino y la URL de imagen de cada anuncio.
Limitaciones y problemas conocidos Consulta Limitaciones conocidas más abajo.

Mapeo de datos

Notas de terminología:

  • "Campaign" en Singular corresponde a "Campaign" en OpenAI Ads
  • "Sub-Campaign" corresponde al "Ad Group"
  • "Creative" corresponde al "Ad"

Para ver la descripción de todos los campos, consulta el Glosario de métricas y dimensiones de 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

Los costos se reportan en la moneda de la cuenta publicitaria, tomada de currency_code en la cuenta publicitaria de OpenAI.

Activos creativos

Singular enriquece cada anuncio con metadatos de creativos extraídos del endpoint /v1/ads de OpenAI: tipo de creativo, título, cuerpo, URL de destino y URL de imagen, además del estado del anuncio y su estado de revisión. Esto es lo que alimenta las vistas previas de creativos y los reportes de Creative IQ.

 

FAQ y solución de problemas

¿Qué métricas extrae Singular de OpenAI Ads?

De las métricas que proporciona OpenAI Ads, la integración de Singular recopila las relevantes para el marketing de rendimiento:

  • Impressions
  • Clicks
  • Cost

Actualmente OpenAI Ads no reporta instalaciones ni conversiones a través de su API de reportes, por lo que la métrica Installs en tus reportes de Singular proviene únicamente de la atribución propia de Singular.

¿Por qué no veo datos de conversiones o instalaciones de OpenAI en mis reportes de costo?

La API de reportes de OpenAI devuelve gasto, impresiones y clics. Las instalaciones atribuidas y los eventos in-app provienen del pipeline de atribución de Singular y se unen al costo de OpenAI mediante los IDs compartidos de Campaign, Sub-Campaign y Creative. Esto es lo que permite a Singular mostrar ROI y eROAS sobre el gasto en OpenAI Ads.

Para que esta unión funcione, tus campañas deben usar enlaces de tracking de Singular. Consulta la guía de atribución de OpenAI Ads.
 

¿Puedo incorporar más de una cuenta publicitaria de OpenAI en Singular?

 

Sí, pero cada API key cubre una sola cuenta publicitaria, así que necesitas un conector de datos por cuenta. Como alternativa, solicita acceso multicuenta a la API al soporte para anunciantes de OpenAI.

¿Puedo obtener los datos brutos de OpenAI Ads en mi propio warehouse?

Sí. El producto Extract de Singular puede entregar los datos de OpenAI Ads directamente a tu stack de BI, incluidos los streams de campaign, ad group, ad e insights. Consulta OpenAI Ads como fuente de Extract.

 

Limitaciones conocidas
  • Una API key por cuenta publicitaria. Varias cuentas publicitarias requieren varios conectores de datos, a menos que OpenAI otorgue acceso multicuenta a la API.
  • El país se deriva de la segmentación de la campaña y refleja únicamente el primer país segmentado. El endpoint de insights de OpenAI no devuelve un desglose geográfico, por lo que Singular se basa en la configuración de segmentación de la campaña. Para una campaña que segmenta varios países, de forma predeterminada solo se reporta el primer país de la lista de segmentación como la dimensión 'Country'.