Ad hiyerarşisi
Google Ads API'de kullanılan kaynak adları hiyerarşiktir ve Google Ads içindeki varlıkların düzenini yansıtır. Kaynakların neredeyse tamamı Customer
kaynağının alt kaynaklarıdır. Bu kaynak, 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 kelimeler, 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
Google Ads varlıklarına (müşteriler, kampanyalar vb.) API genelinde kaynak adları verilir. Ancak kaynak adlarının, hiyerarşideki her nesneyi tanımlayan benzersiz sayısal kaynak kimlikleri olabileceğini unutmayın. Bu gibi durumlarda, bu kaynak kimliklerini almak ve yeni bir kimlik 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 bağımsız kaynak kimliklerine (koleksiyon kimlikleriyle ayrılmış) ayrılabilir:
Kaynak adı bileşenleri | |||||||
---|---|---|---|---|---|---|---|
Kaynak Kimlikleri |
|
||||||
Koleksiyon Kimlikleri |
|
Kimliklerin ayrı ayrı ayrıştırılması, reklam grubu reklamının müşterisine (customers/1234567890
) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765
) başvuruda bulunacak yeni kaynak adları türetmenize olanak tanır.
Paylaşılan nesnelerin tanımlayıcıları
API'deki çoğu nesne, tek bir belirli Google Ads müşterisiyle ilişkilendirilir. Ancak birden çok hesap arasında paylaşılabilecek bazı nesne türleri de vardır. 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ı, hangi hesaba bir API çağrısı gönderdiğinize bağlı olarak farklılık gösterir.
Örnek: Hesaplar arası dönüşüm işlemleri
123-456-7890
müşteri müşteri hesaplarından biriyle hesaplar arası dönüşüm işlemini paylaşan 987-654-3210
yönetici hesabınızın 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şleminin etkinleştirilmesi için müşteri hesabına bir API çağrısı yapıldığında kaynak adı şu şekilde belirtilir: customers/1234567890/conversionActions/257733534
.
Bu dönüşüm işleminin temelindeki dönüşüm işlemi aynıdır ancak kaynak adı, dönüşüm işlemi için kullanılan hesaba göre belirlenir.