La plupart des entités Google Ads exposent une méthode getId() qui renvoie leur identifiant. Bien qu'ils ne soient pas strictement nécessaires dans la plupart des cas, les ID peuvent s'avérer utiles dans les cas suivants :
- Utiliser les rapports
- Les ID sont un bon moyen d'associer une ligne de rapport à une entité Google Ads réelle.
- Maintien de l'association avec une banque de données externe
- Votre propre base de données contient peut-être déjà des informations basées sur l'ID.
- Amélioration des performances
L'extraction de données à partir d'identifiants est souvent la méthode la plus rapide. Le code permettant d'extraire une seule entité est également un peu plus facile:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Originalité
Les ID de campagne et les ID de groupe d'annonces sont uniques: deux campagnes ou groupes d'annonces ne peuvent jamais partager le même ID. Les annonces et les mots clés, en revanche, ont des ID composites: l'identifiant unique d'un mot clé est une combinaison de l'ID du groupe d'annonces et de l'ID du mot clé.
De même, l'identifiant unique d'une annonce est une combinaison de l'ID du groupe d'annonces et de l'ID de l'annonce. Cela a des conséquences sur la façon dont selector.withIds() est appelé.
Pour les campagnes et les groupes d'annonces, selector.withIds() attend un tableau de nombres:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Pour les annonces et les mots clés, cependant, selector.withIds() a besoin d'un tableau de tableaux à deux éléments, le premier élément étant l'ID du groupe d'annonces. L'extrait de code suivant récupère trois mots clés d'un groupe d'annonces:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
La même construction s'applique lors de la récupération des annonces.