Kaynak Adları

Ad hiyerarşisi

Google Ads API'de kullanılan kaynak adları hiyerarşiktir ve Google Ads'deki varlıkların organizasyonu. Kaynakların neredeyse tamamı alt kaynaklardır Customer Bu kaynak, neredeyse her API çağrısının bir özel bir Google Ads hesabıdır. Örneğin kampanyalar, reklam grupları, reklamlar ve anahtar kelimeler tümüyle 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ına (müşteriler, kampanyalar vb.) kaynakları tarafından referans verilir adlarını inceleyeceğiz. Ancak, bu kaynakların adların kendileri de benzersiz sayısal kaynağa sahip olabilir Tanımlayan kimlikler her nesne için bir arada kullanılabilir. Bu durumlarda, kaynak adını tıklayın.

Örneğin, önceki tablodan AdGroupAd kaynak adını inceleyin:

customers/1234567890/adGroupAds/54321098765~2109876543210

Bu, bağımsız kaynak kimliklerine ayrılabilir ( koleksiyon kimlikleri) bulabilirsiniz. şu şekilde:

Kaynak adı bileşenleri
Kaynak Kimlikleri
müşteri kimliği:
"1234567890"
reklam grubu kimliği:
"54321098765"
reklam grubu reklam kimliği:
"2109876543210"
Koleksiyon Kimlikleri
"customers"
"adGroupAds"

Tek tek kimlikleri ayrıştırarak referans verilerek yeni kaynak adları elde edebilirsiniz reklam grubu reklamının müşterisi (customers/1234567890) veya reklam grubu (customers/1234567890/adGroupAds/54321098765).

Paylaşılan nesnelerin tanımlayıcıları

API'deki çoğu nesne belirli tek bir Google Ads ile ilişkilendirilir bir fırsattır. Ancak, birden çok nesne arasında paylaşılabilecek bazı nesne türleri birden çok hesaba sahip olabilir. Pratikte bunlar, negatif anahtar kelime listeler veya hesaplar arası dönüşüm işlemlerini Bunlar genellikle yöneticiler tarafından oluşturulur ve daha sonra birçok müşteri hesabıyla paylaşılır.

Bunlar gibi nesnelerin kaynak adları, hesaba katılmanızı sağlar.

Örnek: Hesaplar arası dönüşüm işlemleri

Hesaplar arası hesabı paylaşan 987-654-3210 adlı yönetici hesabımız olduğunu varsayalım müşteri hesaplarından biriyle dönüşüm işlemi 123-456-7890:

Kaynak adlarının hesap hiyerarşileriyle ilişkisini gösteren şema.

Dönüşüm Optimize Edici'yi güncellemek gibi işlemler için yönetici hesabına bir API çağrısı yapmak işlemin yeniden inceleme aralığı, kaynak adını kullanarak paylaşılan nesneye başvuruda bulunur: customers/9876543210/conversionActions/257733534

Paylaşılan dönüşüm işlemi, kaynak adını kullanarak ona referans verir: customers/1234567890/conversionActions/257733534.

Bu, temel dönüşüm işleminin aynısı ancak kaynak adı göreli hesaba giriş yapar.