Yeni Search Ads Reporting API'deki yeni kavramlar

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. Artık önceden tanımlanmış rapor türleri istemek yerine, yeni bir SQL benzeri sorgu dili kullanarak tüm kaynakları sorgulayabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Reporting API yapısı başlıklı makaleyi inceleyin.

Arama raporları

Arama, yeni API'de kendi hizmetine sahiptir. Arama hizmeti, eski Raporlar hizmetinin yerini alıyor. Tüm sorgular, raporlama verilerini ve metriklerini aramak ve almak için iki yöntem (SearchStream ve Search) sağlayan SearchAds360Service üzerinden geçer. Her iki arama yöntemi de arama sorgunuzla eşleşen tüm SearchAds360Row nesneleri döndürür. Daha fazla bilgi için Arama raporları oluşturma başlıklı makaleyi inceleyin.

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 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ını kullanır. Örneğin, campaign.id ve ad_group.id. Ayrıca, örneğin ad_group.campaign.id gibi daha fazla iç içe yerleştirme yapabilirsiniz. Daha fazla bilgi edinmek için Search Ads 360 Reporting API yapısı başlıklı makaleyi inceleyin.

Önceki Search Ads 360 API'sinde raporlama, benzer kavramlar için farklı öğelerdeki ayrı alanlara dayanır. Örneğin, hem campaign hem de adgroup raporlarında ayrı bir campaignId alanı bulunur.

Sorgu dili

API, Search Ads 360 sorgu dilini kullanıma sunar. Bu, işletmenize en uygun belirli raporlama verilerini almak için sorgular tanımlamanıza olanak tanıyan, SQL benzeri esnek bir dildir. Daha fazla bilgi edinmek için Search Ads 360 sorgu diline bakın.

İstekleri alma

Yeni API'de arama için ayrı bir hizmet (SearchAds360Service) bulunur ancak GET istekleri her bir öğenin kendi hizmetinde yer almaya devam eder. Örneğin, CustomColumnService öğesinden özel sütun bilgileri alabilirsiniz. Daha fazla bilgi 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 hesaba ait CustomColumn kaynakları isteyebilirsiniz.

Hesap yönetimi

Yeni Search Ads 360; hesapları yönetici hesapları, alt yönetici hesapları ve müşteri hesapları arasında bir hiyerarşi şeklinde düzenler. Önceki Search Ads 360'ta yönetici hesabı ajans hesabını, alt yönetici hesapları ise reklamveren hesaplarını temsil ediyordu. 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 raporlama verilerini almak istediğiniz her hesap için istek gönderebilirsiniz.

Hesap hiyerarşisindeki değişiklik sonucunda, reklamveren/ajans kavramıyla ilgili alanlar, mümkün olan her yerde işlevsel eşitlik sağlamak için uygun alternatiflerle değiştirildi. Etkilenen alanların ve bunların yerine kullanılan alanların listesi için Alan eşlemeleri başlıklı makaleyi inceleyin.

Giriş müşteri kimliği üstbilgisi

login-customer-id, bir alt yönetici veya müşteri hesabına erişmek için yönetici hesabı kullanılırken gerekli olan yeni bir üstbilgidir. Daha fazla bilgi için Giriş müşteri kimliği üstbilgisi başlıklı makaleyi inceleyin.

Sürüm oluşturma

Search Ads 360 Reporting API, anlamsal sürüm oluşturma kullanır. vMAJOR_MINOR biçiminde 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.