Lista de verificação para iniciantes do desenvolvedor do Google Ads

Esta lista de verificação mostra como começar a usar a Google Ads API. As etapas estão divididas em várias categorias, algumas das quais você pode decidir ignorar se não se aplicarem às suas necessidades. Para aproveitar este documento ao máximo, leia e execute as etapas em ordem.

A lista contém três tipos de itens:

O que fazer:são etapas necessárias para realizar uma determinada tarefa ou configurar uma parte específica da sua ferramenta.

Se você estiver imprimindo a lista de verificação, use as caixas de seleção à esquerda para marcar as etapas que foram concluídas. Esta lista de verificação apresenta uma ordem de leitura recomendada para as informações encontradas nos documentos da Google Ads API.

Acesso e configuração

Receba o token de desenvolvedor na Central de API da sua conta de administrador de nível superior. Todos os campos do formulário de acesso à API precisam ser preenchidos, e os Termos e Condições precisam ser aceitos. Verifique se o e-mail de contato da API fornecido leva a uma caixa de entrada monitorada regularmente. Você receberá um token de desenvolvedor com o nível de acesso à conta de teste.

Para que seu token seja aprovado para o acesso de produção, preencha nosso formulário de inscrição de acompanhamento e explique como você pretende usar a API.

Você também precisará fornecer um documento de design. Use nosso modelo para começar. Forneça o máximo de detalhes possível.

Nossa equipe de revisão de token entrará em contato se precisar de mais informações. Se você não receber um feedback em até dois dias úteis, use nosso formulário de contato.

Configurar uma biblioteca de cliente

Usamos o OAuth 2.0 para autenticar suas solicitações na API. Siga as instruções no guia do OAuth 2.0 para configurar as credenciais do OAuth 2.0. Para solucionar problemas, você pode usar o OAuth 2.0 Playground.
Fornecemos bibliotecas de cliente para algumas linguagens de programação comuns. Faça o download da biblioteca da linguagem que você quer usar e configure o arquivo de configuração com as credenciais recebidas anteriormente.

Token de desenvolvedor: níveis de acesso

Leia sobre Níveis de acesso e decida se a ferramenta vai exigir mais de 15.000 operações por dia em algum momento no futuro. Caso necessário, você precisará solicitar o acesso padrão para operações mutate ilimitadas e solicitações GoogleAdsService.Search e GoogleAdsService.SearchStream por dia. No entanto, isso ainda está sujeito ao limite diário de 1.000 operações get.
Leia a planilha de tarifas para entender como as operações são calculadas para seu nível de acesso. Observe que as solicitações GoogleAdsService.Search com o campo page_token definido não contam para o limite de operações.

Recursos mínimos obrigatórios (RMF, na sigla em inglês)

Leia sobre os Recursos mínimos obrigatórios (RMF, na sigla em inglês), que são um conjunto de funções que sua ferramenta precisa implementar, com base na natureza da ferramenta.
Leia sobre as taxas de não conformidade para entender o que acontece quando os RMFs não são implementados corretamente.
Verifique se sua ferramenta implementa os RMFs aplicáveis.
Inscreva-se para ter acesso padrão.

Começar a trabalhar com a API

Leia o artigo Como fazer sua primeira chamada de API, que explica como receber campanhas usando a API. Todos os objetos podem ser acessados de maneira semelhante, então vale a pena memorizar a estrutura.
Entenda a estrutura básica da API de recursos e serviços.
Confira Como alterar e inspecionar objetos e Como recuperar objetos.
Leia sobre Metadados de recursos para entender como solicitá-los dinamicamente.
Leia Visão geral de campanhas para criar e gerenciar vários tipos de campanha e anúncio.

Exemplos de código

Operações básicas > Acessar campanhas
Operações básicas > Acessar anúncios de texto expandidos
Operações básicas > Adicionar campanhas
Operações básicas > Adicionar palavras-chave
Operações básicas > Atualizar palavra-chave
Gerenciamento de campanhas > Receber todos os anúncios reprovados
Gerenciamento de campanhas > Adicionar modificador de lance da campanha
Gerenciamento de contas > Ver informações da conta
Gerenciamento de conta > Criar cliente
Gerenciamento de contas > Receber alterações da conta

Relatórios

Confira uma visão geral rápida dos relatórios e um exemplo para resumir a performance de uma conta nos últimos 30 dias usando GoogleAdsService como a única fonte de informações nos relatórios do Google Ads.
Leia a Linguagem de consulta do Google Ads (GAQL, na sigla em inglês) para entender a gramática, a estrutura e os conceitos de recursos, segmentos e métricas.
Leia sobre Métricas de critérios para entender como recuperar dados de desempenho de diferentes critérios com recursos *_view, por exemplo, KeywordView, TopicView e GenderView.

Criador de consultas interativo do Google Ads

Use o editor nessa ferramenta para criar uma instrução da linguagem de consulta do Google Ads para um recurso específico, por exemplo, um grupo de anúncios. Copie e cole a instrução GAQL gerada no seu aplicativo.

