Search Ads 360 Reporting API yapısı

Search Ads 360 Reporting API'nin birincil bileşenleri kaynaklar ve hizmetlerdir. Kaynak, bir Search Ads 360 varlığını temsil eder. Siz de Search Ads 360 varlıklarını almak için bir hizmet kullanırsınız.

Nesne hiyerarşisi

Search Ads 360 hesabı, nesnelerden oluşan bir hiyerarşisidir.

  • Hesapları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 ya da daha fazla AdGroupCriterion veya CampaignCriterion ekleyebilirsiniz. Ölçütler, reklamların nasıl tetikleneceğini tanımlar.

    • Anahtar kelime, yaş grubu ve konum gibi birçok ölçüt türü mevcuttur. Kampanya düzeyinde tanımlanan ölçütler, kampanya içindeki diğer tüm kaynakları etkiler. Kampanya genelinde bütçeler ve tarihler de belirtebilirsiniz.

Kaynaklar

Kaynaklar, Search Ads 360 hesabınızdaki varlıkları 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 genel olarak benzersizdir. Diğer bir deyişle, tüm Search Ads 360 hesaplarında diğerleri, yalnızca sınırlı bir kapsamda benzersizdir.

Nesne kimliği 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, genel olarak benzersizdir.
AdGroupCriterion Kimliği Reklam Grubu

Her AdGroupId / CriterionId çifti, genel olarak benzersizdir.
Kampanya Ölçütü Kimliği Kampanya

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

Her CampaignId / AdExtensionId çifti, genel olarak benzersizdir.
Özet akışı kimliği Global
Özet Akışı Öğesi Kimliği Global
Feed Özellik Kimliği Feed
Özet Akışı Eşleme Kimliği Global
Etiket Kimliği Global
Kullanıcı Listesi Kimliği Global

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

Nesne türleri

Bazı nesneler, birden çok varlık türü için kullanılabilir. Böyle bir durumda, nesne, içeriğini açıklayan bir type alanı içerir. Örneğin AdGroupAd bir metin reklama, otel reklamına veya yerel reklama atıfta bulunabilir. Tür değerine AdGroupAd.ad.type alanından erişebilirsiniz. Değeri, AdType sıralamasında döndürülür.

Kaynak adları

Her kaynak, kaynağı ve üst öğelerini bir yolda birleştiren bir resource_name dizesiyle benzersiz bir şekilde tanımlanır.

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

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Search Ads 360 hesabında 987654 kimliğine sahip ve 1234567 müşteri kimliğine sahip bir kampanya resource_name:

customers/1234567/campaigns/987654

Hizmetler

Hizmetler, Search Ads 360 öğelerinizi ve meta verilerinizi almanızı sağlar. Üç hizmet türü vardır:

Arama hizmeti
SearchAds360Service, tüm kaynak nesnelerini ve performans istatistiklerini alan tek ve birleştirilmiş hizmettir. İki yöntem sunar: Search ve SearchStream. Her iki yöntem de sorgulanacak kaynağı, alınacak kaynak özelliklerini ve performans metriklerini, isteği filtrelemek için kullanılacak şartları ve performans istatistiklerini daha ayrıntılı bir şekilde analiz etmek için kullanılacak segmentleri belirten bir sorgu gerektirir. Daha fazla bilgi için Arama raporları oluşturma ve Search Ads 360 Sorgu Dili bölümlerine bakın.
Saha hizmeti
SearchAds360FieldService, kaynaklarla ilgili meta verileri (ör. bir kaynak için kullanılabilir özellikler ve onun veri türü) alır. SearchAds360Service arama yöntemlerinde bulunan kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için kataloğu isteyebilirsiniz. Daha fazla bilgi edinmek için Kaynak meta verilerini alma bölümüne bakın.
Tüzel kişiye özgü hizmetler

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

Varlığa özel hizmetlere örnek olarak şunlar verilebilir: