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

Önemli Nokta: Google Ads API kullanımları göreli kaynak adları (ve tam kaynak adları değildir .

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).

Önemli Bilgi: JSON isteği ve yanıt gövdelerindeki kaynak adları resourceName alanı için name Google Cloud API'lerinde olduğu gibidir. Birçok Google Ads varlığının adı vardır özellikler (campaign.Name, adGroup.Name vb.) olduğundan resourceName mevcut nesne adlarıyla çakışmayı önlemek için kullanılır.

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:

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.