Search Ads 360 Reporting API yapısı

Search Ads 360 Reporting API'nin birincil bileşenleri kaynaklar ve hizmetler'dir. Kaynak, bir Search Ads 360 öğesini temsil eder ve Search Ads 360 öğelerini almak için bir hizmet kullanırsınız.

Nesne hiyerarşisi

Search Ads 360 hesabı, nesne hiyerarşisidir.

  • Hesabın üst düzey kaynağı müşteridir.

  • Her hesapta bir veya daha fazla etkin kampanya bulunur.

  • Her Campaign, reklamlarınızı mantıksal koleksiyonlar halinde gruplandıran bir veya daha fazla reklam grubu içerir.

  • Her AdGroup, bir veya daha fazla reklam grubu reklamı içerir.

  • Bir reklam grubuna veya kampanyaya bir veya daha fazla AdGroupCriterion ya da CampaignCriterion ekleyebilirsiniz. Ölçütler, reklamların nasıl tetikleneceğini tanımlar.

    • Anahtar kelimeler, yaş aralıkları ve konumlar gibi birçok ölçüt türü vardır. Kampanya düzeyinde tanımlanan ölçütler, kampanyadaki diğer tüm kaynakları etkiler. Kampanya genelinde bütçeler ve tarihler de belirtebilirsiniz.

Kaynaklar

Kaynaklar, Search Ads 360 hesabınızdaki öğeleri temsil eder. Kaynaklara örnek olarak Customer, Campaign ve AdGroup verilebilir.

Nesne Kimlikleri

Search Ads 360'taki her nesne kendi kimliğiyle tanımlanır. Bazı kimlikler global olarak benzersizdir, yani tüm Search Ads 360 hesaplarında benzersizdir. Bazı kimlikler ise yalnızca sınırlı bir kapsam dahilinde benzersizdir.

Nesne kimliğinin benzersizlik kapsamı
Bütçe Kimliği Global
Kampanya Kimliği Global
Reklam Grubu Kimliği Global
Reklam Kimliği Reklam Grubu

Her AdGroupId / AdId çifti dünya genelinde benzersizdir.
AdGroupCriterion kimliği Reklam Grubu

Her AdGroupId / CriterionId çifti dünya genelinde benzersizdir.
CampaignCriterion kimliği Kampanya

Her CampaignId / CriterionId çifti dünya genelinde benzersizdir.
Reklam Uzantıları Kampanya

Her CampaignId / AdExtensionId çifti genel olarak benzersizdir.
Özet akışı kimliği Global
Feed Öğe Kimliği Global
Feed Özelliği Kimliği Feed
Özet Akışı Eşleme Kimliği Global
Etiket Kimliği Global
UserList kimliği Global

Bu kimlik kuralları, Search Ads 360 nesneleriniz için yerel depolama alanı tasarlarken yararlı olabilir.

Nesne türleri

Bazı nesneler birden fazla varlık türü için kullanılabilir. Bu durumda, nesne içeriğini açıklayan bir type alanı içerir. Örneğin AdGroupAd bir metin reklam, otel reklamı veya yerel reklama işaret edebilir. Tür değerine AdGroupAd.ad.type alanı üzerinden erişebilirsiniz. Değeri, AdType enum'unda döndürülür.

Kaynak adları

Her kaynak, kaynağı ve üst öğelerini bir yola bağlayan bir resource_name dizesi ile benzersiz şekilde tanımlanır.

Örneğin, kampanya kaynak adları şu şekildedir:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Müşteri kimliği 1234567 olan Search Ads 360 hesabında 987654 kimliğine sahip bir kampanyanın resource_name değeri:

customers/1234567/campaigns/987654

Hizmetler

Hizmetler, Search Ads 360 varlıklarınızı ve meta verilerinizi almanıza olanak tanır. Üç hizmet türü vardır:

Arama hizmeti
SearchAds360Service, tüm kaynak nesnelerini ve performans istatistiklerini almak için kullanılan tek, birleşik bir hizmettir. İki yöntem sunar: Search ve SearchStream. Her iki yöntem de sorgulanacak kaynağı, alınabilecek kaynak özelliklerini ve performans metriklerini, isteği filtrelemek için kullanılacak önermelerin yanı sıra performans istatistiklerini daha ayrıntılı şekilde incelemek için kullanılacak segmentleri belirten bir sorgu gerektirir. Daha fazla bilgi için Arama raporu oluşturma ve Search Ads 360 Sorgu Dili başlıklı makalelere göz atın.
Saha hizmeti
SearchAds360FieldService, kaynaklar hakkındaki meta verileri (ör. bir kaynağın kullanılabilir özellikleri ve veri türü) alır. SearchAds360Service arama yöntemlerinde kullanılabilen kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için katalog isteyebilirsiniz. Daha fazla bilgi için Kaynak meta verilerini alma başlıklı makaleyi inceleyin.
Tüzel kişiye özel hizmetler

Bu hizmetler, tek bir kaynak örneği alan bir GET istek yöntemi sağlar. Bu, bir kaynağın yapısını incelemek için yararlıdır.

Varlığa özel hizmetlere örnekler: