Çoğu Google Ads öğesi, tanımlayıcılarını döndüren bir getId() yöntemi sunar. Çoğu durumda kesinlikle gerekli olmasa da kimlikler aşağıdaki durumlarda faydalı olabilir:
- Raporlarla çalışma
- Kimlikler, bir rapor satırını gerçek Google Ads öğesine bağlamanın iyi bir yoludur.
- Harici bir veri deposuyla eşlemeyi sürdürme
- Kendi veritabanınızda kimliğe dayalı bilgiler depolanmış olabilir.
- Performans artışı arıyorsanız
Kimliklere göre getirme işlemi genellikle alternatiflerinden daha hızlıdır. Tek bir varlığı getirme kodu da biraz daha kolaydır:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // versus let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
Özgünlük
Kampanya kimlikleri ve reklam grubu kimlikleri benzersizdir: İki kampanya veya reklam grubu hiçbir zaman aynı kimliği paylaşmaz. Ancak reklamlar ve anahtar kelimeler bileşik kimliklere sahiptir: Bir anahtar kelimenin benzersiz tanımlayıcısı, reklam grubu kimliği ile anahtar kelime kimliğinin birleşimidir.
Benzer şekilde, bir reklamın benzersiz tanımlayıcısı, reklam grubu kimliği ile reklam kimliğinin birleşimidir. Bu durum, selector.withIds() işlevinin çağrılma şeklini etkiler.
Kampanyalar ve reklam grupları için selector.withIds() bir sayı dizisi bekler:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
Ancak reklamlar ve anahtar kelimeler için selector.withIds(), ilk öğesi reklam grubu kimliği olan iki öğeli dizilerden oluşan bir dizi gerektirir. Aşağıdaki snippet, bir reklam grubundan üç anahtar kelime alır:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
Reklamlar getirilirken de aynı yapı geçerlidir.
Geçici ID'ler
Birden fazla işlem içeren bir değişiklik isteği ile çalışırken, API yanıtını alana kadar tam kaynak adları kullanılamayacağından kaynakları birbirine bağlamak için bazen geçici ID'ler kullanmanız gerekir. Geçici ID'ler -1 ile başlayan negatif sayılar olmalıdır ve aynı değişiklik isteğinde tekrarlanamaz. Geçici ID'leri etkili bir şekilde kullanmak için yinelenen geçici ID'ler oluşturmamanızı sağlayacak bir kod yazmanız gerekir:
let nextId = -1;
function getNextTempId() {
const ret = nextId;
nextId -= 1;
return ret;
}
getNextTempId için yapılan her ardışık çağrı, bir öncekinden bir eksik sayı döndürür. Tüm geçici kimlikler negatif olmalıdır. Bu nedenle -1'den başlayın.
Geçici ID'ler, işler veya değişiklik istekleri arasında hatırlanmaz. Önceki bir değişiklik isteğinde oluşturulan bir kaynağa referans vermek için kaynağın gerçek adını kullanın.