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"
}
}
]
}