La plupart des entités Google Ads exposent une méthode getId() qui renvoie leur identifiant. Bien que cela ne soit pas strictement nécessaire dans la plupart des cas, les ID peuvent être utiles lorsque
- Utiliser les rapports
- Les ID constituent un bon moyen d'associer une ligne de rapport à l'entité Google Ads correspondante.
- Maintien de l'association avec une banque de données externe
- Il est possible que vous ayez déjà des informations basées sur des ID stockées dans votre propre base de données.
- Amélioration des performances
L'extraction de données à partir d'identifiants est souvent la méthode la plus rapide. Le code permettant de récupérer une seule entité est également un peu plus simple :
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Unicité
Les ID de campagne et de groupe d'annonces sont uniques. Deux campagnes ou groupes d'annonces ne peuvent pas partager le même ID. Toutefois, les annonces et les mots clés ont des ID composites : l'identifiant unique d'un mot clé est une combinaison de son ID de groupe d'annonces et de son ID de mot clé.
De même, l'identifiant unique d'une annonce est une combinaison de l'ID de son groupe d'annonces et de son ID d'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);
Toutefois, pour les annonces et les mots clés, selector.withIds() a besoin d'un tableau de tableaux à deux éléments, le premier é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.