Ad hiyerarşisi
Google Ads API'de kullanılan kaynak adları hiyerarşiktir ve Google Ads'deki varlıkların düzenini yansıtır. Kaynakların neredeyse tamamı Customer
kaynağının alt kaynaklarıdır. Bu kaynaklar, neredeyse her API çağrısının belirli bir Google Ads hesabını hedeflemesi gerektiğini gösterir. Örneğin kampanyalar, reklam grupları, reklamlar ve anahtar kelimelerin tümü kök müşteri kaynağının alt kaynaklarıdır.
Kaynak | Kaynak Adı |
---|---|
Müşteri | customers/1234567890
|
Kampanya | customers/1234567890/campaigns/8765432109
|
AdGroup | customers/1234567890/adGroups/54321098765
|
AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Kaynak kimlikleri
API'de Google Ads varlıklarına (müşteriler, kampanyalar vb.) kaynak adlarıyla atıfta bulunulur. Bununla birlikte, kaynak adlarının kendilerinin hiyerarşideki her bir nesneyi tanımlayan benzersiz sayısal kaynak kimliklerine sahip olabileceğini unutmayın. Bu durumlarda, bu kaynak kimliklerini çıkarmak ve yeni bir kimlik oluşturmak için kaynak adını ayrıştırmak faydalı olabilir.
Örneğin, önceki tablodan AdGroupAd
kaynak adını inceleyin:
customers/1234567890/adGroupAds/54321098765~2109876543210
Bu veriler, aşağıdaki şekilde bağımsız kaynak kimliklerine (koleksiyon kimlikleriyle ayrılmış şekilde) ayrılabilir:
Kaynak adı bileşenleri | |||||||
---|---|---|---|---|---|---|---|
Kaynak Kimlikleri |
|
||||||
Koleksiyon Kimlikleri |
|
Bağımsız kimliklerin ayrıştırılması, reklam grubu reklamının müşterisine (customers/1234567890
) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765
) referans verecek yeni kaynak adları elde etmenize olanak tanır.
Paylaşılan nesnelerin tanımlayıcıları
API'deki çoğu nesne belirli bir Google Ads müşterisiyle ilişkilendirilir. Bununla birlikte, bazı nesne türleri birden fazla hesap arasında paylaşılabilir. Pratikte bunlar, genellikle yöneticiler tarafından oluşturulan ve daha sonra birçok müşteri hesabıyla paylaşılan negatif anahtar kelime listeleri veya hesaplar arası dönüşüm işlemleri gibi şeylerdir.
Bunlar gibi nesnelerin kaynak adları, API çağrısı gönderdiğiniz hesaba bağlı olarak farklılık gösterir.
Örnek: Hesaplar arası dönüşüm işlemleri
Müşteri hesaplarından biriyle (123-456-7890
) hesaplar arası dönüşüm işlemini paylaşan yönetici hesabımız 987-654-3210
olduğunu varsayalım:
Örneğin, dönüşüm işleminin yeniden inceleme aralığını güncellemek için yönetici hesabına bir API çağrısı yapıldığında, şu kaynak adı kullanılarak paylaşılan nesneye referans verilir: customers/9876543210/conversionActions/257733534
.
Paylaşılan dönüşüm işlemini etkinleştirmesi için müşteri hesabına bir API çağrısı yapıldığında, kaynak adı kullanılarak ilgili kaynak adı kullanılır:
customers/1234567890/conversionActions/257733534
.
Bu, temel dönüşüm işleminin aynısıdır ancak kaynak adı, söz konusu dönüşüm işlemine erişmek için kullanılan hesapla ilişkilidir.