Atribuição e CAPI do OpenAI Ads (ChatGPT)

Seguir
Avatar
Samar Perka
Updated
Configuração do ChatGPT Ads
Atribuição e Conversions API
Configurar o link de tracking e os postbacks

Este artigo explica como configurar campanhas do OpenAI Ads (ChatGPT) com a atribuição e a Conversions API da Singular para campanhas de apps mobile, instalações em PC/console e campanhas web.

Visão geral

As soluções de atribuição web-to-app da Singular permitem que profissionais de marketing executem campanhas web que geram instalações de apps nas plataformas mobile, PC e console. A integração web-to-app do OpenAI Ads da Singular suporta o fluxo Direct to Store descrito no nosso Guia de Web to App aqui .

Adicionar a configuração de parceiro do ChatGPT na Singular

Adicionar a configuração de parceiro do ChatGPT Ads na Singular

  1. Acesse Singular > Attribution > Partner Configuration
  2. Clique em " Add a Partner ", digite e escolha " OpenAI Ads (ChatGPT) "
  3. Na janela, escolha o app e o app/site (plataforma) que deseja configurar. Esta integração suporta apps mobile, web, PC e console
  4. Cole o " Pixel ID " e a " Conversions API Key " do seu app a partir do seu OpenAI Ads Manager .
    Configuração de parceiro do OpenAI Ads (ChatGPT) na Singular com os campos Pixel ID e Conversions API Key preenchidos
  5. Opcionalmente, configure eventos adicionais para enviar ao OpenAI e mapeie-os para um "OpenAI Event Name"
    Configuração de postbacks na Singular mapeando eventos de receita e eventos in-app para nomes de eventos do OpenAI, com Send All e Include Revenue ativados
  6. Clique em " Save " para concluir.
Atributos de evento necessários para "OpenAI Ads (ChatGPT)"

Atributos de evento necessários para a integração "OpenAI Ads (ChatGPT)"

Para habilitar a integração do OpenAI Ads (ChatGPT), implemente e envie os atributos de evento a seguir. Eles diferenciam maiúsculas de minúsculas.

Mobile

Envie os seguintes atributos de evento:

  • ehash : o hash SHA-256 do endereço de e-mail do usuário, após remover os espaços no início e no fim e converter para minúsculas.
  • external_id_hash (opcional): o hash SHA-256 de um identificador de cliente pseudônimo e estável do seu sistema.
    • Se possível, envie tanto ehash quanto external_id_hash para melhorar o matching. Se ehash não estiver disponível, envie no mínimo external_id_hash .

Web

Envie os seguintes atributos de evento:

  • page_url (obrigatório): a URL completa da página em que o evento ocorreu (por exemplo, https://shop.example.com/checkout/confirmation ).
  • ehash : o hash SHA-256 do endereço de e-mail do usuário, após remover os espaços no início e no fim e converter para minúsculas.
  • external_id_hash (opcional): o hash SHA-256 de um identificador de cliente pseudônimo e estável do seu sistema.
    • page_url é obrigatório. Para os campos de usuário, se possível, envie tanto ehash quanto external_id_hash para melhorar o matching. Se ehash não estiver disponível, envie no mínimo external_id_hash .
Criar um Singular Link para "ChatGPT Ads"

Criar um Singular Link para "ChatGPT Ads"

  1. Acesse Singular > Attribution > Manage Links
  2. Selecione seu app mobile na lista de apps à esquerda
  3. Selecione "Create Link" -> Link Type "Partner" -> Source Name "OpenAI Ads (ChatGPT)"
  4. Prossiga pelo processo guiado de criação do link.
  5. Clique em "Generate"
  6. Copie o "Click-through Tracking Link" para a próxima etapa
Configurar sua campanha do OpenAI Ads (ChatGPT Ads)

Configurar sua campanha do OpenAI Ads (ChatGPT Ads)

  1. No OpenAI Ads Manager, crie uma campanha e avance até a etapa de Ad Group.
  2. Insira o Singular Link criado acima no campo "Default Ad Destination URL":
    Configuração do grupo de anúncios de uma nova campanha do OpenAI Ads com um link de tracking sng.link da Singular em Default Ad Destination URL

Perguntas frequentes

Como a Singular reporta as atribuições do ChatGPT?

Depois que uma atribuição é registrada, as atribuições do ChatGPT são reportadas da seguinte forma:

  • Source = "ChatGPT"
  • Tracker Source Name = "ChatGPT"
Onde encontrar o Pixel ID?
  1. Acesse a página OpenAI Conversions .
  2. Selecione " Create " e escolha "Data Source": Página Conversions do OpenAI Ads Manager com a janela Create new data source, nomeando Singular Pixel uma fonte de dados Web
  3. Ao concluir, copie o novo Pixel ID:
    Lista de fontes de dados do OpenAI Ads Manager mostrando a entrada Singular Pixel com o Pixel ID abaixo do nome
Onde encontrar a Conversions API Key?
  1. Acesse a página OpenAI Conversions .
  2. Selecione " Conversion keys " e escolha "Create new key":
    Janela Create New Conversion Key do OpenAI Ads Manager com o nome Singular Conversions API Key
  3. Copie sua nova chave para a Partner Configuration da Singular:
    Janela Save your key do OpenAI Ads Manager mostrando a chave gerada com os botões Copy e Download
Quais dados a Singular envia pela API?
Parâmetro Detalhes
event_name
  • Um nome de evento padrão ou personalizado. Este campo é mapeado automaticamente para o Singular Event Name. Esse valor ajuda o OpenAI a deduplicar eventos. O parâmetro event_id também é usado na deduplicação.
e-mail com hash
  • Opcional
  • O e-mail com hash pode ser enviado como o atributo de evento instrumentado da Singular "ehash"
  • O valor do e-mail com hash deve estar normalizado e com hash SHA-256
ID de usuário externo com hash
  • Opcional
  • O ID externo com hash pode ser enviado como o atributo de evento instrumentado da Singular "external_id_hash"
Endereço IP
  • O endereço IP do cliente
user agent
  • O User-Agent do cliente
Para deduplicação de eventos (opcional)
event_id
  • Parâmetro obrigatório para a deduplicação
  • Envie o valor de event_id para a Singular nos Event Arguments usando o nome de atributo: " eventId ".
  • O parâmetro event_id deve ser adicionado aos seus eventos a partir de ambos: a Conversions API e o OpenAI Pixel.
  • O parâmetro event_id é um identificador capaz de distinguir de forma única entre eventos similares.