Performance reports

Merchant API, ProductPerformanceView gibi performans raporları sunar. Bu sayfada performans raporlarının yapısı açıklanmaktadır.

Metrikler

Döndürülmesini istediğiniz metrikleri (örneğin, clicks ve impressions) sorgulayabilirsiniz. Raporlar hizmetini performans verileri için sorgulamak amacıyla tarih aralığına bir filtre eklemeniz gerekir.

Aşağıda, belirtilen tarih aralığındaki toplam tıklama sayısıyla birlikte tek bir satır döndüren örnek bir sorgu verilmiştir:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

Döndürülmesini istediğiniz verileri belirtmelisiniz. Joker karakterler (ör. SELECT *) hata döndürür.

Aşağıdaki örnek yanıt, satıcının 1 Aralık 2020 ile 21 Aralık 2020 tarihleri arasında tüm pazarlama yöntemleri genelinde tüm ürünlerde toplam 4.440 tıklama aldığını göstermektedir.

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

Segmentler

Segment alanlarını sorgulamak için MCQL'yi kullanabilirsiniz. Segment alanları, ürün özellikleri (ör. offerId, brand ve category) veya etkinlik özellikleri (ör. date ve marketingMethod) olabilir.

Segment alanları SQL'deki GROUP BY ile benzer şekilde davranır. Segment alanları, seçili metrikleri SELECT ifadesindeki her segmente göre gruplandırarak böler.

Aşağıda, bir tarih aralığının ek koşulunda clicks ölçütüne göre azalan düzende günlük tıklama sayısını döndüren örnek bir sorgu verilmiştir. Yalnızca istenen metriklerden en az birinin sıfır olmadığı satırlar döndürülür.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

Aşağıdaki örnek yanıt, satıcının 1 Aralık 2020'de tüm ürünlerde, tüm pazarlama yöntemlerinde 1.546 tıklama ve 2 Aralık 2020'de tüm pazarlama yöntemleri genelinde tüm ürünlerde 829 tıklama aldığını göstermektedir. Satıcı, 3 Aralık 2020 tarihinde tıklama almadığından bu tarihe ilişkin hiçbir şey döndürülmedi.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}