Qual deve ser o escopo do meu relatório?
Na maioria dos relatórios, recomendamos definir
Reports.reportScope
como um anunciante ou conta de mecanismo específica. Para relatórios muito grandes, como relatórios de palavras-chave, relatórios de conversão ou relatórios bem segmentados, recomendamos limitar o escopo a uma conta de mecanismo específica. A API pode retornar erros para relatórios com mais de
10 milhões de linhas.
Por que estou recebendo um erro "Proibido" (403)?
Provavelmente, você precisará conseguir um token OAuth de atualização.
Como encontro IDs de agências e anunciantes?
Se você ainda não tiver os IDs das agências e dos anunciantes que tem permissão para visualizar, solicite um relatório advertiser
com as colunas agencyId
e advertiserId
, mas não especifique reportScope
.
O Search Ads 360 retornará uma lista de todos os IDs de agências e anunciantes que sua
Conta do Google tem permissão para visualizar.
Veja um exemplo de solicitação:
POST https://www.googleapis.com/doubleclicksearch/v2/reports/generate Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "reportType": "advertiser", "columns": [ { "columnName": "agency" }, { "columnName": "agencyId" }, { "columnName": "advertiser" }, { "columnName": "advertiserId" } ], "statisticsCurrency": "usd" }
Quando os dados dos relatórios são atualizados?
Algumas métricas são mais atualizadas que outras. Para mais detalhes, consulte qual é a atualização dos dados dos relatórios no Search Ads 360?
Para garantir que seus relatórios tenham todas as métricas disponíveis, recomendamos aguardar cerca de quatro
horas após a meia-noite (fuso horário da conta de mecanismo) antes de solicitar relatórios das métricas
de ontem. Para o relatório conversion
, recomendamos esperar
12 horas após a meia-noite (fuso horário do anunciante do Campaign Manager). Se você usar a API para fazer o upload dos dados de conversão, consulte insert.operation para ver detalhes sobre a disponibilidade dos dados enviados.
Mesmo depois de vários dias, uma métrica ainda pode mudar porque os filtros de spam do mecanismo ou as conversões off-line são enviadas pela API. Para fazer o download dessas mudanças de forma incremental, solicite relatórios sobre os dados que foram alterados desde o último download. Se você fizer o download de alterações incrementais, recomendamos solicitar um relatório completo de tempos em tempos. Por exemplo, é possível fazer o download de mudanças incrementais em intervalos de alguns dias e solicitar um relatório completo uma vez por mês.
Quando as mudanças nos atributos vão aparecer nos relatórios?
Leva cerca de um minuto para que as alterações de atributos feitas no Search Ads 360 apareçam nos relatórios transferidos por download pela API. As alterações feitas diretamente no mecanismo externo (não por meio do Search Ads 360) precisam ser importadas para o Search Ads 360 primeiro com a sincronização de entrada.
Recomendamos retornar apenas os dados que foram alterados para determinar quais entidades tiveram alterações de atributos.
O que são palavras-chave e anúncios não atribuídos?
Às vezes, o Search Ads 360 não consegue atribuir métricas a um anúncio específico. Por exemplo, um anúncio com um formato não compatível ou um URL do servidor de cliques com um erro pode impedir que o Search Ads 360 atribua métricas a um anúncio. Para cada grupo de anúncios, o Search Ads 360 informa qualquer métrica não atribuída como pertencente a um "anúncio não atribuído". Para solicitar essas métricas em um relatório, defina includeRemovedEntities
como true
. Para facilitar a identificação de anúncios não atribuídos, inclua a coluna isUnattributedAd
na solicitação.
Da mesma forma, às vezes o Search Ads 360 não consegue atribuir métricas a uma palavra-chave específica.
Isso acontece quando surgem discrepâncias nos relatórios. Nesses casos, a coluna keywordId
para palavras-chave não atribuídas é definida como 0.
Os relatórios incluem conversões ajustadas?
Em alguns casos, as conversões são difíceis de medir, como quando os cookies do site que armazenam informações sobre os cliques no anúncio não estão disponíveis devido a fatores como as configurações do navegador. Nesses casos, o Floodlight usa uma escala para explicar os dados de conversão que não podem ser medidos diretamente. Ou seja, o Floodlight aplica o aprendizado de máquina aos dados históricos para modelar o número de conversões e o valor da receita de conversão que não pode ser medido. O Floodlight pode adicionar a estimativa resultante às métricas de conversão para oferecer uma visão mais completa de como sua publicidade gera conversões.
O Floodlight sempre aplica o dimensionamento às seguintes colunas de relatórios:
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- Colunas salvas que informam sobre as atividades do Floodlight
O relatório conversion
não inclui conversões ajustadas. Ela mostra apenas as conversões que foram medidas
diretamente. O número de conversões e o valor da receita em um relatório conversion
não correspondem às conversões e à receita informadas nas colunas acima.
Por que as conversões brutas não são somadas à métrica agregada X?
Se as métricas agregadas discordarem dos eventos brutos no Search Ads 360, confie na métrica agregada. Ao calcular agregações de métricas, o Search Ads 360 tenta limpar as fontes de dados removendo as conversões suspeitas de serem duplicadas.
E se minha pergunta não foi respondida aqui?
Se houver um problema que você não consegue resolver depois de ler os recursos neste site, entre em contato com o suporte e tenha as seguintes informações:
ID da agência e do anunciante do Search Ads 360 que você está tentando acessar
Número do projeto do Console de APIs do Google
O nome de usuário da Conta do Google que você está usando para acessar a API.
Essa é a conta que recebeu permissão para acessar o Search Ads 360, que é a mesma usada para configurar a autorização.Snippet de código da sua solicitação
Resposta JSON
Se a resposta for um erro, inclua a mensagem de erro, não apenas o código numérico do erro.