Adicionar o conector de dados
- Em Data Integrations > Data Connectors, clique em Add Data Connector e pesquise o conector "ChatGPT (OpenAI Ads)".
- Cole sua OpenAI Ads API key. Para gerar uma, acesse sua conta do OpenAI Ads Manager, abra a aba Settings e gere uma API key.
- Clique em Submit.
Detalhes rápidos
| API Version | API (OpenAI Ads API v1, https://api.ads.openai.com/v1) |
| Autenticação | API key do tipo Bearer, gerada no OpenAI Ads Manager em Settings. Uma chave por conta de anúncios. |
| Desagregação de dados (segmentação) |
O OpenAI Ads fornece seus dados desagregados por todas as dimensões a seguir (consulte Mapeamento de dados abaixo para a terminologia):
O país é derivado das configurações de segmentação de cada campanha, em vez de ser retornado como uma desagregação de relatório. Consulte Limitações conhecidas. |
| Qual o intervalo de tempo em que extraímos dados | Todos os dias, a Singular extrai dados dos últimos 7 dias. |
| Fuso horário | O fuso horário configurado na conta da OpenAI. |
| Os dados estão disponíveis no nível criativo (anúncio)? | Sim. |
| O Singular mostra seus ativos criativos? | Sim. A Singular extrai o tipo de criativo, o título, o corpo, a URL de destino e a URL da imagem de cada anúncio. |
| Limitações/ problemas conhecidos | Consulte Limitações conhecidas abaixo. |
Mapeamento de dados
Notas de terminologia:
- "Campaign" na Singular corresponde a "Campaign" no OpenAI Ads
- "Sub-Campaign" corresponde ao "Ad Group"
- "Creative" corresponde ao "Ad"
Para ver a descrição de todos os campos, consulte o Glossário de métricas e dimensões da 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 |
Os custos são reportados na moeda da conta de anúncios, obtida de currency_code na conta de anúncios da OpenAI.
Ativos criativos
A Singular enriquece cada anúncio com metadados de criativos extraídos do endpoint /v1/ads da OpenAI: tipo de criativo, título, corpo, URL de destino e URL da imagem, além do status do anúncio e do status de revisão. É isso que alimenta as prévias de criativos e os relatórios do Creative IQ.
FAQ e solução de problemas
Entre as métricas fornecidas pelo OpenAI Ads, a integração da Singular reúne as relevantes para marketing de performance:
- Impressions
- Clicks
- Cost
Atualmente o OpenAI Ads não reporta instalações nem conversões pela API de relatórios, portanto a métrica Installs nos seus relatórios da Singular vem apenas da atribuição própria da Singular.
A API de relatórios da OpenAI retorna gasto, impressões e cliques. As instalações atribuídas e os eventos in-app vêm do pipeline de atribuição da Singular e são unidos ao custo da OpenAI pelos IDs compartilhados de Campaign, Sub-Campaign e Creative. É isso que permite à Singular mostrar ROI e eROAS sobre o gasto em OpenAI Ads.
Para que essa junção funcione, suas campanhas precisam usar links de tracking da Singular. Consulte o guia de atribuição do OpenAI Ads.
Sim, mas cada API key cobre uma conta de anúncios, então você precisa de um conector de dados por conta. Como alternativa, solicite acesso multiconta à API ao suporte a anunciantes da OpenAI.
Sim. O produto Extract da Singular pode entregar os dados do OpenAI Ads diretamente para o seu stack de BI, incluindo os streams de campaign, ad group, ad e insights. Consulte OpenAI Ads como fonte do Extract.
- Uma API key por conta de anúncios. Várias contas de anúncios exigem vários conectores de dados, a menos que a OpenAI conceda acesso multiconta à API.
- O país é derivado da segmentação da campanha e reflete apenas o primeiro país segmentado. O endpoint de insights da OpenAI não retorna uma desagregação geográfica, então a Singular se baseia nas configurações de segmentação da campanha. Para uma campanha que segmenta vários países, por padrão apenas o primeiro país da lista de segmentação é reportado como a dimensão 'Country'.