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 " a partir do seu OpenAI Ads Manager . Use o mesmo Pixel ID e a mesma Conversions API Key para todas as plataformas que configurar, em vez de um separado por plataforma. Consulte Preciso de um Pixel ID separado para web e app mobile? abaixo.
   
   
5. Opcionalmente, configure eventos adicionais para enviar ao OpenAI e mapeie-os para um "OpenAI Event Name"
   
   
6. Clique em " Save " para concluir.

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"

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. Defina o destino de redirecionamento. É para onde o usuário é enviado quando não tem o app instalado. O padrão é a URL da loja do seu app. Para enviar esses usuários ao seu site, escolha a opção Web URL e informe o destino. Campanhas web que convertem no seu site usam essa opção.
6. (Opcional) Adicione os parâmetros ou macros adicionais que precisar na seção Additional Parameters. Adicione-os aqui em vez de editar o link gerado depois.
7. Clique em "Generate"
8. Copie o "Click-through Tracking Link" para a próxima etapa

O link gerado já inclui os parâmetros de campanha e as macros dinâmicas do OpenAI Ads. Todos os parâmetros são encaminhados ao destino de redirecionamento, onde o Web SDK da Singular os lê para atribuir a conversão web. Um link gerado tem esta aparência:

https://yourapp.sng.link/XXXXX/YYYY?_dl=yourapp%3A%2F%2Fmy_default_deeplink&_smtype=3&wpcl={oppref}&wpscid={ad_group_id}&pcid={campaign_id}&_forward_params=1&pscid={ad_group_id}&pcrid={ad_id}&wpcrid={ad_id}&cl={oppref}&wpsrc=ChatGPT%20Web%20CAPI&wpcid={campaign_id}

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":
   
3. Mantenha as macros do link como estão. O OpenAI Ads substitui {campaign_id}, {ad_group_id}, {ad_id}, {oppref} no momento do clique, portanto a desagregação da campanha chega à Singular sem nenhuma substituição manual.

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

• Source = "ChatGPT"
• Tracker Source Name = "ChatGPT"

1. Acesse a página OpenAI Conversions .
2. Selecione " Create " e escolha "Data Source":
3. Ao concluir, copie o novo Pixel ID:
   

Não. Use um Pixel ID do OpenAI por anunciante, marca ou destino de parceiro de integração, não por plataforma. Na Singular, use o mesmo Pixel ID e a mesma Conversions API Key para a medição em web, iOS e Android.

A Singular define a plataforma em cada evento automaticamente: action_source: "web" para eventos web e action_source: "mobile_app" para eventos de iOS e Android. Não há nada a configurar para isso.

Atualmente o OpenAI não suporta fontes de dados móveis nativas, portanto não existe uma fonte de dados do tipo app para criar. Crie uma fonte de dados web e use o Pixel ID dela para todas as plataformas que você medir.

1. Acesse a página OpenAI Conversions .
2. Selecione " Conversion keys " e escolha "Create new key":
   
   
3. Copie sua nova chave para a Partner Configuration da Singular:
   
   

Cada dimensão de campanha aparece duas vezes. O parâmetro do lado do app atribui a instalação, e o parâmetro do lado web é o que o Web SDK da Singular lê para atribuir uma conversão que acontece no seu site. Um único link atende aos dois resultados.

O link também inclui estes parâmetros de controle:

• wpsrc=ChatGPT%20Web%20CAPI define o Source do Singular Web Attribution e é obrigatório para que o postback do OpenAI Ads seja disparado. Não altere esse valor.
• _forward_params=1 encaminha os parâmetros do link aos destinos de redirecionamento da loja e do site.
• _dl contém o destino de deep link que o link abre quando o app está instalado.
• _smtype=3 é aplicado quando a atribuição probabilística está habilitada no link de tracking. Se a atribuição probabilística estiver desativada para o link, esse parâmetro não é adicionado.

O link de tracking captura os IDs de campanha, grupo de anúncios e anúncio, não os nomes. A Singular obtém os nomes do Data Connector do OpenAI Ads e os associa aos IDs capturados no link, de modo que seus relatórios mostram nomes legíveis para os cliques e as instalações.

É por isso que os nomes não são incluídos no link. Os IDs são chaves de junção estáveis, portanto uma campanha renomeada continua reportando corretamente em relação aos cliques históricos.