IDs

Die meisten Google Ads-Entitäten stellen eine getId()-Methode bereit, die ihre Kennung zurückgibt. IDs sind zwar in den meisten Fällen nicht unbedingt erforderlich, können aber in folgenden Fällen nützlich sein:

Berichte verwenden
IDs sind eine gute Möglichkeit, eine Berichtszeile mit der eigentlichen Google Ads-Entität zu verknüpfen.
Bei der Verwaltung einer Zuordnung mit einem externen Datenspeicher
Möglicherweise haben Sie bereits ID-basierte Informationen in Ihrer eigenen Datenbank gespeichert.
Beim Versuch, die Leistung zu steigern

Das Abrufen nach IDs geht häufig schneller als alternative Vorgehensweisen. Der Code zum Abrufen einer einzelnen Entität ist ebenfalls etwas einfacher:

let campaigns = AdsApp.campaigns()
   .withIds([678678])
   .get();
// vs.
let campaigns = AdsApp.campaigns()
   .withCondition("Name='My Campaign'")
   .get();

Eindeutigkeit

Kampagnen-IDs und Anzeigengruppen-IDs sind eindeutig: Keine zwei Kampagnen oder Anzeigengruppen haben dieselbe ID. Anzeigen und Keywords haben jedoch zusammengesetzte IDs: Die eindeutige Kennung eines Keywords ist eine Kombination aus der Anzeigengruppen-ID und der Keyword-ID. Die eindeutige Kennung einer Anzeige besteht ebenfalls aus einer Kombination aus Anzeigengruppen-ID und Anzeigen-ID. Das hat Auswirkungen auf die Aufrufweise von selector.withIds().

Für Kampagnen und Anzeigengruppen wird für selector.withIds() ein Zahlenarray erwartet:

let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);

Bei Anzeigen und Keywords ist für selector.withIds() jedoch ein Array mit zwei Elementen erforderlich, wobei das erste Element die Anzeigengruppen-ID ist. Im folgenden Snippet werden drei Keywords aus einer Anzeigengruppe abgerufen:

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

Dasselbe gilt für das Abrufen von Anzeigen.