Performance reports

Merchant API, örneğin performans raporları sunar. 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 Reports hizmetine sorgu göndermek üzere tarih aralığına filtre eklemeniz gerekir.

Belirtilen tarih aralığındaki toplam tıklama sayısını içeren tek bir satır döndüren örnek sorguyu aşağıda bulabilirsiniz:

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": "4,440"
      }
    }
  ]
}

Segmentler

Performans raporlarında segmentasyon için segment alanlarını kullanabilirsiniz. Örneğin, marketing_method için yapılan sorgu, her pazarlama yöntemi için bir satır içeren bir rapor ve SELECT ifadesinde bu pazarlama yöntemi için belirttiğiniz metrikleri döndürü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 ile benzer şekilde çalışır. Segment alanları, seçilen metrikleri SELECT ifadesindeki her segmente göre gruplandırarak böler.

Burada, 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 ü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österiliyor. Satıcının 3 Aralık 2023'te tıklaması olmadığından bu tarih için herhangi bir değer 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ırlarda 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 sorgu dili, envanterinizi düzenlemek için tanımlayabileceğiniz iki özellik grubuyla metrikleri segmentlere ayırmayı destekler:

Kategori düzeyleri
Google ürün sınıflandırmasındaki kategoriler. Google, kategori sağlanmamışsa ürününüze otomatik olarak kategori atayabilir veya sağlanan kategoriyi daha da hassaslaştırabilir.
Ürün türü düzeyleri
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üzeye sahip 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ü düzeylerine sahip bir ürünü ele alalım:

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

Raporlar her düzeyi 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 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 döndürülür. Her para birimi kodu için 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ğerleri 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.