Reporting API
Reporting API, satıcının Merchant Center Sorgu Dili aracılığıyla performans verileriyle programatik olarak etkileşim kurmasını sağlar. Bu, doğrudan Merchant Center'da özel raporlar oluşturmaya benzer. Reporting API aşağıdaki avantajlara sahiptir:
- Büyük satıcıların, ürün listelemelerine ait performans verilerini dahili veya üçüncü taraf raporlama sistemlerine aktarmalarını sağlar.
- 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 hangi performans verilerini almak istediklerini belirtebilir. Örneğin:
- Döndürülecek metrikler (ör. Tıklamalar, Gösterimler)
- Verilerin segmentlere ayrılacağı boyutlar (ör. OfferId, Date)
- Karşılanması gereken koşullar (örneğin: Tıklama sayısı > 100)
Reporting API sorgu dili, Reports hizmetindeki Search yöntemi kullanılarak Content API for Shopping'i farklı boyutlara (program ve tarih gibi raporlanan etkinlik özellikleri ve marka, kategori gibi ürün özellikleri) göre segmentlere ayrılmış performans metrikleri (tıklama sayısı, gösterim sayısı) için sorgulayabilir.
Reports hizmetine yapılan bir sorgunun sonucunda, ReportRow örneğinden oluşan bir liste oluşturulur. Her ReportRow, sorgunuzda belirttiğiniz segmentler için istenen metriklerin değerlerini temsil eder. Hiçbir segment belirtilmezse tüm segmentlerde toplanan metriklerin yer aldığı tek bir satır döndürülür. Aksi takdirde, metriklerin yanı sıra herhangi bir segment istenirse yanıt, her benzersiz segment demeti için bir satır gösterir. Tek bir sorguda birden çok segment ve birden çok metrik seçmek mümkündür.
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 filtre eklemeniz gerekir. Aşağıdaki örnek sorgu tek bir satır döndürür: Bir tarih aralığının eklenmiş 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 hedeflerindeki tüm ürünlerinde nasıl 4.440 tıklama aldığını göstermektedir.
{"results": [
{
"metrics": {
"clicks": "4,440"
}
}
]}
Segmentler için sorgu
Metriklerin yanı sıra segmentler için de sorgu yapabilirsiniz. Bunlar bir ürünün (offer_id, brand, category vb.) veya raporlanan bir etkinliğin (date, program) özelliği olabilir. Raporlanan etkinlik, bir ürünün gösterimi veya tıklamasıdır.
Segmentler SQL'deki GROUP BY ile benzer şekilde davranır. Segmentler, seçilen metrikleri, SELECT yan tümcesindeki her segmente göre gruplandırarak böler. Aşağıdaki örnek sorgu, günlük tıklama sayısını döndürür ve tıklama sayısına göre, bir tarih aralığının eklenen koşulu içinde azalan düzende sıralanı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 hedefleri genelinde tüm ürünleri genelinde 1.546 tıklama ve 2 Aralık 2020'de tüm satış noktalarındaki tüm ürünlerinde 829 tıklama elde ettiğini göstermektedir. Satıcı, 3 Aralık 2020 tarihinde hiç tıklama almadığından hiçbir nesne döndürülmeyecektir.
{
"results": [
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 1
}
},
"metrics": {
"clicks": "1546"
}
},
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 2
}
},
"metrics": {
"clicks": "829"
}
}
]}