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 pièces d'identité peuvent s'avérer utiles dans les cas suivants :
- Utiliser les rapports
- Les ID permettent d'associer facilement une ligne de rapport à l'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 simple :
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Unicité
Les ID de campagne et les ID de groupe d'annonces sont uniques : deux campagnes ou deux 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 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 son ID de 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 élément étant l'ID du groupe d'annonces. L'extrait de code suivant extrait 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 structure s'applique lors de l'extraction des annonces.