Reporting API

Reporting API, satıcıların Merchant Center Query Language aracılığıyla performans verileriyle programatik olarak etkileşim kurmasına olanak tanır. Bu, doğrudan Merchant Center'da özel rapor oluşturma özelliğine benzer. Reporting API'nin aşağıdaki avantajları vardır:

  • Büyük satıcıların, ürün listelemeleriyle ilgili performans verilerini dahili veya üçüncü taraf raporlama sistemlerine aktarmasına olanak tanır.
  • Merchant Center hesaplarını yöneten kullanıcıların, üçüncü taraf iş ortaklarının ve toplayıcıların raporlara erişmesine olanak tanır.

API kullanıcıları, Search çağrısı yanıtında hangi performans verilerini almak istediklerini belirtebilir. Örneğin:

  • Döndürülecek metrikler (örneğin: tıklama sayısı, gösterim sayısı)
  • Verilerin segmentlere ayrılacağı boyutlar (örneğin: OfferId, Date)
  • Karşılanması gereken koşullar (örneğin: Tıklamalar > 100)

Reporting API sorgu dili, Search hizmetinde Reports yöntemini kullanarak çeşitli boyutlara (program ve tarih gibi raporlanan etkinlik özellikleri ve marka, kategori gibi ürün özellikleri) göre segmentlere ayrılmış olabilecek performans metrikleri (tıklamalar, gösterimler) için Content API for Shopping'i sorgulayabilir.

Reports hizmetine yapılan bir sorgunun sonucu, ReportRow örneklerinin bir listesidir. Her ReportRow, sorgunuzda belirttiğiniz segmentler için istenen metriklerin değerlerini temsil eder. Segment belirtilmemişse tüm segmentlerde toplanan metriklerle tek bir satır döndürülür. Aksi takdirde, metriklerle birlikte herhangi bir segment istenirse yanıtta her bir benzersiz segment grubu için bir satır gösterilir. Tek bir sorguda birden fazla segment ve birden fazla metrik seçebilirsiniz.

Metrikler için sorgu oluşturma

Döndürülmesini istediğiniz metrikler (tıklama sayısı, gösterim sayısı, TO vb.) için sorgu oluşturabilirsiniz. Raporlar hizmetine sorgu göndermek için tarih aralığına filtre eklemeniz gerekir. Aşağıdaki örnek sorgu tek bir satır döndürür: bir tarih aralığı koşulu eklenerek elde edilen tıklamaların toplam tutarı.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

Örnek yanıt

Aşağıdaki örnek JSON kodu yanıtı, bu satıcının 1 Aralık 2020 ile 21 Aralık 2020 arasında tüm hedeflerindeki tüm ürünlerinde toplam 4.440 tıklama aldığını gösterir.

{"results": [
    {
      "metrics": {
        "clicks": "4,440"
      }
    }
]}

Segmentler için sorgulama

Metriklerin yanı sıra, bir ürünün (offer_id, brand, category vb.) veya bildirilen bir etkinliğin (date, program) özelliği olabilen segmentler için de sorgu oluşturabilirsiniz. Bildirilen etkinlik, bir ürünün gösterimi veya tıklamasıdır.

Segmentler, SQL'deki GROUP BY işlevine benzer şekilde çalışır. Segmentler, seçilen metrikleri SELECT ifadesindeki her segmente göre gruplandırarak böler. Aşağıdaki örnek sorgu, tarih aralığı koşulunda tıklama sayısına göre azalan düzende sıralanmış günlük tıklama sayısını döndürür. Yalnızca istenen metriklerden en az birinin sıfır olmadığı satırlar döndürülür.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

Örnek yanıt

Aşağıdaki örnek JSON kodu yanıtı, bu satıcının 1 Aralık 2020'de tüm hedeflerindeki tüm ürünlerinde 1.546 tıklama, 2 Aralık 2020'de ise tüm hedeflerindeki tüm ürünlerinde 829 tıklama aldığını gösterir. Satıcının o gün tıklaması olmadığı için 3 Aralık 2020'ye ait herhangi bir nesne döndürülmeyecek.

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}
Sonraki
Sorgu dil bilgisi