Problèmes courants

Il s'agit d'une compilation des problèmes les plus courants soulevés sur le forum des scripts Google Ads.

Erreurs JavaScript courantes

Le script échoue et indique "Fonction introuvable: FUNCTION_NAME"

Cela est généralement dû à un nom de fonction mal orthographié dans le script.

  1. Vérifiez que le nom de la fonction est correctement orthographié et que la casse est correcte (par exemple, AdsApp.keywordz() génère cette erreur, car keywordz n'est pas une fonction valide dans la classe AdsApp. AdsApp.Keywords() échoue également en raison d'une faute d'orthographe pour la fonction keywords().

  2. Vérifiez que la fonction existe, par exemple : AdsApp.keywords().next() échouera, car AdsApp.keywords() renvoie un KeywordSelector, tandis que next() est une méthode pour un objet KeywordIterator. Le code correct serait AdsApp.keywords().get().next().

Mon script s'exécute, mais ne fait rien

La raison la plus courante de ce problème est qu'une fonction effectue une opération, mais que vous ne l'appelez pas à partir de la méthode main(). Cela se produit généralement lorsque vous copiez et collez des extraits de code depuis notre documentation.

Approche de codage Extrait de code
Version 1 (non fonctionnelle) 
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());
  }
}
Version 2 (non fonctionnelle) 
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());
    }
  }
}
Version 3 (fonctionne) 
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());
  }
}

L'erreur "Impossible de trouver la fonction getFinalUrl" s'affiche lors de la mise à niveau de mes scripts

Vous pouvez rencontrer cette erreur lorsque vous modifiez votre script pour qu'il fonctionne avec des URL mises à jour. Elle se produit lorsque vous remplacez les appels à ad.getDestinationUrl() par ad.getFinalUrl(). getFinalUrl() fait partie de la classe AdUrls. Vous devez donc remplacer votre code par 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();
}

Je n'obtiens aucune statistique pour X

L'indisponibilité des données pour une entité ou une plage de dates particulière est une erreur courante que vous pouvez rencontrer lors de l'exécution de rapports ou d'appels de statistiques. Vous pouvez essayer plusieurs choses:

  1. Vérifiez la période pour laquelle vous souhaitez obtenir des statistiques ou générer des rapports.

  2. Si vous récupérez des statistiques au niveau du compte pour un script Ads Manager qui gère des comptes dans différentes devises, vous obtenez le coût dans la devise du compte administrateur.

  3. Il est possible que Google Ads ne dispose pas encore des données que vous recherchez. Pour en savoir plus, consultez notre guide sur la fraîcheur des données.

Demandes de fonctionnalités

La fonctionnalité X est-elle disponible ?

Consultez notre documentation de référence.

Quand la fonctionnalité X sera-t-elle disponible ?

Nous essayons d'abord de nous concentrer sur les fonctionnalités les plus demandées. Si vous souhaitez bénéficier d'une fonctionnalité, procédez comme suit:

  1. Commencez par vérifier que la fonctionnalité n'est pas compatible avec les scripts Google Ads en consultant la documentation de référence.

  2. Si ce n'est pas le cas, effectuez une recherche dans le forum sur les scripts Google Ads pour voir si vous avez déjà fait l'objet de questions. Si oui, votez pour ce fil de discussion ou laissez un commentaire si vous souhaitez partager des détails supplémentaires, comme un cas d'utilisation.

  3. Si la fonctionnalité n'est pas encore demandée, faites-en la demande en ouvrant un nouveau fil de discussion sur le forum des scripts Google Ads. Veillez à fournir un cas d'utilisation que cette fonctionnalité résoudra. Dans la mesure du possible, ajoutez un lien vers le guide du centre d'aide ou un article de blog / guide de l'API AdWords décrivant cette fonctionnalité. Cela aidera les autres développeurs à voter pour une demande de fonctionnalité. Nous hiérarchisons les demandes de fonctionnalités en fonction de leur popularité.

  4. Ajoutez le tag "Demande de fonctionnalité" au post pour que nous (ainsi que les utilisateurs) puissiez consulter plus facilement et rapidement les demandes de fonctionnalités.

Comment utiliser la fonctionnalité X ?

Consultez nos extraits de code et nos solutions pour découvrir des exemples d'utilisation d'une fonctionnalité particulière. Si vous ne trouvez pas d'extrait de code approprié, n'hésitez pas à en faire la demande sur le forum.