Search Ads 360 Reporting API yapısı

Search Ads 360 Reporting API'nin temel bileşenleri kaynaklar ve hizmetlerdir. 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ı, nesnelerin hiyerarşisidir.

  • Bir hesabın en üst düzey kaynağı customer'dır.

  • 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. Örnek kaynaklar arasında Customer, Campaign ve AdGroup yer alır.

Nesne kimlikleri

Search Ads 360'taki her nesne kendi kimliğiyle tanımlanır. Bazı kimlikler genel olarak benzersizdir (yani tüm Search Ads 360 hesaplarında), diğerleri 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 global olarak benzersizdir.
AdGroupCriterion ID Reklam Grubu

Her AdGroupId / CriterionId çifti global olarak benzersizdir.
CampaignCriterion ID Kampanya

Her CampaignId / CriterionId çifti global olarak benzersizdir.
Reklam Uzantıları Kampanya

Her CampaignId / AdExtensionId çifti global olarak benzersizdir.
Özet akışı kimliği Global
Feed Item ID (Feed Öğesi Kimliği) Global
Feed Özelliği Kimliği Feed
Feed eşleme kimliği Global
Etiket Kimliği Global
UserList ID Global

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

Nesne türleri

Bazı nesneler birden fazla öğe 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ını 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 yolda birleştiren bir resource_name dizesiyle benzersiz şekilde tanımlanır.

Örneğin, kampanya kaynağı adları şu biçimdedir:

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Müşteri kimliği 987654 olan Search Ads 360 hesabındaki 1234567 kimlikli bir kampanyanın resource_name:

customers/1234567/campaigns/987654

Hizmetler

Hizmetler, Search Ads 360 öğelerinizi 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 ve birleştirilmiş hizmettir. Search ve SearchStream olmak üzere iki yöntem sunar. Her iki yöntemde de sorgulanacak kaynağı, alınacak kaynak özelliklerini ve performans metriklerini, isteği filtrelemek için kullanılacak yüklemleri ve performans istatistiklerini daha ayrıntılı olarak incelemek için kullanılacak segmentleri belirten bir sorgu gerekir. Daha fazla bilgi için Arama raporları oluşturma ve Search Ads 360 Sorgu Dili başlıklı makaleleri inceleyin.
Saha servisi
SearchAds360FieldService Kaynaklarla ilgili 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 kataloğu isteyebilirsiniz. Daha fazla bilgi için Kaynak meta verilerini alma başlıklı makaleyi inceleyin.
Tüzel kişiye özgü 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.

İşletmeye özel hizmetlere örnekler: