A API AdSense Management tem chamadas para gerar relatórios novos e salvos. Eles podem conter análises simples, como ganhos por dia, ou tabelas muito complexas de taxas de cliques por canal personalizado e por país. Este guia apresenta uma lista de casos extremos que precisam ser processados corretamente para uma integração robusta com as APIs.
Estrutura do relatório
Os resultados do relatório são retornados como um objeto ReportResult. Consulte a referência de respostas do relatório para ver os detalhes completos.
Como usar dimensões cronológicas: DATE, WEEK e MONTH
Os relatórios podem estar vazios ou ter lacunas
Se não houver atividade durante o período especificado na solicitação, nenhuma solicitação de anúncio será gerada, e o serviço de relatórios não mostrará linhas para esses períodos. Isso será importante se você estiver, por exemplo, traçando um gráfico.
Consulte o guia Como preencher datas para mais informações.
Como solicitar as dimensões MONTH e WEEK no mesmo relatório
Esse relatório pode ter consequências negativas ou inesperadas. Se uma semana pertencer a dois meses diferentes, serão mostradas duas linhas para a mesma semana, uma para cada mês.
Exemplo
| Dimensões | Métricas | Data de início | Data de término |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Retorna:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* primeiro dia da semana
Solução
Remova MONTH do relatório.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Agrupar valores de dimensão
Ao solicitar dimensões como as relacionadas a, por exemplo, plataformas (computadores, dispositivos móveis de última geração etc.), somente as plataformas com atividade são mostradas. Se um determinado dia, semana ou mês não tiver visitas de dispositivos móveis de última geração, ele não terá informações para essa categoria.
Exemplo
| Dimensões | Métricas | Data de início | Data de término |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Retorna:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Computador | 100 |
| 2014-03 | Dispositivos móveis de última geração | 5 |
| 2014-04 | Computador | 75 |
Solução
Ao processar os resultados do relatório, presuma um valor de zero para todos os valores de dimensão que não aparecerem nos resultados:
| MONTH | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Computador | 100 |
| 2014-03 | Dispositivos móveis de última geração | 5 |
| 2014-04 | Computador | 75 |
| 2014-04 | Dispositivos móveis de última geração | 0 |
Combinar vários relatórios contíguos
Às vezes, um relatório é muito grande para ser gerado de uma só vez e precisa ser em lote. Se o app faz isso, considere estes casos:
- Se você estiver usando as dimensões
WEEKouMONTHe estiver dividindo o relatório no meio de uma semana ou um mês, cada relatório terá entradas duplicadas com dados diferentes. - Verifique se todos os relatórios têm as mesmas métricas e dimensões, porque os dados não podem ser combinados usando dimensões diferentes.
Contas especiais
Alguns dos seus usuários podem ter contas do Google AdSense com atributos que você não espera ou conhece. Não se esqueça de levar em conta:
- Editores com milhares de domínios ou sites
- Editores com milhares de blocos de anúncios ou canais personalizados
- Editores que querem gerar relatórios sobre vários clientes de anúncios (AdSense para pesquisas, AdSense para vídeos etc.)
Várias contas
Os usuários podem ter acesso a mais de uma conta do Google AdSense. É necessário especificar um ID de conta para cada chamada à API por esse motivo. Uma chamada para
accounts.list busca uma lista de contas, e uma caixa de diálogo de seletor
de conta é exibida ao usuário. Ela poderá ser ignorada se o número de
contas buscadas for um.
Alterações de fuso horário
Os editores do Google AdSense podem alterar o fuso horário a qualquer momento, e isso pode produzir picos ou quedas nos relatórios. Leia o guia sobre Relatórios no fuso horário local para mais informações.