Reporting API
Reporting API, satıcıların performans verileriyle etkileşimde bulunmasını sağlar Merchant Center Sorgu Dili aracılığıyla programatik olarak. Şuna benzer: sahip olma özel raporlar oluşturma Merchant Center'da bulabilirsiniz. Reporting API'nin sunduğu avantajlar şunlardır:
- Büyük satıcıların ürün listelemelerine ait performans verilerini Google Ads'e aktarmasına olanak tanır. rapor sistemlerine göz atın.
- Satıcıyı yöneten kullanıcılara, üçüncü taraf iş ortaklarına ve toplayıcılara izin verir Merkezi hesap erişim raporları.
API kullanıcıları, Arama yanıtı, ö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), çeşitli ölçütlere göre segmentlere ayrılmış
boyutları (program, tarih ve ürün gibi bildirilen etkinlik özellikleri)
marka, kategori vb. gibi özellikleri) kullanarak kampanya düzeyinde Search yöntemini kullanarak
Reports hizmeti.
Reports hizmetine yapılan sorgu sonucunda ReportRow listesi oluşturulur
örnekleri (her ReportRow, istenen metriklerin değerlerini temsil eder)
seçmeniz gerekir. Hiçbir segment belirtilmezse tek bir segment
satırı, tüm segmentler genelinde toplanan metriklerle döndürülür. Aksi takdirde
Segmentler metriklerle birlikte istenir, ardından yanıtta şunun için bir satır gösterilir:
her bir benzersiz segment deleni. Birden fazla segment seçebilir ve
tek bir sorguda birden çok metrik olması gerekir.
Metrikler için sorgu
İstediğiniz metrikleri (Tıklamalar, Gösterimler, TO vb.) için sorgulayabilirsiniz geri döndü. Raporları sorgulamak için tarih aralığına bir filtre eklemeniz gerekir. hizmet. Aşağıdaki örnek sorgu tek bir satır döndürür: toplam tutar belirli bir tarih aralığının eklenen koşulu içinde gerçekleşen tıklamaların sayısı.
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 nasıl 4.440 tıklama aldığını göstermektedir ve tüm ürünleri genelinde toplanmış olması gerekir. 1 Aralık 2020 ve 21 Aralık 2020 tarihleri.
{"results": [
{
"metrics": {
"clicks": "4,440"
}
}
]}
Segmentlerle ilgili sorgu
Metriklerin yanı sıra,
bildirilen bir ürünün özelliği (offer_id, brand, category vb.)
etkinlik (date, program). Raporlanan etkinlik, bir
belirler.
Segmentler SQL'deki GROUP BY ile benzer şekilde çalışır. Segmentler seçilenleri böler
metrikleri (SELECT ifadesindeki her segmente göre gruplama) yapılır. Aşağıdaki örnek sorgu
eklenen koşul dahilinde azalan tıklama sayısına göre sıralanmış şekilde günlük tıklama sayısı döndürür
seçmeniz gerekir. Yalnızca istenen metriklerden en az birinin sıfır olmadığı satırlar
iade edilir.
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 nasıl 1.546 tıklama aldığını göstermektedir. 1 Aralık 2020 itibarıyla tüm hedefleri genelinde tüm ürünlerinde geçerli olacak. ve Google'daki tüm hedeflerinde tüm ürünlerinde 829 tıklama 2 Aralık 2020. 3 Aralık 2020 tarihinden bu yana hiçbir nesne döndürülmeyecektir Satıcı o gün hiçbir tıklama almamıştır.
{
"results": [
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 1
}
},
"metrics": {
"clicks": "1546"
}
},
{
"segments": {
"date": {
"year": 2020,
"month": 12,
"day": 2
}
},
"metrics": {
"clicks": "829"
}
}
]}