Ad hiyerarşisi
Google Ads API'de kullanılan kaynak adları, Google Ads'deki varlıkların düzenini yansıtan hiyerarşik bir yapıya sahiptir. 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 tüm 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 |
|
||||||
Kimlikleri tek tek ayrıştırmak, reklam grubu reklamının müşterisine (customers/1234567890) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765) referans vermek için 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şkilendirilir. 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ür 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ı bir dönüşüm işlemini müşteri hesaplarından biriyle 123-456-7890 paylaşan bir yönetici hesabımız 987-654-3210 olduğunu varsayalım:
Örneğin, dönüşüm işleminin geri dönüşüm penceresini güncellemek için yönetici hesabına yapılan bir API çağrısında, paylaşılan nesne kaynak adı kullanılarak referans verilir:
customers/9876543210/conversionActions/257733534.
Paylaşılan dönüşüm işlemini kullanmayı etkinleştirmek için istemci hesabına API çağrısı yapıldığında, kaynak adı kullanılarak referans verilir:
customers/1234567890/conversionActions/257733534.
Bu, aynı temel dönüşüm işlemidir ancak kaynak adı, erişmek için kullanılan hesaba göre belirlenir.