Ad hiyerarşisi
Google Ads API'de kullanılan kaynak adları hiyerarşik olup Google Ads'deki varlıkların organizasyonunu yansıtır. Neredeyse tüm kaynaklar, Customer kaynağının alt kaynaklarıdır. Bu durum, neredeyse her API çağrısının belirli bir Google Ads hesabını hedeflemesi gerektiği gerçeğini yansıtır. Örneğin, kampanyalar, reklam grupları, reklamlar ve anahtar kelimeler, bir kök müşteri kaynağının alt kaynaklarıdır.
| Kaynak | Kaynak Adı |
|---|---|
| Müşteri | customers/1234567890
|
| Kampanya | customers/1234567890/campaigns/8765432109
|
| Reklam Grubu | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Kaynak kimlikleri
Google Ads varlıkları (müşteriler, kampanyalar vb.) API'de kaynak adlarıyla anılır. Ancak kaynak adlarının kendilerinin, hiyerarşideki her nesneyi tanımlayan benzersiz sayısal kaynak kimliklerine sahip olabileceğini unutmamak önemlidir. Bu gibi durumlarda, kaynak adını ayrıştırarak bu kaynak kimliklerini ayıklamak ve yeni bir kaynak kimliği oluşturmak faydalı olabilir.
Örneğin, önceki tablodaki AdGroupAd kaynak adını inceleyin:
customers/1234567890/adGroupAds/54321098765~2109876543210
Bu, aşağıdaki gibi ayrı kaynak kimliklerine (koleksiyon kimlikleriyle ayrılmış) bölünebilir:
| Kaynak adı bileşenleri | |||||||
|---|---|---|---|---|---|---|---|
| Kaynak kimlikleri |
|
||||||
| Koleksiyon kimlikleri |
|
||||||
Bağımsız kimlikleri ayrıştırmak, reklam grubu reklamının müşterisine (customers/1234567890) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765) referans verecek yeni kaynak adları türetmenize olanak tanır.
Paylaşılan nesnelerin tanımlayıcıları
API'deki çoğu nesne, tek bir Google Ads müşterisiyle ilişkilidir. Ancak birden fazla hesap arasında paylaşılabilecek bazı nesne türleri vardır. Uygulamada bunlar, genellikle yöneticiler tarafından oluşturulan ve ardından birçok müşteri hesabıyla paylaşılan negatif anahtar kelime listeleri veya hesaplar arası dönüşüm işlemleri gibi öğelerdir.
Bu türdeki nesnelerin kaynak adları, API çağrısı gönderdiğiniz hesaba bağlı olarak değişir.
Örnek: Hesaplar arası dönüşüm işlemleri
Hesaplar arası dönüşüm işlemini müşteri-ajans hesaplarından 123-456-7890 ile paylaşan bir yönetici hesabımız (987-654-3210) olduğunu varsayalım:
Dönüşüm işleminin yeniden inceleme aralığını güncellemek için yönetici hesabına API çağrısı yapıldığında, paylaşılan nesneye şu kaynak adı kullanılarak referans verilir: customers/9876543210/conversionActions/257733534.
Paylaşılan dönüşüm işlemini kullanmayı etkinleştirmek için müşteri hesabına yapılan bir API çağrısı, kaynak adını kullanarak buna referans verir:
customers/1234567890/conversionActions/257733534.
Bu, aynı temel dönüşüm işlemidir ancak kaynak adı, erişmek için kullanılan hesaba göre değişir.