Pesquisa de palavras-chave

Se você não conhece a nossa ferramenta Planejador de palavras-chave, faça um teste para saber como o planejamento de palavras-chave funciona na interface do Google Ads.

Exemplos de código

Amostras de planejamento -> Gerar métricas de previsão
Exemplos de planejamento -> Gerar ideias de palavras-chave

Automatize os orçamentos

Leia sobre Formas de pagamento e configurações para entender as opções de faturamento disponíveis no Google Ads, como pagamentos automáticos, pagamentos manuais e faturamento mensal (limite de crédito).
Confira a Configuração de faturamento para entender como gerenciar perfis e contas para pagamentos de maneira programática.
Leia sobre o Orçamento da conta para entender como os orçamentos podem ser atribuídos automaticamente às contas.
Entre em contato com seu representante comercial no Google para se inscrever no faturamento mensal.
Entre em contato com seu representante comercial no Google para solicitar acesso ao AccountBudgetProposalService .
Crie um AccountBudgetProposal e o atribua a uma conta. Tente usar o orçamento com um orçamento da campanha.

Anúncios do Shopping

Configure uma conta do Merchant Center e receba um MerchantID.
Consiga uma chave de conta de serviço se o aplicativo só precisa de acesso à sua própria conta do Merchant Center. No entanto, se você estiver criando um aplicativo de terceiros que precisa de acesso às contas do Merchant Center dos seus clientes, consulte o guia Autorizar solicitações com o OAuth 2.0.
Faça o download de uma biblioteca de cliente para a linguagem da sua preferência.
Veja os exemplos de código da API Content para Java, .NET, PHP, Python e assim por diante.
Saiba como vincular manualmente contas do Merchant Center e do Google Ads.
Saiba como configurar sua lista de produtos usando a API Content.
Confira o guia Como criar uma campanha do Shopping usando a Google Ads API.

Recomendações e alterar status

Se você não conhece os recursos das Recomendações e do Histórico de alterações, teste na IU do Google Ads.

RecommendationService

Leia nosso guia sobre como usar o RecommendationService para recuperar e aplicar as recomendações do Google à sua conta e aumentar o desempenho geral dos anúncios.
Descubra as funcionalidades de recomendação executando este exemplo de código: Exemplos de recomendação -> Como obter recomendações de anúncios de texto.

ChangeStatusService

Leia nosso guia sobre como usar o ChangeStatusService para recuperar o histórico de alterações e acompanhar as alterações na sua conta, como campanhas e anúncios.
Descubra as funcionalidades do histórico de alterações executando este exemplo de código: Exemplos de ChangeStatus -> Receber alterações da conta.

Manter-se atualizado

Controle de versões

Quando uma nova API for lançada, consiga a versão mais recente da nossa biblioteca de cliente.
Adicione as notas da versão aos favoritos como favoritos e analise as principais mudanças em cada versão.
Substitua as chamadas para a versão antiga da biblioteca de cliente por chamadas para a nova versão.
Siga este blog para se inscrever no nosso feed RSS e receber postagens do blog por e-mail e consulte o fórum para conferir as informações mais recentes sobre a API Google Ads.
Verifique se o e-mail de contato da API registrado na Central de API da sua conta de administrador principal está atualizado. Dessa forma, entraremos em contato com você se encontrarmos problemas técnicos relacionados ao seu uso da API.
Google Merchant Center O Google Merchant Center ajuda você a fazer o upload dos dados da sua loja e dos seus produtos para o Google e a disponibilizá-los para anúncios do Shopping e outros Serviços do Google.
Perfil da Empresa O Perfil da Empresa ajuda você a alcançar e interagir com clientes locais na Pesquisa Google e no Maps.
Google Analytics O Google Analytics oferece relatórios detalhados sobre como as pessoas usam seu site. Você pode usar o Google Analytics para saber o que as pessoas fazem depois de clicar nos seus anúncios.
Gerenciador de tags do Google O Gerenciador de tags do Google é um sistema de gerenciamento de tags (TMS, na sigla em inglês) que permite atualizar de maneira rápida e fácil códigos de acompanhamento e fragmentos de códigos relacionados (conhecidos coletivamente como tags) no seu site ou app para dispositivos móveis.
Google Optimize O Google Optimize oferece ferramentas de teste A/B, testes de sites e personalização para pequenas empresas que ajudam a oferecer experiências envolventes aos clientes.
Google Data Studio O Data Studio transforma os dados em painéis e relatórios informativos totalmente personalizáveis que são fáceis de ler e compartilhar.

Receber ajuda

Adicione aos guias da API Google Ads um favorito. A maioria dos conceitos básicos é explicada ali.
Adicione a referência da API Google Ads aos favoritos. Todas as funcionalidades da API são explicadas em detalhes lá.
Adicione um favorito à página de suporte da Google Ads API, que explica os principais canais de suporte.
Confira o canal do YouTube Google Ads Developers.
Entre em contato com seu representante comercial / gerente de parcerias no Google para marcar uma reunião para abordar questões estratégicas mais complexas relacionadas à API.