Ürünlerinizi değerlendirme

Performans verilerini görüntülemek, ürünlerinizi belirli özelliklere göre filtrelemek ve fiyatlandırmanızı iyileştirmek için Merchant Reports API'yi kullanabilirsiniz.

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 bir 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 bir 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ünlerin impressions, clicks ve click_through_rate değerlerini alır. İsteği göndermek için aşağıdaki Merchant Center sorgu dili 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 yöntemini kullanabilirsiniz. Örneğin, sorunlu ürünleri listelemek veya yeni ürünlerinizin listesini alıp yayınlanma durumunu doğrulamak için product_view sorgusu gönderebilirsiniz.

Sorgunuzun SELECT yan tümcesine id alanını eklemeniz gerekir. id, ürünün REST kimliği ile aynı değere sahiptir.

Aşağıdakiler hariç tüm kullanılabilir alanlara göre filtreleme yapabilirsiniz:

  • status_per_reporting_context
  • item_issues

Yanıtı, aşağıdakiler hariç tüm kullanılabilir alanlara göre sıralayabilirsiniz:

  • gtin
  • status_per_reporting_context
  • item_issues

Bir ürünün genel uygunluğunu anlamak için aggregated_reporting_context_status alanını kontrol edebilirsiniz. Bu alan, bir ürünün tüm raporlama bağlamlarındaki durumları birleştirir.

Aşağıdaki örnekte, ürünleriniz birleştirilmiş durum ELIGIBLE_LIMITED ile döndürülür. Bu, ürünlerin hedeflenen raporlama bağlamlarının tümünde değil, en az birinde yayınlanmaya uygun olduğu anlamına gelir. Daha ayrıntılı inceleme yapmak için raporlama bağlamına ve ürün sorunlarına göre ayrıntılı ürün durumunu isteyebilirsiniz. İ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,
  status_per_reporting_context,
  item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'

Önceki sorgudan alınan örnek bir yanıtı aşağıda bulabilirsiniz:

{
  "results": [
    {
      "productView": {
        "id": "en~US~id0",
        "offerId": "id0",
        "feedLabel": "US",
        "aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
        "statusPerReportingContext": [
          {
            "reportingContext": "SHOPPING_ADS",
            "disapprovedCountries": [
              "US"
            ]
          },
          {
            "reportingContext": "FREE_LISTINGS",
            "approvedCountries": [
              "US"
            ]
          }
        ]
        "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"
          }
        ]
      }
    }
  ]
}

Belirli bir raporlama bağlamına ait ürün ayrıntılarını görüntülemek için WHERE yan tümcesinde reporting_context üzerinde bir filtre kullanabilirsiniz. reporting_context ölçütüne göre filtreleme yaptığınızda aggregated_reporting_context_status yalnızca seçilen raporlama bağlamına göre hesaplanır. status_per_reporting_context ve item_issues ise yalnızca bu bağlamla ilgili ayrıntıları döndürür.

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

Fiyatlandırmayı iyileştirme

Fiyat analizleri görünümünü kullanarak ürünleriniz için önerilen indirimli fiyatları ve ürünlerinizin fiyatlarını güncellediğinizde elde edebileceğiniz performansa dair tahminleri görebilirsiniz. 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 indirimli fiyatları görüntülemek amacıyla kullanabileceğiniz bir örnek aşağıda verilmiştir. İsteği göndermek için aşağıdaki Merchant Center Sorgu Dili ifadesini accounts.reports.search yöntemine iletin:

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

Önceki sorgudan alınan örnek bir yanıtı aşağıda bulabilirsiniz:

{
   "results": [
    {
      "priceInsightsProductView": {
        "id": "en~US~12345",
        "title": "UGG Women's s Classic Mini",
        "brand": "UGG",
        "price" {
          "amountMicros": "124990000",
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "135680000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.12609300017356873",
        "predictedClicksChangeFraction": "0.508745014667511",
        "predictedConversionsChangeFraction": "2.3431060314178467"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12346",
        "title": "Nike React Infinity Run Flyknit 2",
        "brand": "Nike",
        "price" {
          "amountMicros": "119990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "125440000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.1799899935722351",
        "predictedClicksChangeFraction": "0.6203680038452148",
        "predictedConversionsChangeFraction": "1.234868049621582"
      }
    },
    {
      "priceInsightsProductView": {
        "id": "en~US~12347",
        "title": "  New Balance 327 White Trainers",
        "brand": "New Balance",
        "price" {
          "amountMicros": "84990000"
          "currencyCode": "USD"
        },
        "suggestedPrice" {
          "amountMicros": "82000000",
          "currencyCode": "USD"
        },
        "predictedImpressionsChangeFraction": "0.11538799852132797",
        "predictedClicksChangeFraction": "0.5869849920272827",
        "predictedConversionsChangeFraction": "1.3622850179672241"
      }
    }
  ]
}

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

Önceki
Get started
Sonraki
Performance reports