La maggior parte delle entità Google Ads espone un metodo getId() che restituisce il relativo identificativo. Sebbene non siano strettamente necessari nella maggior parte dei casi, gli ID possono essere utili
quando
- Utilizzare i report
- Gli ID offrono un ottimo modo per collegare una riga del report all'entità Google Ads effettiva.
- Mantenere una mappatura con un datastore esterno
- Potresti già avere informazioni basate su ID memorizzate nel tuo database.
- Cercare un piccolo miglioramento delle prestazioni
Il recupero tramite ID è spesso più veloce rispetto alle alternative. Anche il codice per recuperare una singola entità è un po' più semplice:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Unicità
Gli ID campagna e gruppo di annunci sono univoci: non esistono due campagne o gruppi di annunci che condividano lo stesso ID. Gli annunci e le parole chiave, invece, hanno ID composti: un identificatore univoco di una parola chiave è una combinazione del relativo ID gruppo di annunci e ID parola chiave.
Analogamente, un identificatore univoco di un annuncio è una combinazione del relativo ID gruppo di annunci e ID annuncio. Ciò ha implicazioni per il modo in cui viene chiamato selector.withIds().
Per le campagne e i gruppi di annunci, selector.withIds() si aspetta un array di numeri:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Per gli annunci e le parole chiave, però, selector.withIds() ha bisogno di un array di array di due elementi, il primo dei quali è l'ID gruppo di annunci. Il seguente snippet recupera tre parole chiave da un gruppo di annunci:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
Lo stesso costrutto si applica al recupero degli annunci.