Hızlı başlangıç örneği

product_performance_view API'sine gönderilen ve hesabınızın son 30 gün içindeki performansını marketing_method ve offer_id'e göre segmentlere ayırarak döndüren örnek bir sorgu aşağıda verilmiştir. Merchant Reports API'yi tanımak için bu hızlı örneği deneyebilirsiniz.

Bu raporu almak için Performans ve analizler rolüne sahip olmanız gerekir. Daha fazla bilgi için koşulları inceleyin.

İsteği göndermek için aşağıdaki Merchant Center Sorgu Dili ifadesini accounts.reports.search yöntemine iletin:

SELECT
  marketing_method,
  offer_id,
  impressions,
  clicks,
  click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

HTTP istek URL'si

İstek, aşağıdaki URL'deki Merchant Reports API sunucusuna gönderilen bir HTTP POST'tan oluşur:

https://merchantapi.googleapis.com/reports/v1beta/accounts/PARENT/reports:search

Tam HTTP isteği örneği

Aşağıda, bir HTTP POST isteğine dahil edilmiş rapor tanımını gösteren eksiksiz bir örnek verilmiştir:

POST /reports/v1beta/accounts/PARENT/reports:search HTTP/1.1
Host: merchantapi.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer

Parameters:
{
  "query" : "SELECT
              marketing_method,
              offer_id,
              impressions,
              clicks,
              click_through_rate
            FROM product_performance_view
            WHERE date BETWEEN '2023-11-01' AND '2023-11-30'"
}

Aşağıda örnek bir yanıt verilmiştir:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38",
        "impressions": "1038",
        "clickThroughRate": "0.3661"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "126",
        "impressions": "1126",
        "clickThroughRate": "0.1119"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "26",
        "impressions": "526",
        "clickThroughRate": "0.0494"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "227",
        "impressions": "1227",
        "clickThroughRate": "0.1850"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "12",
        "impressions": "512",
        "clickThroughRate": "0.0234"
      }
    }
  ]
}