Search Ads 360 Reporting API, modern bir platformu temel alır ve çeşitli yeni konseptler sunar. Bunlar aşağıdaki bölümlerde açıklanmıştır.
Kaynaklar
Kaynak nesneleri, rapor türlerinin yerini alır. Önceden tanımlanmış rapor türleri istemek yerine, artık tüm kaynakları SQL benzeri yeni bir sorgu dili kullanarak sorgulayabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Reporting API yapısına göz atın.
Arama raporları
Yeni API'de Arama'nın kendi hizmeti var. Arama hizmeti, eski Raporlar hizmetinin yerini alır. Tüm sorgular, raporlama verilerini ve metriklerini aramak ve almak için SearchStream
ve Search
olmak üzere iki yöntem sunan SearchAds360Service
üzerinden 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 raporu oluşturma başlıklı makaleyi inceleyin.
Kaynak meta verileri
SearchAds360FieldService
, SearchAds360Service
arama yöntemlerinde kullanılabilen kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için kataloğu dinamik olarak istemenize olanak tanır. Daha fazla bilgi için Kaynak meta verilerini alma başlıklı makaleyi inceleyin.
Alan adları
API, nokta gösterimiyle ayrılmış iç içe yerleştirilmiş alan adları sunar. Örneğin, campaign.id
ve ad_group.id
. İsterseniz daha fazla iç içe yerleştirebilirsiniz (örneğin, ad_group.campaign.id
). Daha fazla bilgi edinmek için Search Ads 360 Reporting API yapısı bölümüne bakın.
Önceki Search Ads 360 API'deki raporlama, benzer kavramlar için farklı öğelerdeki ayrı alanlara dayanır. Örneğin, hem campaign
hem de adgroup
raporları ayrı bir campaignId
alanına sahiptir.
Sorgu dili
API, Search Ads 360 Sorgu Dili'ni kullanıma sunar. Bu, işletmenize en uygun belirli raporlama verilerini almak için sorgular tanımlamanızı sağlayan, SQL benzeri esnek bir dildir. Daha fazla bilgi edinmek için Search Ads 360 Sorgu Dili başlıklı makaleyi inceleyin.
İstekler alma
Yeni API'de aramanın kendi hizmeti (SearchAds360Service
) vardır ancak GET
istekleri her öğenin kendi hizmetinde mevcuttur. Örneğin, özel sütun bilgilerini CustomColumnService
üzerinden alabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Reporting API'deki biçim değişiklikleri başlıklı makaleyi inceleyin.
Ö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 olmanız koşuluyla, hesap ağacındaki herhangi bir hesabın sahip olduğu CustomColumn
kaynaklarını isteyebilirsiniz.
Hesap yönetimi
Yeni Search Ads 360, hesapları yönetici hesapları, alt yönetici hesapları ve müşteri hesapları hiyerarşisinde düzenler. Yönetici hesabı ajans hesabını, alt yönetici hesapları ise önceki Search Ads 360'ta reklamveren hesaplarını temsil eder. Daha fazla bilgi için Search Ads 360 yönetici hesapları hakkında başlıklı makaleyi inceleyin.
Hesap ağacını sorgulayabilir ve ardından verilerini raporlamak istediğiniz her hesap için istek gönderebilirsiniz.
Hesap hiyerarşisindeki değişikliğin bir sonucu olarak reklamveren/ajans konseptiyle ilgili alanlar, mümkün olan her yerde işlevsel denklik sağlamak için uygun alternatiflerle değiştirilmiştir. Etkilenen alanların ve bunların yedeklerinin listesi için Alan eşlemeleri bölümüne bakın.
Giriş müşteri kimliği başlığı
login-customer-id
, alt yönetici veya müşteri hesabına erişmek için yönetici hesabı kullanılırken gerekli olan yeni bir başlıktır. Daha fazla bilgi için Giriş müşteri kimliği başlığı bölümüne bakın.
Sürüm oluşturma
Search Ads 360 Reporting API, anlamsal sürümleme kullanır.
vMAJOR_MINOR
biçiminde ana ve alt sürümler vardır. Daha fazla bilgi için Sürüm oluşturma bölümüne bakın.