Ad hiyerarşisi
Google Ads API'de kullanılan kaynak adları, Google Ads'deki öğelerin organizasyonunu yansıtan hiyerarşik bir yapıya sahiptir. Hemen hemen 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ğ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, hiyerarşideki her nesneyi tanımlayan benzersiz sayısal kaynak kimliklerine sahip olabileceğini unutmayın. Bu tür durumlarda, bu kaynak kimliklerini ayıklamak ve yeni bir kaynak kimliği oluşturmak için kaynak adını ayrıştırmak yararlı 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ış) ayrılabilir:
| 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ı oluşturmanıza olanak tanır.
Paylaşılan nesnelerin tanımlayıcıları
API'deki nesnelerin çoğu belirli bir Google Ads müşterisiyle ilişkilidir. Ancak birden fazla hesap arasında paylaşılabilen bazı nesne türleri vardır. Uygulamada bunlar genellikle yöneticiler tarafından oluşturulup 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ı dönüşüm işlemini müşteri hesaplarından biri olan 123-456-7890 ile paylaşan 987-654-3210 yönetici hesabına sahip olduğumuzu varsayalım:
Örneğin, dönüşüm işleminin yeniden inceleme aralığını güncellemek için yönetici hesabına API çağrısı yapmak, paylaşılan nesneyi kaynak adı customers/9876543210/conversionActions/257733534 kullanarak referans verir.
Paylaşılan dönüşüm işlemini etkinleştirmek için müşteri hesabına API çağrısı yapıldığında, bu işleme kaynak adı (customers/1234567890/conversionActions/257733534) kullanılarak referans verilir.
Bu, temeldeki dönüşüm işlemiyle aynıdır ancak kaynak adı, erişmek için kullanılan hesaba göre değişir.