Ad hiyerarşisi
Search Ads 360 Reporting API'de kullanılan kaynak adları, Search Ads 360'taki öğ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 Search Ads 360 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
Search Ads 360 Reporting API varlıkları (müşteriler, kampanyalar vb.), API genelinde 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 gibi 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 grubunun 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.