Comece agora

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 app

Edite 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:

  1. 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.

    1. 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.
    2. 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.
  2. 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.

  3. Tente solicitar o mesmo relatório pelo aplicativo.
  4. É 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 para reports.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
  5. 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.