(API de conversão) API de conversões offline do Google Ads

Seguir
Avatar
Jonathan Chen
Updated
Documento
OsPostbacks de conversão para eventosWeb, PC e Console estão disponíveis apenas para clientes Singular com acesso à atribuição de jogos Web, PC e Console da Singular.

A integração da Singular com a API de conversões off-line do Google Ads (também conhecida como uploadClickConversions) permite que os anunciantes enviem conversões de cliques do Google Ads atribuídas pela Singular para o Google. Esta integração é suportada para a medição Singular para web, PC e consola. Para a integração da medição móvel da Singular com o Google Ads, consulte nosso artigo da Central de Ajuda sobre o assunto.

Como configurar a integração da API de conversões off-line do Google Ads

  1. Verifique se você tem um aplicativo integrado para web, PC ou console com a Singular
  2. Vá para Singular > Atribuição > Configuração de parceiros
  3. Clique em"Adicionar um parceiro", digite e escolha"API de conversões off-line do Google Ads (S2S)"
  4. Adicione ou selecione um utilizador existente para autorizar a Singular
  5. Na caixa de diálogo, escolha o aplicativo e o site do aplicativo (plataforma) para configurar. Tenha em atenção que apenas as aplicações Web, PC e consola são suportadas com esta integração
  6. Introduza o seu ID de cliente do Google Ads em"ID de cliente". Pode encontrar o seu ID de cliente no canto superior direito do seu painel de controlo do Google Ads. Os hífenes não são necessários.

    Se tiver várias contas do Google Ads a executar campanhas para a sua aplicação, é necessário utilizar o"ID do cliente" de uma conta de gestor (MCC) através do acompanhamento de conversões entre contas utilizando uma conta de gestor (MCC). Consulte o artigo do centro de ajuda da Google para obter um guia sobre como configurar a sua conta MCC.
  7. Apenas para aplicações para PC e Consola: na sua conta do Google Ads, crie uma Ação de conversão para a"Instalação". Copie e cole o"ID da ação de conversão Instalar" criado.
  8. Na sua conta do Google Ads, crie uma ação de conversão para quaisquer outros eventos que pretenda enviar e mapeie cada evento para o"ID da ação de conversão" correspondente.
  9. Clique em"Guardar" para terminar.

PERGUNTAS FREQUENTES

Como é que se cria uma ação de conversão para a API de conversões do Google Ads?
  1. Clique em"Nova ação de conversão"


  2. Selecione"Importar"


  3. Selecione"Importação manual utilizando API ou uploads" ->"Acompanhar conversões a partir de cliques"

    Nota: Pode não ver a opção"Importação manual utilizando API ou uploads" numa conta MCC. Neste caso, continue a criar a ação de conversão selecionando"Outras fontes de dados ou CRMs","Acompanhar conversões a partir de cliques" e"Saltar este passo e configurar uma fonte de dados mais tarde"

  4. Continue a seguir as instruções do Google para configurar os detalhes da Conversão. Clique em"Criar e continuar" quando terminar

  5. De volta à página"Objectivos de conversão", encontre a ação de conversão que acabou de criar e clique nela para ver os detalhes


  6. Na página"Detalhes" da ação de conversão, copie o"ID da ação de conversão" do parâmetro de URL"ctId="



  7. Cole este"ID da ação de conversão" na configuração do seu parceiro Singular quando lhe for pedido para introduzir o"ID da ação de conversão"
Como criar uma ação de conversão para a API de conversões do Google Ads (IU actualizada)?
  1. Clique em Criar >"Nova ação de conversão"


  2. Se ainda não estiver selecionado, selecione Conversões offline > Continuar
  3. Se ainda não tiver configurado nenhuma Conversão offline, poderá ver este ecrã. Selecione"Ignorar este passo e configurar a Fonte de dados mais tarde".
  4. Selecione a ação de conversão padrão que pretende medir.
  5. Clique em"Adicionar um evento a esta categoria" >"Fontes de dados offline"
Importante A ação de conversão Instalação da aplicação não deve ser utilizada nesta integração. Deve criar uma nova ação de conversão para a sua instalação Web to App utilizando uma das acções de conversão Conversões offline.
  1. Ao lado da ação de conversão que acabou de ser adicionada, clique em Definições
  2. Altere o nome da sua ação de conversão para o nome da ação de conversão desejada e actualize as definições da ação de conversão para se alinharem com os objectivos de medição e otimização desejados para este evento. Em seguida, clique em Salvar.
  3. Clique em Salvar e continuar
  4. Clique em Concluir
  5. Agora você deve ver sua ação de conversão na tela Resumo. A Origem da conversão deve ser"Website (Importar de cliques)". É normal que o estado seja Inativo até ter concluído a configuração completa e o Singular começar a enviar eventos atribuídos ao Google.
  6. Clique na ação de conversão e, em seguida, copie o valor ctld da barra de endereços do browser
  7. Adicione o valor ctld à configuração do parceiro de eventos Web do Singular Google Ads
Que dados é que o Singular envia através da API de conversões offline?
Parâmetro Detalhes
gclid, gbraid (coming soon), wbraid (coming soon)
  • Passado automaticamente
hashed email
  • Opcional
  • O correio eletrónico comhash pode ser transmitido como um atributo de evento instrumentado Singular"ehash"
  • O valor do correio eletrónico com hash tem de ser normalizado e com hash SHA 256
hashed phone number
  • Opcional
  • O número de telefone com hash pode ser transmitido como um atributo de evento instrumentado Singular"phashE164"
  • O número de telefone com hash deve ser E164 normalizado e com hash SHA 256
Os postbacks estão a falhar por"USER_PERMISSION_DENIED"

Este erro ocorre se o utilizador autorizado não tiver permissões para a conta MCC configurada.

Para o corrigir, aceda à sua conta do Google Ads e certifique-se de que o seu utilizador autorizado no Singular tem permissões totais para a conta MCC configurada.

Os postbacks estão falhando em"CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS"

Este erro acontece se não concordar com os termos de processamento de conversões melhoradas da Google.

Para corrigi-lo, aceda à sua conta do Google Ads, introduza Definições no menu lateral, escolha em"Objectivos" o ecrã"Conversões" e active as Conversões melhoradas para leads, conforme apresentado abaixo:

Para obter mais detalhes, consulte a documentação do Google Ads aqui.

Quais são as limitações da API de conversões offline do Google Ads?
  • Suporta apenas conversões por clique
  • Não há suporte para modelagem
Os eventos móveis são suportados na API de conversões offline do Google Ads?
  • Os postbacks do Google OCI só devem ser configurados para que os sites de aplicativos móveis enviem eventos de aplicativos ao usar o fluxo de atribuição Mobile Web to App da Singular (ou seja, clique em anúncio do Google → Landing Page de propriedade do anunciante com Singular Web SDK → Singular Mobile Web to App clique → Instalar)
  • Se um fluxo de clique direto no anúncio para a loja for aproveitado nas suas campanhas Web do Google (ou seja, clique no anúncio do Google → loja de aplicações), utilize a integração Web do Google Ads
  • Essa integração não deve ser usada para campanhas padrão de instalação de aplicativos móveis e retargeting. Utilize a Integração de campanhas de aplicações para telemóvel do Google Ads para campanhas para telemóvel.