Qual deve ser o escopo do meu relatório?
Para a maioria dos relatórios, recomendamos que você defina
Reports.reportScope
a uma conta de mecanismo ou anunciante específico. Para modelos muito grandes
relatórios de palavras-chave, de conversão ou
relatórios bem segmentados. Recomendamos limitar o escopo a um
conta de mecanismo específica. A API pode retornar erros para relatórios maiores do que
10 milhões de linhas.
Por que estou recebendo um erro Proibido (403)?
Provavelmente, você precisa receber um token OAuth de atualização.
Como faço para encontrar os IDs de agências e anunciantes?
Se você ainda não tem os IDs das agências e dos anunciantes que tem
permissão de visualização, solicite uma
advertiser
com as colunas agencyId e advertiserId,
mas não especifique o reportScope.
O Search Ads 360 retornará uma lista de todos os IDs de agências e anunciantes que seus
A Conta do Google tem permissão para ver.
Aqui está 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 recentes que outras. Para mais detalhes, confira quando são atualizados os dados dos relatórios no Search Ads 360?
Para garantir que seus relatórios contenham 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 do
metrics; para o relatório de conversion, recomendamos aguardar
12 horas após a meia-noite (fuso horário do anunciante do Campaign Manager). Se você usa a API para fazer o upload de dados de conversão, consulte
insert.operation
para detalhes sobre a disponibilidade dos dados enviados.
Mesmo depois de vários dias, uma métrica ainda pode mudar devido a filtros de spam do mecanismo ou off-line conversões sendo enviadas pela API. Para fazer o download incremental desses arquivos, alterações, solicitar relatórios com base nos dados que foram alterados desde o último download. Se você fizer o download alterações, recomendamos que você solicite um relatório completo de vez em quando. Por exemplo: poderá fazer o download de alterações incrementais em intervalos de alguns dias e solicitar um relatório completo uma vez por mês.
Quando as mudanças de atributos vão aparecer nos relatórios?
Leva cerca de um minuto para que as mudanças de atributos feitas por alguém no Search Ads 360 apareçam que podem ser baixados por meio da API. As alterações feitas diretamente no mecanismo externo (não pelo Search Ads 360) precisarão ser importadas para o Search Ads 360 primeiro usando a sincronização de entrada.
Recomendamos que você retorne somente os dados que foram alterados para determinar quais entidades têm alterações de atributos.
O que são anúncios e palavras-chave 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
formato incompatível ou um URL do servidor de cliques com erro pode impedir que o Search Ads 360 atribua
a um anúncio. Para cada grupo de anúncios, o Search Ads 360 informa todas as métricas não atribuídas como pertencentes
um "anúncio não atribuído". Para solicitar essas métricas em um relatório, defina
includeRemovedEntities
para true. Para facilitar a visualização de quais anúncios não estão atribuídos, inclua o parâmetro
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, os
A coluna keywordId para palavras-chave não atribuídas é definida como 0.
Os relatórios incluem conversões em escala?
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 nos anúncios não estão disponíveis devido a fatores que incluem as configurações do navegador. Nesses casos, o Floodlight usa uma escala para explicar os dados de conversão que não podem ser medidas diretamente. Ou seja, o Floodlight aplica o aprendizado de máquina aos dados históricos para modelar a o número de conversões e o valor da receita de conversão que não podem ser medidos. O Floodlight pode e, em seguida, adicionar a estimativa resultante às métricas de conversão para fornecer uma imagem mais completa da como sua publicidade gera conversões.
O Floodlight sempre aplica a escala às seguintes colunas de relatórios:
- dfaActions
- dfaRevenue
- dfaTransactions
- dfaWeightedActions
- Colunas salvas que gerar relatórios sobre atividades do Floodlight
O conversion
não inclui conversões em escala. Ela só mostra as conversões que foram medidas.
diretamente. O número de conversões e o valor da receita em um relatório de conversion
não devem corresponder às conversões e à receita informadas nas colunas listadas acima.
Por que as conversões brutas não se somam à métrica agregada X?
Caso as métricas agregadas não concordem com os eventos brutos no Search Ads 360, confie no métrica agregada. Ao calcular as agregações de métricas, o Search Ads 360 tenta limpar os dados de origem ao remover as conversões suspeitas de serem duplicadas.
E se minha pergunta não for respondida aqui?
Se houver um problema que você não possa resolver depois de ler os recursos deste site, entre em contato com o suporte e solicite 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 foi fornecida permissão para acessar o Search Ads 360, que é a mesma conta que você usa para configure a autorização.Snippet de código da solicitação
Resposta JSON
Se a resposta for um erro, certifique-se de incluir a mensagem de erro, não apenas o código de erro numérico.