Performance reports

Merchant API, product_performance_view gibi performans raporları sunar. 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.

Belirtilen tarih aralığındaki toplam tıklama sayısını içeren tek bir satır döndüren örnek bir sorgu aşağıda 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 (örneğin, 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 pazarlama yöntemleri ve tüm ürünler genelinde toplam 4.440 tıklama aldığı gösterilmektedir.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Önemli Bilgi: Sorgunuzda herhangi bir segment alanı seçmezseniz yalnızca bir satır metrik alırsınız.

Segmentler

Performans raporlarında segmentasyon için segment alanları kullanabilirsiniz. Örneğin, marketing_method için sorgu gönderdiğinizde her pazarlama yöntemi için bir satır ve SELECT yan tümcesinde bu pazarlama yöntemi için belirttiğiniz metrikler 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 alanına benzer şekilde çalışır. Segmentler alanları, seçili metrikleri SELECT yan tümcesinde her segmente göre gruplandırarak böler.

Aşağıda, tarih aralığı koşulu eklenmiş durumda clicks değerine göre azalan düzende günlük tıklamaları döndüren örnek bir sorgu verilmiştir. Yalnızca istenen en az bir metriğin sıfır olmayan 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 pazarlama yöntemleri ve tüm ürünler genelinde 1.546 tıklama, 2 Aralık 2023'te ise tüm pazarlama yöntemleri ve tüm ürünler genelinde 829 tıklama aldığı gösterilmektedir. Satıcının 3 Aralık 2023'te tıklaması olmadığından bu tarih için hiçbir şey 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"
      }
    }
  ]
}

Önemli Bilgi: Belirli segment alanlarını yalnızca metrikleri de seçerseniz seçebilirsiniz. Sorgunuzda herhangi bir metrik seçmezseniz Merchant Reports API bir hata döndürür.

Merchant Center'daki özel raporlarda olduğu gibi, Merchant Reports API ile aynı sorguda birden fazla segment belirtebilirsiniz.

Aşağıda, 30 günlük bir dönemde hesabınızdaki tüm ürünlerin marketing_method ve offer_id'ye göre segmentlere ayrılmış tıklama sayısını 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 alınan yanıt, her offer_id ve marketing_method kombinasyonu için bu kombinasyonun tıklama sayısını içeren bir satır içerir:

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

Dikkat: SELECT ifadenizdeki her segment alanı kombinasyonu için yeni bir satır döndürüldüğünden, yanıtınızdaki toplam satır sayısı her ek segment alanıyla katlanarak artar.

Kategori ve ürün türü

Merchant Center Sorgu Dili, envanterinizi düzenlemek için tanımlayabileceğiniz iki özellik grubuna göre metrikleri segmentlere ayırmayı destekler:

Kategori seviyeleri

Google ürün sınıflandırmasındaki kategoriler. Google, kategori belirtilmemişse kategoriyi ürününüze otomatik olarak atayabilir veya belirtilen kategoriyi daha da hassaslaştırabilir.

Ürün türü seviyeleri

Kategorinize göre atadığınız ürün türleri. Kategori düzeylerinin aksine, önceden tanımlanmış bir dizi desteklenen değer yoktur.

Hem kategori hem de ürün türü özellikleri, birden fazla düzeye sahip bir hiyerarşi içinde düzenlenir. Ürün spesifikasyonu her seviyeyi > karakteriyle ayırır ancak hiyerarşinin her seviyesini raporlarda 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 mevcutsa 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'

aşağıdaki 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"
        }
      }
    }
  ]
}

Değerleri hâlâ varsayılan değer veya sıfır olsa bile seçtiğiniz tüm alanlar yanıtta döndürülür.