Este documento é para desenvolvedores que querem usar a API AdSense Management para receber informações sobre a conta do Google AdSense. Este documento pressupõe que você esteja familiarizado com os conceitos de programação e formatos de dados da Web.
Antes de começar
Criar uma conta do Google AdSense
Inscreva-se ou faça login na sua conta do Google AdSense para começar.
Familiarize-se com o Google AdSense
Se você não conhece bem os conceitos do Google AdSense, leia as informações introdutórias sobre o Google AdSense e teste a interface do Google AdSense antes de começar a programar.
Escolha sua biblioteca de cliente
Na página Bibliotecas de cliente e amostras, você encontrará informações sobre as bibliotecas e amostras disponíveis. Clique na guia do idioma escolhido e siga os links para fazer o download da origem. As bibliotecas de cliente cuidam do seguinte:
- authentication
- descoberta de serviços
- criação de solicitações para a API
- análise de resposta
Leia as instruções para instalar e configurar a biblioteca de cliente escolhida, normalmente encontrada no arquivo README no diretório raiz do repositório.
Se a implementação tiver necessidades especiais, como usar uma linguagem não compatível, faça solicitações diretas à API em vez de usar uma biblioteca de cliente.
Registre seu aplicativo
Para usar a API AdSense Management, é necessário registrar o aplicativo que você está desenvolvendo. Para isso, crie um projeto e gere um ID do cliente.
Registrar o appEdite os arquivos de configuração do projeto de biblioteca de cliente com as novas credenciais que você acabou de criar. Verifique a documentação da biblioteca de cliente para mais detalhes.
Observação:a Conta do Google usada para registro precisa ser sua conta de desenvolvedor, ou seja, a conta que você quer que os usuários do seu aplicativo vejam como o desenvolvedor do aplicativo. Essa conta não precisa estar vinculada a um login do Google AdSense, porque os usuários concedem acesso às próprias contas ao usar o aplicativo.
Tutorial de início rápido
Siga as etapas abaixo para fazer as primeiras solicitações. Elas podem variar um pouco dependendo da biblioteca ou do idioma que você está usando:
- Use o exemplo apropriado para recuperar uma lista de clientes de anúncios de uma conta do Google AdSense. Essa solicitação inicia um processo único em que o
usuário do Google AdSense autentica e autoriza seu projeto.
Os clientes de anúncios representam uma associação entre uma conta do Google AdSense e um produto do Google AdSense, como anúncios de conteúdo ou de pesquisa. Uma conta do Google AdSense pode ter um ou vários clientes de anúncio.
- Para aplicativos da Web, os usuários serão redirecionados para um site em que poderão optar por conceder acesso. Depois de autorizado, ele será redirecionado para o URL de callback definido no console de APIs.
- Os aplicativos instalados funcionam de maneira semelhante. A biblioteca de cliente tentará abrir uma janela do navegador e usar um código de autorização. Para apps Android, Chrome e iOS, esse método é específico da plataforma.
- Use o
API Explorer da
reports.generate
se quiser solicitar o seguinte relatório:date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
Os relatórios oferecem informações sobre seus ganhos, bem como o que afeta esses ganhos. Eles podem ser gerados em uma conta inteira ou em um subconjunto de blocos de anúncios por meio do uso de canais.
- Tente solicitar o mesmo relatório pelo aplicativo.
- É possível filtrar os relatórios por blocos de anúncios. Busque a lista de blocos de anúncios usando
adunits.list
. É necessário um ID do cliente de anúncios (consulte a etapa 1). Depois de escolher um bloco de anúncios, use o ID dele no parâmetro filter parareports.generate
:Os blocos de anúncios são marcadores de posição para anúncios configurados pelo usuário, que definem algumas propriedades dos anúncios exibidos (como tamanho e forma).
date_range: YESTERDAY
dimensions: DATE
metrics: ESTIMATED_EARNINGS
filter: AD_UNIT_ID==ca-pub-123456789:987654321
- Filtre por critérios personalizados ou de URL ou misture vários filtros.
Canais são ferramentas que permitem acompanhar o desempenho de um subconjunto dos seus blocos de anúncios. Há dois tipos de canais: de URL e personalizados. O primeiro permite que você acompanhe o desempenho em uma página ou domínio específico, enquanto o segundo ajuda a acompanhar o desempenho em grupos de blocos de anúncios específicos selecionados pelo usuário.
Você está pronto para iniciar sua implementação explorando o restante das chamadas e recursos disponíveis na documentação de referência.