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.
	Info:informações que não são essenciais para o processo, mas ajudam a entender o contexto ou esclarecer determinadas etapas.
	Aviso:informações importantes ao longo do processo, já que podem envolver mais esforço de implementação ou gerar certos riscos.

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.
	É tudo o que você precisa para testar a API Google Ads com contas de teste. É possível usar contas de teste para criar campanhas e anúncios, mas nenhum dos seus anúncios vai ser veiculado (custos acumulados) e todas as estatísticas de relatórios vão ser 0. Para ativar o token de desenvolvedor para acessar contas de produção, ele precisa ser aprovado pela nossa equipe de análise de tokens.
	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.
	Depois que o token de desenvolvedor for aprovado, você poderá usá-lo para fazer chamadas de API para contas de produção. Inicialmente, você terá acesso básico, que permite 15.000 operações por dia e um limite de 1.000 operações de recebimento por dia.
	Se a inscrição for recusada, você vai receber um e-mail com os motivos. Você pode fazer alterações na inscrição, fornecer mais detalhes sobre a solução e se inscrever novamente.

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.
	As ferramentas que podem funcionar com o acesso básico, ou seja, menos de 15.000 solicitações por dia, estão isentas da RMF. As ferramentas a que os anunciantes não têm acesso e que são destinadas apenas a uso interno estão isentas da RMF. Se a sua ferramenta só gera relatórios, apenas a RMF de relatórios será aplicada. Se a sua ferramenta for muito limitada e especializada, como apenas para compras ou promoção de apps, apenas a parte da RMF usada pela sua ferramenta será aplicada. Se você não tiver certeza se a política de RMF é relevante para sua ferramenta, entre em contato com a equipe de compliance da API Google Ads.
	Leia sobre as taxas por não conformidade para entender o que acontece quando os RMFs não são implementados corretamente.
	Se a ferramenta for usada fora da sua organização (ou seja, não for uma ferramenta somente interna), ela precisará implementar as RMFs aplicáveis antes de você se inscrever para o acesso padrão. O RMF está sujeito a mudanças conforme a API muda. Se você decidir solicitar o acesso padrão, vai precisar manter sua ferramenta atualizada com a RMF mais recente.
	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

	Confira e execute nosso exemplo de código para entender como trabalhar com a API. Recomendamos executar pelo menos os exemplos abaixo para entender como gerenciar os objetos básicos do Google Ads.
	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

	Para gerar relatórios, você precisa usar uma conta que veicula anúncios há tempo suficiente para gerar métricas de performance. Recomendamos pelo menos sete dias.
	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

	Conheça os recursos disponíveis na ferramenta para desenvolvedores Criador de consultas interativo do Google Ads. Essa ferramenta baseada na Web encontra todos os campos e filtros disponíveis para o recurso selecionado e gera as consultas de maneira interativa.
	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.

A API Google Ads oferece vários serviços que refletem a funcionalidade do Planejador de palavras-chave e ajudam você a pesquisar palavras-chave. O KeywordPlanIdeaService propõe ideias de palavras-chave com base em determinados parâmetros, e o KeywordPlanService fornece estatísticas estimadas sobre a performance das palavras-chave e ajuda você a avaliar a qualidade delas. É altamente recomendável usar uma conta do Google Ads com campanhas ativas para emitir essas solicitações de API e ter métricas precisas.

Exemplos de código

	Conheça as funcionalidades de planejamento de palavras-chave executando os exemplos de código abaixo.
	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).
	Se você não usa o faturamento mensal e não planeja se inscrever, pule esta seção.
	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.
	Para usar o AccountBudgetProposalService, sua conta de administrador do Google Ads precisa estar na lista de permissões. Não será possível usar esse serviço até que esse processo seja concluído. Você também precisa configurar o faturamento mensal com o Google. Entre em contato com seu gerente de parcerias estratégicas (GPE) no Google para organizar esse processo. O acesso está disponível apenas para parceiros do Google.
	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

	Se você for usar os anúncios do Shopping, provavelmente precisará usar o Google Merchant Center e a API Content for Shopping para gerenciar os dados de produtos. Esta seção descreve as etapas básicas para começar a usar essa API.
	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.
	A API Google Ads oferece dois serviços que refletem essas funcionalidades. O RecommendationService proporciona recomendações de otimização com impacto estimado, enquanto o ChangeStatusService busca o histórico de alterações na sua conta, que pode ser usado para várias finalidades, como sincronização de cópia local, auditoria simples e muito mais.

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 versão principal anterior é descontinuada, ela não tem mais suporte, e as chamadas de API feitas usando uma versão anterior da API falham. Siga as etapas abaixo para ficar por dentro das atualizações da API.
	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.

Produtos do Google relacionados a anúncios

	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.