Performans raporları

Merchant API, örneğin product_performance_view performans raporları sunar. Bu sayfada, performans raporlarının yapısı açıklanmaktadır.

Metrikler

Döndürülmesini istediğiniz metrikleri (örneğin, clicks ve impressions) sorgulayabilirsiniz. Performans verileri için Reports hizmetine sorgu göndermek üzere tarih aralığına 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 (ö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 ü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 oluşturduğunuzda her pazarlama yöntemi için bir satır içeren bir rapor döndürülür ve SELECT ifadesinde bu pazarlama yöntemi için belirttiğiniz metrikler yer alı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 işlevine benzer şekilde çalışır. Segment alanları, seçilen metrikleri böler ve SELECT ifadesindeki her segmente göre gruplandırır.

Burada, bir tarih aralığı koşulu eklenmişken clicks'ya göre azalan düzende günlük tıklama sayısını 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 pazarlama yöntemlerinde tüm ürünlerde 1.546 tıklama, 2 Aralık 2023'te ise tüm pazarlama yöntemlerinde tüm ürünlerde 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"
      }
    }
  ]
}

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 tıklamalarını marketing_method ve offer_id'ye göre segmentlere ayırarak 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 sorgunun yanıtı, offer_id ve marketing_method kombinasyonlarının her biri için bir satır içerir. Bu satırda, ilgili kombinasyonun tıklama sayısı yer alır:

{
  "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 Query Language, envanterinizi düzenlemek için tanımlayabileceğiniz iki özellik grubuyla metriklerin segmentlere ayrılmasını destekler:

Kategori düzeyleri

Google'ın ürün sınıflandırmasındaki kategoriler. Hiç kategori sağlanmamışsa Google, ürünüze otomatik olarak kategori atayabilir veya sağlanan kategoriyi daha da hassaslaştırabilir.

Ürün türü seviyeleri

Kategorilendirmenize 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üzeyi olan bir hiyerarşi içinde düzenlenir. Ürün spesifikasyonu, her düzeyi > karakteriyle ayırır ancak hiyerarşinin her düzeyini raporlarda ayrı ayrı seçersiniz.

Örneğin, aşağıdaki ürün türü seviyelerine sahip bir ürünü ele alalım:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Raporlar her seviyeyi kendi alanında döndürür:

Para birimi ve fiyat metrikleri

conversion_value gibi fiyat metrikleri, Price türü kullanılarak gösterilir. Metrik birden fazla para biriminde kullanılabiliyorsa her para biriminin değeri ayrı bir satırda döndürülür. Örneğin, şu 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ışı metrikleri 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, şu 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ğeri varsayılan değer veya sıfır olsa bile seçtiğiniz tüm alanlar yanıtta döndürülür.

Sorgu için kullanılabilen alanlar hakkında daha fazla bilgi edinmek için productPerformanceView tablosundaki alanlar başlıklı makaleyi inceleyin.