Resumo: O ChatGPT Ads, um parceiro integrado da AppsFlyer, é a plataforma de anúncios da OpenAI. Configure a integração para mensurar e atribuir instalações de aplicativos mobile, eventos in-app e conversões da web geradas pelas suas campanhas do ChatGPT Ads.
Sobre a integração com o ChatGPT Ads
A integração da AppsFlyer com o ChatGPT Ads (OpenAI) permite que você mensure e atribua instalações de aplicativos, eventos in-app e conversões da web geradas pelas suas campanhas do ChatGPT Ads. Ela é compatível com a mensuração de sites e apps mobile.
- App mobile: a AppsFlyer atribui instalações e reengajamentos às suas campanhas do ChatGPT Ads e envia postbacks de eventos in-app.
- Site: a AppsFlyer envia eventos da web, como visualizações de página, conteúdo e compra, registrados pelo Web SDK da AppsFlyer para a Conversions API (CAPI) do ChatGPT Ads, além (ou em vez) do pixel JavaScript do ChatGPT Ads.
Se você também executar o pixel do ChatGPT Ads no seu site, o ChatGPT Ads elimina as duplicações entre os eventos do lado do servidor (enviados pela API de conversões, ou CAPI) e os eventos do pixel usando um ID de evento compartilhado, para que você possa executar a CAPI e o pixel em paralelo sem inflar suas contagens de conversão.
Inclua esse ID compartilhado como af_customer_event_id na carga útil do evento que você envia para a AppsFlyer. Veja Integre seu site abaixo.
Configurar a integração
Configure a integração separadamente para cada site e app mobile que você deseja mensurar. Você precisará de um Pixel ID e de uma API key da sua conta do ChatGPT Ads (OpenAI) Ads Manager para cada um.
Pré-requisitos:
- Antes de configurar a integração, abra uma conta no ChatGPT Ads.
- Seus sites e apps mobile são configurados na AppsFlyer. Saiba mais
Para configurar a integração:
-
Para ativar: Na AppsFlyer, no menu lateral, selecione a aba Colaborar > Integrações de parceiros > Marketplace.
Para editar: Na AppsFlyer, no menu lateral, selecione a aba Colaborar > Integrações de parceiros > Integrações ativas. - Configure a integração para seu:
- App mobile: atribua instalações, reengajamentos e eventos in-app a campanhas do ChatGPT Ads.
- Site: envie eventos de conversão da web para a Conversions API do ChatGPT Ads, com a desduplicação em relação ao pixel do ChatGPT Ads.
Integrar seu aplicativo mobile
Siga as etapas abaixo para configurar a atribuição e os postbacks de eventos in-app para o ChatGPT Ads no seu aplicativo mobile.
Para integrar seu app mobile:
- Na AppsFlyer, no menu lateral, selecione a aba Colaborar > Integrações de parceiros > Marketplace.
- Selecione seu app mobile no menu suspenso.
Atenção: você deverá repetir todas as etapas para cada plataforma onde seu aplicativo é executado, como Android e iOS. - Pesquise ChatGPT Ads (OpenAI) e clique em Integrar.
- Complete a configuração nas abas descritas abaixo.
Aba de integração
Ativar parceiro
Para ativar a integração:
Habilite o botão Ativar parceiro.
Aviso importante: Essa opção deve permanecer habilitada enquanto você trabalhar com o ChatGPT Ads. Ao desativar a integração, você também desativará a atribuição e os postbacks para suas campanhas.
Saiba mais sobre a ativação de parceiros.
Configurações gerais
Insira as seguintes credenciais:
- Pixel ID: Um pixel é criado no seu ChatGPT Ads Manager. Você pode obtê-lo na aba de conversões na sua conta do Ads Manager.
-
API key: Uma API key é necessária para autenticar chamadas da Events API. Você pode obtê-la na aba de conversões na sua conta do Ads Manager.
Observação: Certifique-se de usar a API key de conversões em vez da API key de gerenciamento de anúncios, pois as permissões necessárias exigem a CAPI key.
Compartilhamento de dados de correspondência avançada: Ative essa opção para compartilhar campos de correspondência avançada (como e-mail, número de telefone, nome e sobrenome com hashes) com o ChatGPT Ads, se esses campos estiverem incluídos nas informações do evento enviadas à AppsFlyer. Para mais informações, consulte: Compartilhamento de dados de correspondência avançada (em inglês).
Postbacks padrão
Um postback é uma notificação de servidor para servidor que a AppsFlyer envia ao ChatGPT Ads para informar um evento atribuído (como uma instalação ou uma ação dentro do aplicativo). Seus postbacks são exibidos nesta seção. Descubra como configurar os postbacks de instalação e reatribuição.
Saiba mais sobre a configuração de postbacks padrão.
Configurações de eventos in-app
Para enviar postbacks de eventos in-app ao ChatGPT Ads, insira as credenciais necessárias:
- Pixel ID
- chave de API
Para mais informações, consulte as configurações gerais.
Postbacks de eventos in-app
Configure os postbacks de eventos in-app para enviar ao ChatGPT Ads. Saiba mais
Para ativar postbacks de eventos in-app:
Ative a opção Postbacks de eventos in-app.
Janela de postback de eventos in-app
Defina o período após uma instalação, reatribuição ou reengajamento, durante o qual a AppsFlyer envia postbacks de eventos in-app ao ChatGPT Ads. Saiba mais
Mapeie seus eventos
Para garantir que seus eventos correspondam aos eventos correspondentes no ChatGPT Ads, mapeie os nomes dos seus eventos. Saiba mais
O ChatGPT Ads aceita os seguintes eventos padrão, além de um fallback personalizado para qualquer evento não incluído abaixo:
| Nome do evento do ChatGPT Ads | Quando usar |
|---|---|
| página_visualizada | O usuário acessa ou visualiza uma página importante. |
| conteúdo_visualizado | O usuário visualiza um produto, lista, artigo ou conteúdo específico. |
| item_adicionado | O usuário adiciona um ou mais itens ao carrinho, pacote ou seleção. |
| checkout_started | O usuário inicia o checkout. |
| order_created | Compra concluída. |
| registo_concluído | O usuário conclui o cadastro de uma conta ou um evento. |
| lead_created | O usuário envia um formulário de lead ou solicita contato. |
| appointment_scheduled | O usuário agenda uma reunião, demonstração ou consultoria. |
| período_de_avaliação_iniciado | Início do teste gratuito. |
| subscription_created | Início da assinatura paga. |
| app_opened | O usuário abre o app mobile. |
| personalizado | Qualquer evento não incluído na taxonomia padrão. |
Desduplicação de eventos
Se você também executar o pixel do ChatGPT Ads no seu site, envie o mesmo ID de evento para a AppsFlyer e o ChatGPT Ads para que a AppsFlyer possa eliminar duplicações entre os eventos:
- Inclua
af_customer_event_idna carga útil do evento que você envia para a AppsFlyer, dentro de eventValue para o SDK web ou de event_value para a API S2S (server-to-server). - Envie o mesmo valor no evento de Pixel correspondente.
A AppsFlyer encaminha esse valor para o ChatGPT Ads como o ID do evento. O ChatGPT Ads então o usa para desduplicar o evento do lado do servidor que recebe da AppsFlyer em relação ao evento do Pixel, para que a AppsFlyer conte a conversão uma vez.
Se você não enviar af_customer_event_id, a AppsFlyer gera um ID de evento automaticamente. Esse ID não corresponderá aos seus eventos de Pixel.
Para mais informações, consulte Integrar o SDK web da AppsFlyer Web.
Aba do link de atribuição
O ChatGPT Ads (OpenAI) aceita links de atribuição.
Escolha um tipo de atribuição
Defina um link de atribuição de plataforma única ou um OneLink como seu URL final, com base nas necessidades das suas campanhas.
Recomendado: use uma landing page como destino do seu anúncio e utilize um Smart Script ou um Smart Banner para direcionar o usuário para a App Store ou o Google Play.
Selecionar parâmetros
Selecione os parâmetros do link de atribuição que deseja incluir.
- Selecione os parâmetros do link de atribuição que você quer incluir (por exemplo, Nome da campanha e ID do site) e defina sua janela de lookback de click-through (7 dias é o padrão recomendado pela AppsFlyer). A AppsFlyer gera automaticamente seu link de atribuição para usar nas suas campanhas do ChatGPT Ads.
- Os seguintes parâmetros de URL podem ser preenchidos automaticamente pelo ChatGPT usando estas macros de URL dinâmicas:
af_partner_account_id={ad_account_id}af_c_id={campaign_id}af_adset_id={ad_group_id}af_ad_id={ad_id}clickid={oppref}
- As macros do campo de nome não estão disponíveis.
Importante:
- Para que a AppsFlyer capture o ID de clique do ChatGPT Ads e o envie de volta ao ChatGPT Ads, use
clickid={oppref}se seus anúncios levarem diretamente para a App Store ou o Google Play. Quando o destino do anúncio for uma landing page com Smart Script, certifique-se de capturar o parâmetro de entradaopprefe mapeá-lo paraclickidna URL de saída. - O ChatGPT Ads só resolve macros (como
{campaign_id}) quando os parâmetros correspondentes são colocados no campo Parâmetros de rastreamento, e não no campo URL de destino do anúncio. Cole seus parâmetros de consulta (por exemplo,af_c_id={campaign_id}) no campo Parâmetros de rastreamento e use o campo URL de destino do anúncio apenas para a própria URL de destino.
Atenção: O link gerado inclui openai_int (ID da integração do ChatGPT Ads na AppsFlyer).
Saiba mais sobre os links de atribuição.
Custo
Atualmente, não há integrações de Cost API para o ChatGPT Ads.
Aba de receita de anúncios
Os dados de receita de anúncios não podem ser extraídos do ChatGPT Ads. Use postbacks ou sinais de UA para compartilhar dados de receita de anúncios para otimização de campanhas.
Aba de permissões
Ative a opção Permissões da ad network para conceder à equipe do ChatGPT Ads acesso aos seus dados. Depois de ativá-la, selecione as permissões individuais que você deseja conceder, como configurar a integração, acessar relatórios de retenção e de cohort ou visualizar dados agregados de conversão e receita. Observe que, mesmo com a atribuição desativada para o ChatGPT Ads, você ainda pode conceder permissões.
Saiba mais sobre as permissões.
Integrar seu site
Siga as etapas abaixo para configurar o envio de eventos do lado do servidor ao ChatGPT Ads para seu site.
Para integrar seu site:
- Na AppsFlyer, no menu lateral, selecione a aba Colaborar > Integrações de parceiros > Marketplace.
- Selecione o seu aplicativo de site no menu suspenso.
- Pesquise ChatGPT Ads (OpenAI) e clique em Integrar.
- Complete a configuração na aba de integração, conforme descrito abaixo.
Aba de integração
Ativar parceiro
Para ativar a integração:
Habilite o botão Ativar parceiro.
Aviso importante: Essa opção deve permanecer habilitada enquanto você trabalhar com o ChatGPT Ads. Ao desativar a integração, você também desativará o envio de eventos para seu site.
Saiba mais sobre a ativação de parceiros.
Configurações de eventos in-app
Para enviar postbacks de eventos ao ChatGPT Ads, insira as seguintes credenciais:
- Pixel ID: Um pixel é criado no seu ChatGPT Ads Manager. Você pode obtê-lo na aba de conversões na sua conta do Ads Manager.
- API key: Uma API key é necessária para autenticar chamadas da Events API. Você pode obtê-la na aba de conversões na sua conta do Ads Manager.
Compartilhamento de dados de correspondência avançada: Ative essa opção para compartilhar campos de correspondência avançada (como e-mail, número de telefone, nome e sobrenome com hashes) com o ChatGPT Ads, se esses campos estiverem incluídos nas informações do evento enviadas à AppsFlyer. Para mais informações, consulte: Compartilhamento de dados de correspondência avançada (em inglês).
Postbacks de eventos in-app
Configure os postbacks de eventos para enviar ao ChatGPT Ads. Saiba mais
Para ativar postbacks de eventos:
Ative a opção Postbacks de eventos in-app.
Mapeie seus eventos
Para garantir que seus eventos correspondam aos eventos equivalentes no ChatGPT Ads, mapeie os nomes dos seus eventos. Consulte a tabela de eventos padrão anterior para ver os eventos compatíveis com o ChatGPT Ads. Saiba mais
Aba do link de atribuição
O ChatGPT Ads (OpenAI) não usa links de atribuição externos para integrações de sites. O Web SDK da AppsFlyer mensura eventos da web e os envia diretamente para a Conversions API do ChatGPT Ads, portanto, não é necessário configurar a atribuição baseada em links.
Aba de custo
Os dados de custo não estão disponíveis para integrações de sites com o ChatGPT Ads.
Aba de receita de anúncios
Os dados de receita de anúncios não estão disponíveis para integrações de sites com o ChatGPT Ads.
Aba de permissões
As permissões não estão disponíveis para integrações de sites com o ChatGPT Ads.
Características e limitações
| Caraterística | Descrição |
| País | Lista de países onde o ChatGPT Ads Manager está disponível. |
Veja também