Problemas comuns

Esta é uma compilação dos problemas mais comuns Fórum de scripts do Google Ads.

Erros comuns de JavaScript

O script apresenta a falha "Não foi possível encontrar a função: FUNCTION_NAME"

Geralmente, isso é resultado de um nome de função com erro ortográfico no script.

  1. Verifique se o nome da função está escrito e correto letras maiúsculas e minúsculas; Por exemplo: AdsApp.keywordz() vai resultar nesse erro, porque keywordz não é uma função válida no classe AdsApp. AdsApp.Keywords() também vai falhar devido a erros de grafia incorreta para função keywords().

  2. Verificar se a função existe; Por exemplo: AdsApp.keywords().next() vai falhar porque AdsApp.keywords() retorna um KeywordSelector enquanto next() é um método para um objeto KeywordIterator. O código correto é AdsApp.keywords().get().next().

Meu script é executado, mas não resulta em nenhuma ação

O motivo mais comum desse problema é que você tem uma função que executa uma operação, mas você não a está chamando pelo método main(). Isso geralmente acontece quando você copia e cola códigos snippets da nossa documentação.

Abordagem de codificação Snippet de código
Versão 1 (não funciona)
function main() {
  // Call to getAllCampaigns is missing, so this script does nothing.
}

function getAllCampaigns() {
  // AdsApp.campaigns() will return all campaigns that are not
  // removed by default.
  let campaignIterator = AdsApp.campaigns().get();
  console.log('Total campaigns found : ' +
      campaignIterator.totalNumEntities());
  while (campaignIterator.hasNext()) {
    let campaign = campaignIterator.next();
    console.log(campaign.getName());
  }
}
Versão 2 (não funciona)
function main() {
  // Call to getAllCampaigns is missing, so this script does nothing.

  function getAllCampaigns() {
    // AdsApp.campaigns() will return all campaigns that are not
    // removed by default.
    let campaignIterator = AdsApp.campaigns().get();
    console.log('Total campaigns found : ' +
        campaignIterator.totalNumEntities());
    while (campaignIterator.hasNext()) {
      let campaign = campaignIterator.next();
      console.log(campaign.getName());
    }
  }
}
Versão 3 (funciona)
function main() {
  getAllCampaigns();
}

function getAllCampaigns() {
  // AdsApp.campaigns() will return all campaigns that are not removed
  // by default.
  let campaignIterator = AdsApp.campaigns().get();
  console.log('Total campaigns found : ' +
      campaignIterator.totalNumEntities());
  while (campaignIterator.hasNext()) {
    let campaign = campaignIterator.next();
    Logger.log(campaign.getName());
  }
}

Eu recebo um erro "Não é possível encontrar a função getFinalUrl" quando faço upgrade dos meus scripts

Você pode encontrar esse erro ao alterar seu script para funcionar com a versão Com upgrade URLs. Isso acontece quando você substituir chamadas para ad.getDestinationUrl() por ad.getFinalUrl(). getFinalUrl() faz parte do classe AdUrls, então é necessário mudar seu código para ad.urls().getFinalUrl():

function main() {
  // Incorrect snippet. getFinalUrl is not a member of the Ad class.
  let ad = AdsApp.ads().get().next();
  let url = ad.getFinalUrl();

  // Correct snippet.
  let ad = AdsApp.ads().get().next();
  let url = ad.urls().getFinalUrl();
}

Eu não vejo estatísticas para X

A indisponibilidade de dados para determinada entidade ou período é um erro comum que você pode encontrar ao gerar relatórios ou fazer chamadas de estatísticas. Existem várias coisas que você pode tentar:

  1. Verifique o período para o qual você está recuperando estatísticas ou gerando relatórios.

  2. Se você recuperar estatísticas no nível da conta de um script do Google Ads Manager que gerencia contas em moedas diferentes, você recebe o custo na moeda do a conta de administrador.

  3. É possível que o Google Ads ainda não tenha os dados que você deseja. Consulte nossos dados guia de atualização para detalhes.

Solicitações de recurso

O recurso X está disponível?

Confira nossa referência Documentação.

Quando o recurso X estará disponível?

Tentamos trabalhar nos recursos mais solicitados primeiro. Se houver um recurso que você gostaria de ver, siga estas etapas:

  1. Primeiro, verifique se o recurso é suportado nos scripts do Google Ads: verificando a referência Documentação.

  2. Se ele não estiver disponível, pesquise os scripts do Google Ads fórum para saber se é sobre as quais já perguntaram antes. Em caso afirmativo, apoie essa conversa ou deixe um deixe um comentário se quiser compartilhar mais detalhes, como um caso de uso.

  3. Se o recurso ainda não tiver sido solicitado, faça uma solicitação abrindo uma nova conversa nos scripts do Google Ads fórum. Certifique-se de indicar um caso de uso que o recurso vai resolver. Quando possível, inclua para o guia da Central de Ajuda ou uma postagem / guia do blog da API do Google AdWords que descreve este recurso. Isso ajudará outros desenvolvedores a apoiarem uma solicitação de recurso. Priorizamos solicitações de recursos com base na popularidade delas.

  4. Marcar a postagem como "Solicitação de recurso" para facilitar para nós (assim como usuários) para verificar rapidamente as solicitações de recursos.

Como usar o recurso X?

Veja nossos snippets de código e soluções para exemplos de como usar um recurso específico. Se você não encontrar um snippet de código adequado, fique à vontade de fazer uma solicitação no fórum.