Problèmes courants

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

Erreurs JavaScript courantes

Échec du script avec le message d'erreur "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 dans la fonction keywords().

  2. Vérifier 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 est 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 à partir de notre documentation.

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

Le message d'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 lorsque vous exécutez des rapports ou effectuez des appels de statistiques. Vous pouvez essayer plusieurs solutions:

  1. Vérifiez la période pour laquelle vous récupérez des statistiques ou générez des rapports.

  2. Si vous récupérez les statistiques au niveau du compte pour un script Ads Manager qui gère des comptes dans des devises différentes, 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 travailler sur les fonctionnalités les plus demandées. Si une fonctionnalité vous intéresse, procédez comme suit:

  1. Tout d'abord, vérifiez que la fonctionnalité n'est pas compatible avec les scripts Google Ads en consultant la documentation de référence.

  2. Si elle n'est pas disponible, consultez le forum des scripts Google Ads pour voir si elle a déjà été posée. Si c'est le cas, 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, envoyez-nous une demande en ouvrant un nouveau fil de discussion sur le forum des scripts Google Ads. Assurez-vous de fournir un cas d'utilisation que cette fonctionnalité permettra de résoudre. Si possible, incluez 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. Taguez le post en tant que "Demande de fonctionnalité" pour nous permettre (ainsi que pour les utilisateurs) de rechercher rapidement les demandes de fonctionnalités.

Comment utiliser la fonctionnalité X ?

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