Práticas recomendadas

Este guia aborda algumas práticas recomendadas que você pode implementar para otimizar a eficiência e o desempenho dos seus apps.

Manter seu app

Para garantir que o app seja executado sem interrupções, faça o seguinte:

  • Verifique se a lista de proprietários e editores do seu projeto do Google Cloud está atualizada. Vamos entrar em contato com esses usuários em caso de emergências ou assuntos relacionados à conformidade com os Termos e Condições da API. Se não for possível entrar em contato com você sobre a conformidade com os Termos e Condições da API, seu acesso a ela poderá ser reduzido ou revogado.

  • Para ficar por dentro de problemas como mudanças no produto, tempo de inatividade para manutenção e datas de descontinuação, inscreva-se no blog da API e no blog do produto.

  • Mantenha seu app em conformidade com os Termos e Condições (T&C) da API Google Ads. Se necessário, a equipe de compliance da API vai entrar em contato com os proprietários e editores do seu projeto do Google Cloud com acesso à API. Se você tiver dúvidas sobre os Termos e Condições, entre em contato com a equipe de compliance respondendo ao e-mail enviado durante a análise da sua solicitação de acesso à API.

Otimização

É possível otimizar o app executando operações em lote e, se for o caso, enviando objetos esparsos.

Operações em lote

Fazer uma solicitação à API envolve vários custos fixos, como latência de rede de ida e volta, processamento de serialização e desserialização e chamadas para sistemas de back-end. Para diminuir o impacto desses custos fixos e aumentar a performance geral, a maioria dos métodos de mutação na API foi projetada para aceitar uma matriz de operações. Ao agrupar várias operações em cada solicitação, você pode reduzir o número de solicitações feitas e os custos fixos associados. Se possível, evite fazer solicitações com apenas uma operação.

Por exemplo, suponha que você esteja adicionando 50.000 palavras-chave a uma campanha em vários grupos de anúncios. Em vez de fazer 50.000 solicitações com uma palavra-chave cada, faça 100 solicitações com 500 palavras-chave cada ou até mesmo 10 solicitações com 5.000 palavras-chave cada. Há limites para o número de operações permitidas em uma solicitação. Portanto, talvez seja necessário ajustar o tamanho do lote para alcançar a performance ideal.

Enviar objetos escassos

Quando os objetos são enviados à API, os campos precisam ser desserializados, validados e armazenados no banco de dados. Transmitir objetos completos quando você só quer atualizar alguns campos pode resultar em tempo de processamento extra e diminuição do desempenho. Para mitigar isso, a API Google Ads oferece suporte a atualizações esparsas, permitindo preencher apenas os campos de um objeto que precisam ser alterados ou que são obrigatórios. As atualizações esparsas são processadas mais rapidamente e têm menos probabilidade de produzir erros. Os campos que não estão no update_mask (também conhecido como FieldMask) permanecem inalterados.

Por exemplo, um app que atualiza lances no nível da palavra-chave pode se beneficiar do uso de atualizações esparsas, já que apenas os campos "ID do grupo de anúncios", "ID do critério" e "Lances" precisam ser preenchidos.

Tratamento e gerenciamento de erros

Durante o processo de desenvolvimento, você provavelmente encontrará erros. Esta seção descreve considerações e estratégias para criar o gerenciamento de erros no seu app. Além desta seção, consulte o guia de solução de problemas para mais informações sobre como gerenciar erros.

Diferenciar origens de solicitação

Alguns apps são principalmente interativos, emitindo chamadas de API diretamente em resposta a ações iniciadas pelo usuário em uma interface. Outros funcionam principalmente off-line, emitindo chamadas de API como parte de um processo periódico de back-end. Muitos aplicativos combinam os dois. Ao pensar no gerenciamento de erros, é útil distinguir esses diferentes tipos de solicitações.

No caso de solicitações iniciadas pelo usuário, sua principal preocupação deve ser oferecer uma boa experiência aos seus usuários. Use o erro específico que ocorreu para fornecer ao usuário o máximo de contexto possível na interface. Ofereça etapas claras que eles podem seguir para resolver o erro (confira as sugestões a seguir).

Para solicitações iniciadas no back-end, implemente gerenciadores para os diferentes tipos de erros que seu app pode encontrar. Sempre inclua um gerenciador padrão para resolver erros raros ou que nunca foram encontrados antes. Uma boa abordagem para um gerenciador padrão é adicionar a operação com falha e o erro a uma fila para que um operador humano revise e determine uma resolução adequada.

Diferenciar tipos de erro

Conhecer as diferenças entre os tipos de erros na API Google Ads é fundamental ao criar um tratamento de erros robusto. Alguns dos tipos de erros mais comuns são:

Consulte Tipos de erros e Erros comuns para mais detalhes.

Sincronizar back-ends

Se os usuários do seu app tiverem acesso manual às contas do Google Ads, eles poderão fazer mudanças que o app não conhece, fazendo com que o banco de dados local do app fique dessincronizado. Conforme observado no nosso guia Tipos de erros, você pode resolver erros relacionados à sincronização de forma reativa quando eles ocorrem, mas também pode tentar evitá-los de forma proativa. Uma estratégia proativa é executar um trabalho de sincronização periódica para conciliar seu banco de dados local com os objetos do Google Ads nas suas contas. Para hierarquias de contas grandes, evite extrair todos os objetos de todas as contas todas as noites para não esgotar as cotas diárias. Em vez disso, consulte ChangeStatus ou filtre as entidades modificadas recentemente para sincronizar as mudanças de forma incremental.

Erros de registro

Todos os erros devem ser registrados para facilitar a depuração e o monitoramento. No mínimo, registre o ID da solicitação, as operações que causaram o erro e o erro em si. Outras informações a serem registradas incluem ID do cliente, serviço de API, latência de solicitação de ida e volta, número de novas tentativas e a solicitação e resposta bruta higienizadas (não se esqueça de ocultar credenciais sensíveis, como tokens OAuth, tokens de desenvolvedor, se ainda estiverem incluídos em cabeçalhos de solicitação legados, e qualquer PII).

Monitore as tendências de erros de API para detectar e resolver problemas com seu app. Crie sua própria solução ou use uma das muitas ferramentas comerciais disponíveis que podem usar seus registros para gerar painéis interativos e enviar alertas automáticos.

Desenvolvimento

Use contas de teste durante o desenvolvimento.

Use contas de teste

As contas de teste são contas do Google Ads que não veiculam anúncios. Você pode usar uma conta de teste para experimentar a API Google Ads e testar se a conectividade do app, a lógica de gerenciamento de campanhas ou outro processamento estão funcionando conforme o esperado. Seu projeto do Google Cloud só precisa de acesso de teste para ser usado em uma conta de teste. Assim, você pode começar a desenvolver com a API Google Ads imediatamente, enquanto aguarda a análise do Google sobre seu aplicativo para níveis mais altos de acesso à API.

Avançar
Limites e cotas da API