Yeni Search Ads Reporting API'deki yeni kavramlar

Search Ads 360 Reporting API, modern bir platformu temel alır ve bir dizi yeni kavram sunar. Bunlar aşağıdaki bölümlerde açıklanmaktadır.

Kaynaklar

Kaynak nesneleri rapor türlerinin yerini alır. Önceden tanımlanmış rapor türlerini istemek yerine, artık SQL benzeri yeni bir sorgu dili kullanarak tüm kaynakları sorgulayabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Raporlama API'si yapısı konusuna bakın.

Arama raporlaması

Yeni API'de Arama'nın kendi hizmeti var. Arama hizmeti, eski Raporlar hizmetinin yerini almaktadır. Tüm sorgular, raporlama verilerini ve metrikleri aramak ve almak için SearchStream ve Search olmak üzere iki yöntem sunan SearchAds360Service'dan geçer. Her iki arama yöntemi de arama sorgunuzla eşleşen tüm SearchAds360Row nesnelerini döndürür. Daha fazla bilgi için Arama raporları oluşturma bölümüne bakın.

Kaynak meta verileri

SearchAds360FieldService, SearchAds360Service arama yöntemlerinde bulunan kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için kataloğu dinamik olarak istemenize olanak tanır. Daha fazla bilgi edinmek için Kaynak meta verilerini alma bölümüne bakın.

Alan adları

API, nokta gösterimiyle ayrılmış iç içe yerleştirilmiş alan adları sunar. Örneğin, campaign.id ve ad_group.id. Ayrıca, ad_group.campaign.id gibi başka iç içe yerleştirme de yapabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Raporlama API'si yapısı konusuna bakın.

Önceki Search Ads 360 API'deki raporlama, benzer kavramlar için farklı varlıklardaki ayrı alanları temel alır. Örneğin, hem campaign hem de adgroup raporlarında ayrı bir campaignId alanı bulunur.

Sorgu dili

API, Search Ads 360 Sorgu Dili'ni kullanıma sundu. Bu, işletmenize en uygun belirli raporlama verilerini almak için sorgular tanımlamanıza olanak tanıyan esnek, SQL benzeri bir dildir. Daha fazla bilgi için Search Ads 360 Sorgu Dili bölümüne bakın.

İstek al

Yeni API'de aramanın kendi hizmeti (SearchAds360Service) vardır ancak GET istekleri her varlığa özel hizmette kalmaya devam eder. Örneğin, özel sütun bilgilerini CustomColumnService'dan alabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Reporting API'deki biçim değişiklikleri bölümüne bakın.

Özel sütunlar

Yeni Search Ads 360'ta formül sütunları ve özel dönüşümler, özel sütunlar olarak adlandırılır. Özel sütunlar hakkında daha fazla bilgi edinin. Yeni CustomColumnService özel sütunları etkinleştirir. Gerekli izinlere sahip olduğunuz sürece hesap ağacındaki herhangi bir hesaba ait CustomColumn kaynaklarını isteyebilirsiniz.

Hesap yönetimi

Yeni Search Ads 360; yönetici hesapları, alt yönetici hesapları ve müşteri hesaplarından oluşan bir hiyerarşi oluşturarak hesapları düzenler. Önceki Search Ads 360'ta yönetici hesabı ajans hesabını, alt yönetici hesapları ise reklamveren hesaplarını temsil eder. Daha fazla bilgi edinmek için Search Ads 360 yönetici hesapları hakkında konusuna bakın.

Hesap ağacını sorgulayabilir ve ardından verilerini raporlamak istediğiniz her bir hesap için istek gönderebilirsiniz.

Hesap hiyerarşisindeki değişikliğin bir sonucu olarak, mümkün olduğunda işlevsel denklik sağlamak için reklamveren/ajans konseptiyle ilgili alanlar uygun alternatiflerle değiştirildi. Etkilenen alanlar ve yedeklerinin listesi için Alan eşlemeleri bölümüne bakın.

Giriş müşteri kimliği başlığı

login-customer-id, bir alt yönetici veya müşteri hesabına erişmek için yönetici hesabı kullanırken gerekli olan yeni bir başlıktır. Daha fazla bilgi için Giriş müşteri kimliği üstbilgisi bölümüne bakın.

Sürüm oluşturma

Search Ads 360 Raporlama API'si anlamsal sürüm oluşturma kullanır. vMAJOR_MINOR olarak biçimlendirilmiş ana ve alt sürümler vardır. Daha fazla bilgi edinmek için Sürüm oluşturma bölümüne bakın.