Reporting API
Reporting API, satıcıların Merchant Center Sorgu Dili üzerinden performans verileriyle programatik olarak etkileşim kurmasına olanak tanır. Bu, doğrudan Merchant Center'da özel raporlar oluşturma özelliğine benzer. Reporting API'nin sunduğu avantajlar şunlardır:
- Büyük satıcıların, ürün listelemelerine ait performans verilerini kendi veya üçüncü taraf raporlama sistemlerine aktarmaları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ı, arama çağrısı yanıtında almak istedikleri performans verilerini belirtebilir. Örneğin:
- Döndürülecek metrikler (ör. Tıklamalar, Gösterimler)
- Verilerin segmentlere ayrılacağı boyutlar (ör. OfferId, Tarih)
- Karşılanması gereken koşullar (örneğin: Tıklamalar > 100)
Reporting API sorgu dili, Content API for Shopping'i performans metriklerini (tıklamalar, gösterimler) muhtemelen çeşitli boyutlara (program ve tarih gibi raporlanan etkinlik özellikleri ve marka, kategori gibi ürün özellikleri) göre segmentlere ayrılmış şekilde Reports hizmetinde Search yöntemini kullanarak sorgulayabilir.
Reports hizmetine yapılan sorgu sonucunda, her ReportRow örneğinin sorguda belirttiğiniz segmentler için istenen metriklerin değerlerini temsil ettiği bir ReportRow örnek listesi elde edilir. Herhangi bir segment belirtilmezse tüm segmentler genelinde toplanan metriklerle tek bir satır döndürülür. Aksi takdirde, metriklerin yanı sıra herhangi bir segment istenirse yanıtta her benzersiz segment deliği için bir satır gösterilir. Tek bir sorguda birden fazla segment ve
metrik seçilebilir.
Metrikler için sorgu
Döndürülmesini istediğiniz metrikleri (tıklamalar, gösterimler, TO vb.) sorgulayabilirsiniz. Raporlar hizmetini sorgulamak için tarih aralığına bir filtre eklemeniz gerekir. Aşağıdaki örnek sorgu tek bir satır döndürür: Bu sayı, bir tarih aralığının eklenen koşulu içindeki tıklamaların toplam miktarı.
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 hedefleri genelinde tüm ürünlerinde toplam 4.440 tıklama aldığını göstermektedir.
{"results": [
{
"metrics": {
"clicks": "4,440"
}
}
]}
Segmentlerle ilgili sorgu
Metriklerin yanı sıra segmentleri de sorgulayabilirsiniz. Bunlar, bir ürünün özelliği (offer_id, brand, category vb.) veya bildirilen bir etkinliğin özelliği (date, program) olabilir. Raporlanan etkinlik, bir ürünün gösterimi veya tıklamasıdır.
Segmentler SQL'deki GROUP BY ile benzer şekilde çalışır. Segmentler, seçilen metrikleri bölerek SELECT ifadesindeki her bir segmente göre gruplandırır. Aşağıdaki örnek sorgu, günlük tıklama sayısını, bir tarih aralığının eklenen koşulu dahilinde azalan tıklama sayısına göre sıralanmış şekilde döndürür. Yalnızca en az bir istenen metriğin 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 hedefleri genelinde tüm ürünlerinde 1.546 tıklama ve 2 Aralık 2020'de tüm hedefleri genelinde tüm ürünlerinde 829 tıklama elde ettiğini göstermektedir. Satıcı o gün hiç tıklama almadığından 3 Aralık 2020 için hiçbir nesne döndürülmez.
{
"results": [
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 1
}
},
"metrics": {
"clicks": "1546"
}
},
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 2
}
},
"metrics": {
"clicks": "829"
}
}
]}