Perguntas frequentes

Há alguma restrição sobre o que posso enviar?

Há algumas restrições que você precisa conhecer:

  • As solicitações individuais de batchinsert e batchupdate são limitadas a 1.000 conversões.
  • O carimbo de data/hora de uma conversão pode ter no máximo 28 dias a partir do momento do envio.
  • Só é possível enviar conversões para uma configuração do Floodlight que seu perfil de usuário do Campaign Manager 360 possa acessar.
Devo usar o Campaign Manager 360 ou o Search Ads 360 para fazer upload de conversões?

Consulte a Central de Ajuda do Search Ads 360 para uma comparação detalhada dos recursos oferecidos pelos dois produtos.

E se eu inserir a mesma conversão no Campaign Manager 360 e no Search Ads 360?

Se você inserir a mesma conversão no Campaign Manager 360 e no Search Ads 360, as entradas não serão deduplicadas. Nesse caso, use atividades do Floodlight separadas.

Qual API devo usar para fazer upload de conversões off-line?

Recomendamos usar a API Data Manager para melhorar a experiência do desenvolvedor e ter acesso a mais recursos.

O que é um valor ordinal e como ele é usado?

Os valores ordinais controlam como as conversões duplicadas são processadas. Se várias conversões forem inseridas com a mesma atividade do Floodlight, ID de configuração do Floodlight, identificador de usuário e carimbo de data/hora da conversão, o ordinal será usado para determinar se:

  • As conversões são deduplicadas, e apenas uma é mantida. Isso acontece se todas as conversões tiverem o mesmo valor ordinal.
  • As conversões são processadas individualmente e todas sobrevivem. Isso acontece se todas as conversões tiverem um valor ordinal diferente.

Os valores em si não precisam ser significativos. Em geral, usar um valor fixo (como 1) para todas as conversões vai ativar a eliminação de duplicação. Usar um valor aleatório ou único para cada conversão vai desativar essa opção.

Como devo lidar com erros na resposta da API e quais erros devo tentar novamente?

batchinsert e batchupdate processam conversões com base no melhor esforço: uma solicitação em lote pode retornar uma resposta HTTP 200 OK, enquanto as conversões individuais no lote falham. Sempre verifique hasFailures na resposta e inspecione a lista errors[] em cada objeto ConversionStatus:

  • INTERNAL (tentar novamente): ocorreu um erro temporário nos sistemas do Google durante o processamento da conversão. A conversão não foi inserida ou atualizada. Tente novamente as conversões com falha usando a espera exponencial (por exemplo, começando após alguns minutos e tentando novamente ao longo de várias horas), mantendo exatamente os mesmos ordinal, timestampMicros, floodlightActivityId e identificador de usuário ou de clique.
  • NOT_FOUND (tentar novamente com atraso): o identificador (gclid, dclid, matchId ou mobileDeviceId) ou a conversão que está sendo editada ainda não foi encontrada. Como os cliques on-line, as tags do Floodlight e as conversões podem levar de 1 a 2 horas para serem processados e indexados, tente novamente as conversões de NOT_FOUND periodicamente (por exemplo, a cada 1 a 3 horas, por até 6 horas). Se o NOT_FOUND persistir após seis horas, consulte as seções a seguir para ver as causas comuns por tipo de identificador.
  • INVALID_ARGUMENT e PERMISSION_DENIED (não tente novamente): os dados de conversão são inválidos (por exemplo, um carimbo de data/hora de conversão com mais de 28 dias ou um campo malformado) ou seu perfil de usuário não tem permissão para a configuração de destino do Floodlight. Não tente fazer essas conversões novamente sem corrigir o problema.

Se toda a solicitação HTTP falhar com um erro de servidor 5xx ou de cota/limite de taxa 429, tente novamente usando a espera exponencial.

