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

Esta lista de verificação vai orientar você no processo de início da API Google Ads. As etapas são divididas em várias categorias, e algumas delas podem ser ignoradas se não forem aplicáveis às suas necessidades. Para aproveitar ao máximo este documento, leia e execute as etapas na ordem.

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

Tarefa:etapas necessárias para realizar uma determinada tarefa ou configurar uma parte da ferramenta.

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

Acesso e configuração

Receba seu 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 aceitos. Verifique se o e-mail de contato da API que você fornece leva a uma caixa de entrada monitorada regularmente. Você vai receber um token de desenvolvedor com o nível de acesso à conta de teste.

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

Você também precisa enviar um documento de design. Use nosso modelo para começar. Inclua o máximo de detalhes possível.

Nossa equipe de análise de tokens vai entrar em contato se precisar de mais informações. No entanto, você também pode entrar em contato usando nosso formulário de contato se não houver feedback em dois dias úteis.

Configurar uma biblioteca de cliente

Usamos o OAuth 2.0 para autenticar suas solicitações na API. Siga as instruções no nosso guia do OAuth 2.0 para configurar as credenciais do OAuth 2.0. Para resolver problemas, use o playground do OAuth 2.0.
Oferecemos bibliotecas de cliente para algumas linguagens de programação comuns. Faça o download da biblioteca para o idioma que você quer usar e configure o arquivo de configuração com as credenciais obtidas anteriormente.

Token do desenvolvedor: níveis de acesso

Leia sobre os níveis de acesso e decida se a ferramenta vai precisar de mais de 15.000 operações por dia em algum momento no futuro. Se for o caso, 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 de busca.
Consulte a tabela de preços para entender como as operações são calculadas para seu nível de acesso. As solicitações GoogleAdsService.Search com o campo page_token definido não são contabilizadas no 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 a ferramenta precisa implementar com base na natureza dela.
Leia sobre as taxas por não conformidade para entender o que acontece quando os RMFs não são implementados corretamente.
Verifique se a ferramenta implementa os RMFs aplicáveis.
Solicite o Acesso padrão.

Começar a trabalhar com a API

Leia o artigo Como fazer sua primeira chamada de API, que explica como usar a API para criar campanhas. 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.
Consulte Como alterar e inspecionar objetos e Como recuperar objetos.
Leia sobre os metadados de recursos para entender como solicitá-los dinamicamente.
Leia Visão geral das campanhas para criar e gerenciar vários tipos de campanhas e anúncios.

Exemplos de código

Operações básicas > Receber campanhas
Operações básicas > Receber 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 lances de campanha
Gerenciamento da conta > Receber informações da conta
Gerenciamento de conta > Criar cliente
Gerenciamento da conta > Receber mudanças na conta

Relatórios

Confira uma visão geral dos relatórios e um exemplo para resumir a performance de uma conta nos últimos 30 dias usando o GoogleAdsService como a única fonte de dados para relatórios no Google Ads.
Leia a linguagem de consulta do Google Ads (GAQL) para entender a gramática e a estrutura de consultas, além dos conceitos de recurso, segmento e métricas.
Leia sobre as Métricas de critérios para entender como recuperar dados de performance 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 de 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 nossa ferramenta Planejador de palavras-chave, teste-a para saber como o planejamento de palavras-chave funciona na interface do Google Ads.

Exemplos de código

Planning Samples -> Generate Forecast Metrics
Planning Samples -> Generate Keyword Ideas

Automatizar os orçamentos

Leia sobre as formas de pagamento e configurações para entender as opções de faturamento disponíveis no Google Ads, como pagamentos automáticos, manuais e faturamento mensal (limite de crédito).
Consulte a Configuração de faturamento para saber como gerenciar perfis e contas de pagamento de forma 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 de negócios no Google para se inscrever no faturamento mensal.
Entre em contato com seu representante de negócios no Google para solicitar acesso ao AccountBudgetProposalService.
Crie uma AccountBudgetProposal e 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.
Receba uma chave de conta de serviço se o aplicativo precisar apenas de acesso à sua conta do Merchant Center. No entanto, se você estiver criando um aplicativo de terceiros que precise de acesso às contas do Merchant Center dos seus clientes, consulte o guia Autorizar solicitações com OAuth 2.0.
Faça o download de uma biblioteca de cliente para a linguagem que preferir.
Confira os exemplos de código da API Content para Java, .NET, PHP, Python e assim por diante.
Saiba como vincular manualmente as contas do Merchant Center e do Google Ads.
Saiba como configurar sua lista de produtos usando a API Content.
Consulte o guia Como criar uma campanha do Shopping usando a API Google Ads.

Recomendações e mudança de status

Se você não conhece as funcionalidades de recomendações e histórico de alterações, teste-as na interface do Google Ads.

RecommendationService

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

ChangeStatusService

Leia nosso guia sobre como usar o ChangeStatusService para extrair o histórico de alterações e acompanhar as mudanças 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 -> Get Account Changes.

Como ficar por dentro das novidades

Mantenha seu código atualizado com as mudanças na API Google Ads.

Controle de versões

Quando uma nova API for lançada, confira a versão mais recente da nossa biblioteca de cliente.
Adicione um marcador às notas da versão mais recentes e analise as principais mudanças em cada versão.
Substitua as chamadas para a versão anterior da biblioteca de cliente por chamadas para a nova versão.
Siga este blog para se inscrever no nosso feed RSS e receber as postagens por e-mail e confira o fórum para receber as informações mais recentes sobre a API Google Ads.
Verifique se o e-mail de contato da API registrado na Central de APIs da sua conta principal está atualizado. É assim que entramos em contato com você se encontrarmos algum problema técnico relacionado ao uso da API.
Google Merchant Center O Google Merchant Center ajuda você a fazer upload dos dados da loja e dos produtos para o Google, além de disponibilizar esse conteúdo 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 fornece 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 rapidamente códigos de acompanhamento e fragmentos de código relacionados (conhecidos como tags) no seu site ou app para dispositivos móveis.
Google Optimize O Google Optimize oferece ferramentas de personalização, testes A/B e testes de site para pequenas empresas, ajudando a oferecer experiências envolventes aos clientes.
Google Data Studio O Data Studio transforma seus dados em relatórios e painéis informativos, fáceis de ler e de compartilhar, e totalmente personalizáveis.

Receber ajuda

Adicione um marcador aos guias da API Google Ads. A maioria dos conceitos básicos é explicada de forma detalhada.
Adicione um marcador à referência da API Google Ads. Todas as funcionalidades da API são explicadas em detalhes.
Adicione um marcador à página de suporte da API Google Ads, que explica os principais canais de suporte.
Confira o canal do YouTube para desenvolvedores do Google Ads.
Entre em contato com seu representante de negócios / gerente de parcerias no Google para agendar uma reunião e resolver questões estratégicas mais complexas relacionadas à API.