Merchant API, performans raporları sunar. Örneğin,
product_performance_view.
Bu sayfada performans raporlarının yapısı açıklanmaktadır.
Metrikler
Döndürülmesini istediğiniz metrikleri (ör. clicks ve impressions) sorgulayabilirsiniz. Performans verileri için Raporlar hizmetini sorgulamak üzere tarih aralığına bir filtre eklemeniz gerekir.
Aşağıda, belirtilen tarih aralığındaki toplam tıklama sayısını içeren tek bir satır döndüren örnek bir sorgu verilmiştir:
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
Döndürülmesini istediğiniz verileri belirtmeniz gerekir. Joker karakterler (ör. SELECT
*) hata döndürür.
Aşağıdaki örnek yanıtta, satıcının 1 Aralık 2023 ile 21 Aralık 2023 tarihleri arasında tüm ürünlerde ve tüm pazarlama yöntemlerinde toplam 4.440 tıklama aldığı gösterilmektedir.
{
"results": [
{
"productPerformanceView": {
"clicks": "4440"
}
}
]
}
Segmentler
Performans raporlarında segmentasyon için segment alanlarını kullanabilirsiniz.
Örneğin, marketing_method için sorgu gönderildiğinde her pazarlama yöntemi için bir satır ve SELECT ifadesinde bu pazarlama yöntemi için belirttiğiniz metrikleri içeren bir rapor döndürülür.
Segment alanları, ürün özellikleri (ör. offer_id, brand ve category) veya etkinlik özellikleri (ör. date ve marketing_method) olabilir.
Segment alanları, SQL'deki GROUP BY ifadesine benzer şekilde çalışır. Segment alanları, seçilen metrikleri SELECT yan tümcesindeki her bir segmente göre gruplandırarak böler.
Aşağıda, tarih aralığı koşulu eklenmiş olarak, günlük tıklama sayısını clicks değerine göre azalan düzende 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 product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
Aşağıdaki örnek yanıtta, satıcının 1 Aralık 2023'te tüm ürünlerde ve tüm pazarlama yöntemlerinde 1.546 tıklama, 2 Aralık 2023'te ise tüm ürünlerde ve tüm pazarlama yöntemlerinde 829 tıklama aldığı gösterilmektedir. Satıcı 3 Aralık 2023'te hiç tıklama almadığı için bu tarihle ilgili hiçbir sonuç döndürülmez.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
Merchant Center'daki özel raporlarda olduğu gibi, Merchant Reports API ile aynı sorguda birden fazla segment belirtebilirsiniz.
Aşağıda, hesabınızdaki tüm ürünlerin 30 günlük bir dönemdeki tıklamalarını marketing_method ve offer_id ölçütlerine göre segmentlere ayrılmış olarak döndüren örnek bir sorgu verilmiştir:
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
Bu sorgudan gelen yanıt, her offer_id ve marketing_method kombinasyonu için bir satır içerir ve bu kombinasyonun tıklama sayısını gösterir:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
Kategori ve ürün türü
Merchant Center Sorgu Dili, metrikleri envanterinizi düzenlemek için tanımlayabileceğiniz iki özellik grubuna göre segmentlere ayırmayı destekler:
- Kategori seviyeleri
- Google'ın ürün sınıflandırmasındaki kategoriler. Kategori belirtilmediyse Google, ürüne otomatik olarak kategori atayabilir veya belirtilen kategoriyi daha da hassaslaştırabilir.
- Ürün türü seviyeleri
- Kategorilendirmenize bağlı olarak atadığınız ürün türleri. Kategori düzeylerinin aksine, önceden tanımlanmış bir desteklenen değer grubu yoktur.
Hem kategori hem de ürün türü özellikleri, birden fazla düzey içeren bir hiyerarşi içinde düzenlenir. Ürün spesifikasyonu, her seviyeyi > karakteriyle ayırır ancak raporlarda hiyerarşinin her seviyesini ayrı ayrı seçersiniz.
Örneğin, aşağıdaki ürün türü düzeylerine sahip bir ürünü ele alalım:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
Raporlar her seviyeyi kendi alanında döndürür:
| Segment | Değer |
|---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
Para birimi ve fiyat metrikleri
conversion_value gibi fiyat metrikleri, Price türü kullanılarak temsil edilir. Metrik birden fazla para biriminde kullanılabiliyorsa her para biriminin değeri ayrı bir satırda döndürülür. Örneğin, aşağıdaki sorgu:
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
aşağıdaki sonuçları döndürür:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Bir sorguda hem fiyat hem de fiyat dışı metrikler isterseniz fiyat metrikleri, fiyat dışı metriklerden ayrı sonuç satırlarında (para birimi kodu başına bir sonuç satırı) döndürülür. Örneğin, aşağıdaki sorgu:
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
şu yanıtı döndürür:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Seçtiğiniz tüm alanlar, değerleri varsayılan değer veya sıfır olsa bile yanıtta döndürülür.
Sorgu için kullanılabilen alanlar hakkında daha fazla bilgi edinmek isterseniz productPerformanceView tablosundaki alanlar başlıklı makaleyi inceleyin.