Novas tentativas seguras e eliminação de duplicação: ao tentar novamente uma conversão que falhou com INTERNAL ou NOT_FOUND (ou após um tempo limite HTTP 5xx em que o resultado é desconhecido), sempre envie exatamente os mesmos ordinal e timestampMicros. Se uma conversão já tiver sido registrada, o Campaign Manager 360 vai eliminar a duplicação automaticamente com base no ordinal, no identificador de usuário, na atividade do Floodlight e na data de conversão.

O que significa quando um upload do mobileDeviceId falha devido a um erro NOT_FOUND?

As causas mais comuns desse erro são:

  • O mobileDeviceId é inválido.
  • O mobileDeviceId é desconhecido para o Search Ads 360. Isso significa que o dispositivo ainda não recebeu um anúncio do Campaign Manager 360.
O que significa quando um upload do gclid falha devido a um erro NOT_FOUND?

As causas mais comuns desse erro são:

  • O gclid é inválido.
  • O gclid não está associado a uma campanha do Search Ads 360 ou a um item de linha do YouTube do Display & Video 360. Isso pode ocorrer se o gclid foi coletado de um redirecionamento de clique do Google Ads que não passou pelo Search Ads 360 (por exemplo, cliques em extensões de local) ou de um redirecionamento de clique em anúncio do YouTube não associado a um item de linha do YouTube do Display & Video 360.
  • O clique associado ao gclid ocorreu há muito tempo. As conversões só podem ser inseridas para cliques com até 60 dias.
  • O clique associado ao gclid ocorreu há pouco tempo. Recomendamos atrasar os uploads de conversões com base em gclid em uma hora para garantir que o gclid seja processado e esteja disponível para correspondência.
O que significa quando um upload do dclid falha devido a um erro NOT_FOUND?

As causas mais comuns desse erro são:

  • O dclid é inválido.
  • O clique associado ao dclid ocorreu há muito tempo. As conversões só podem ser inseridas para cliques com até 60 dias.
  • O clique associado ao dclid ocorreu há pouco tempo. Recomendamos atrasar os uploads de conversão com base em dclid em uma hora para garantir que o dclid seja processado e esteja disponível para correspondência.
O que significa quando um upload do matchId falha devido a um erro NOT_FOUND?

As causas mais comuns desse erro são:

  • O matchId é desconhecido para o Campaign Manager 360. Isso pode ocorrer se o matchId foi coletado de uma chamada do Floodlight que não passou corretamente pelo Campaign Manager 360. Verifique se as chamadas do Floodlight estão funcionando corretamente, incluindo o parâmetro de tag matchId.
  • A chamada do Floodlight associada ao matchId não continha um cookie. A chamada do Floodlight precisa conter um cookie / identificador para que o Campaign Manager 360 armazene o matchId corretamente (por exemplo, o usuário pode ter bloqueado cookies ou desativado a opção).
  • A chamada do Floodlight associada ao matchId ocorreu há muito tempo. Os uploads de conversões off-line precisam ser feitos em até 60 dias após a chamada do Floodlight que contém o matchId.
  • A chamada do Floodlight associada ao matchId ocorreu há pouco tempo. Recomendamos atrasar os uploads de conversão com base em matchId em duas horas para garantir que o matchId seja processado e esteja disponível para correspondência.
As conversões off-line com um carimbo de data/hora anterior à criação da atividade do Floodlight são incluídas nos relatórios?

O upload de conversões off-line com um carimbo de data/hora anterior à criação da atividade do Floodlight pode ser informado como impressões do Floodlight e como conversões não atribuídas/atribuídas, até 28 dias antes do momento do envio. No entanto, esse comportamento não é garantido e não é confiável. A prática recomendada é criar atividades do Floodlight antes do carimbo de data/hora mais antigo de uma conversão off-line.

Qual consentimento é necessário para usar a inserção de conversões off-line na criação de listas de público-alvo?

Além do consentimento de dados do usuário de anúncios, o campo nonPersonalizedAd precisa ser definido explicitamente como false para permitir a criação de listas de público-alvo.