Merchant API v1beta, 28 Şubat 2026'da kullanımdan kaldırılacak ve kapatılacak. En yeni kararlı sürüme geçiş adımları için v1beta'dan v1'e geçiş başlıklı makaleyi inceleyin.

Ürünlerinizi değerlendirme

Merchant Reports API'yi kullanarak performans verilerini görüntüleyebilir, ürünlerinizi belirli özelliklere göre filtreleyebilir ve fiyatlandırmanızı iyileştirebilirsiniz.

Performansı ölçmek

Merchant Reports API ile hesabınızın performans metriklerini alabilirsiniz product_performance_view.

Şartlar

Bu raporu almak için Performans ve analizler rolüne sahip olmanız gerekir.

Performans ve analizler rolünü mevcut bir kullanıcıya atamak için yama isteği oluşturun ve kullanıcıya PERFORMANCE_REPORTING erişim hakkını atayın. Aşağıdaki istekte, PERFORMANCE_REPORTING erişim hakkını atamak için nasıl yama isteği oluşturabileceğiniz gösterilmektedir:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}

{
  "accessRights": [
    "PERFORMANCE_REPORTING"
  ]
}

Aşağıdakini değiştirin:

{ACCOUNT_ID}: Merchant Center hesabının benzersiz tanımlayıcısı.
{EMAIL_ID}: Rolü atamak istediğiniz kullanıcının e-posta adresi.

Örnek sorgu

Aşağıdaki sorgu, belirli bir 30 günlük dönemde hesabınızdaki tüm ürünler için impressions, clicks ve click_through_rate değerlerini alır. İsteği göndermek için aşağıdaki Merchant Center Query Language ifadesini accounts.reports.search yöntemine iletin:

SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'

Performans raporları hakkında daha fazla bilgi için Performans raporları kılavuzuna bakın.

Ürünleri filtreleyin

Ürün durumları da dahil olmak üzere ürün verilerinizin filtrelenmiş bir görünümünü göstermek için Merchant Reports API'nin product_view kullanabilirsiniz. Örneğin, sorunlu ürünleri listelemek veya yeni ürünlerinizin listesini almak ve yayını doğrulamak için product_view sorgusunu kullanabilirsiniz.

Sorgunuzun SELECT ifadesine id alanını eklemeniz gerekir. id, ürünün REST ID'siyle aynı değere sahip.

item_issues dışındaki tüm kullanılabilir alanlara göre filtreleme yapabilirsiniz. Yanıtı, aşağıdaki alanlar hariç tüm kullanılabilir alanlara göre sıralayabilirsiniz:

gtin
item_issues

Ürünlerinizi NOT_ELIGIBLE_OR_DISAPPROVED durumuyla döndüren bir örneği aşağıda bulabilirsiniz. İsteği göndermek için aşağıdaki Merchant Center sorgu dili ifadesini accounts.reports.search yöntemine iletin:

SELECT
  id,
  offer_id,
  feed_label,
  title,
  aggregated_reporting_context_status,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'

Önceki sorguya ilişkin örnek yanıt:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
        "itemIssues": [
          {
            "type": {
              "code": "invalid_string_value",
              "canonicalAttribute": "n:product_code"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                },
                {
                  "reportingContext": "FREE_LISTINGS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DISAPPROVED"
            },
            "resolution": "MERCHANT_ACTION"
          },
          {
            "type": {
              "code": "apparel_missing_brand",
              "canonicalAttribute": "n:brand"
            },
            "severity": {
              "severityPerReportingContext": [
                {
                  "reportingContext": "SHOPPING_ADS",
                  "disapprovedCountries": [
                    "US"
                  ]
                }
              ],
              "aggregatedSeverity": "DEMOTED"
            },
            "resolution": "MERCHANT_ACTION"
          }
        ]
      }
    }
  ]
}

Sorgu için kullanılabilen alanlar hakkında daha fazla bilgi edinmek için productView tablosundaki alanlar bölümünü inceleyin.

Fiyatlandırmayı iyileştirme

Ürünleriniz için önerilen indirimli fiyatları ve ürünlerinizin fiyatlarını güncellediğinizde elde edebileceğiniz performansla ilgili tahminleri görmek için fiyat analizleri görünümünü kullanabilirsiniz. Fiyat analizleri raporunu kullanarak ürünlerinizi daha etkili bir şekilde fiyatlandırabilirsiniz.

Daha fazla bilgi için Fiyat analizleri raporu ile ürün fiyatlandırmasını iyileştirme başlıklı makaleyi inceleyin.

Ürünleriniz için önerilen indirimli fiyatları görüntülemek üzere price_insights_product_view sorgusunu kullanın.

Ürünleriniz için önerilen satış fiyatlarını görüntülemek üzere kullanabileceğiniz bir örnek aşağıda verilmiştir. İsteği göndermek için aşağıdaki Merchant Center Query Language ifadesini accounts.reports.search yöntemine iletin:

SELECT
  id,
  title,
  brand,
  price,
  suggested_price,
  predicted_impressions_change_fraction,
  predicted_clicks_change_fraction,
  predicted_conversion_change_fraction
FROM price_insights_product_view