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

Esta lista de verificação guiará você pelo processo para começar a usar o API Google Ads. As etapas estão divididas em várias categorias, algumas das quais você pode decidirá ignorar se elas não se aplicarem à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:

Pendentes:etapas que são necessárias para realizar uma determinada tarefa ou configurar uma parte específica 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 oferece uma leitura recomendada as informações 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. Tudo do formulário de acesso à API, e os Termos e Condições aceita. Verifique se o e-mail de contato da API que você fornece leva a uma caixa de entrada monitorada regularmente. Você receberá um token de desenvolvedor com a acesso à conta de teste do Google Workspace.

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. Você pode usar nosso para começar. Forneça o máximo de detalhes possível.

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

Configurar uma biblioteca de cliente

Usamos o OAuth 2.0 para autenticar suas solicitações em relação à 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.
Fornecemos bibliotecas de clientes para alguns 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 que você recebeu 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 houver, você precisará se inscrever para Acesso padrão para operações mutate ilimitadas e GoogleAdsService.Search e GoogleAdsService.SearchStream solicitações por dia. No entanto, ainda estão sujeitos ao limite diário de 1.000 operações GET.
Analise a planilha de tarifas 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), que é um conjunto de funções que sua ferramenta deve implementar com base no natureza da ferramenta.
Leia sobre as taxas por 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.
Solicitar 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 forma semelhante, então vale a pena memorizar a estrutura.
Entender o básico Estrutura de APIs de recursos e Serviços.
Consulte Como alterar e inspecionando objetos e Como recuperar objetos.
Leia sobre Metadados de recursos. para entender como solicitá-las de forma dinâmica.
Leia a Visão geral de 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 rápida visão geral de relatórios e uma exemplo para resumir os desempenho de uma conta nos últimos 30 dias usando GoogleAdsService como a única fonte confiável para gerar relatórios do Google Ads.
Leia Linguagem de consulta do Google Ads (GAQL, na sigla em inglês) para compreender a gramática e a estrutura das consultas, além dos conceitos do recurso, segmento e métricas.
Leia sobre Métricas de critérios para entender como recuperar dados de performance para critérios diferentes com *_view recursos, 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 o declaração GAQL em 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

Amostras de planejamento -> Gerar métricas de previsão
Planning Samples -> Generate Keyword Ideas

Automatizar 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 a Orçamento da conta a 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 comercial no Google para solicitar acesso ao AccountBudgetProposalService do Google.
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.
Fazer o download de uma biblioteca de cliente para no idioma de sua preferência.
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 alterar status

Se você não conhece o Recomendações e Histórico de alterações da sua conta, teste-a na interface do Google Ads.

RecommendationService

Leia nosso guia sobre como usar o RecommendationService para recuperar e aplicar as recomendações do Google à sua conta para aumentar o desempenho geral dos anúncios.
Descubra as funcionalidades de recomendação executando este exemplo de código: Recomendação Descobertas -> Como 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 -> Consultar alterações na conta.

Como ficar por dentro das novidades

Controle de versões

Quando uma nova API for lançada, obtenha a versão mais recente da nossa biblioteca de cliente.
Adicionar um favorito à versão mais recente Acesse as Notas de lançamento 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 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 esses dados 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 no Pesquisa Google e 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 tag (TMS) que permite que você: atualizar de forma rápida e fácil códigos de acompanhamento e fragmentos de código relacionados; coletivamente conhecidas 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 informações e painéis e relatórios totalmente personalizáveis.

Receber ajuda

Adicione um favorito ao Guias da API Google Ads. A maioria dos conceitos básicos é minuciosamente explicado aqui.
Adicione um marcador à referência da API Google Ads. Todas as funcionalidades da API são explicadas em detalhes.
Adicione um favorito ao 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 comercial / gerente de parcerias no Google para configurar uma reunião para abordar questões estratégicas mais complexas relacionados à API.