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 genelindeki bütçeleri ve tarihleri de belirtebilirsiniz.

Kaynaklar

Kaynaklar, Search Ads 360 hesabınızdaki öğeleri temsil eder. Örnek kaynaklar: Customer, Campaign ve AdGroup.

Nesne kimlikleri

Search Ads 360'taki her nesne kendi kimliğiyle tanımlanır. Bazı kimlikler tüm Search Ads 360 hesaplarında geçerli olacak şekilde dünya genelinde benzersizdir. Diğer kimlikler ise yalnızca sınırlı bir kapsamda 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 dünya genelinde benzersizdir.
Özet akışı kimliği Global
Feed Öğesi Kimliği Global
Feed Özelliği Kimliği Feed
Feed 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 reklamı ifade 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 kimlikli 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, kaynaklarla ilgili meta verileri (ör. bir kaynak için kullanılabilen özellikler 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ğini alan bir GET istek yöntemi sağlar. Bu, bir kaynağın yapısını incelemek için yararlıdır.

Tüzel kişiye özel hizmetlere örnekler: