דוגמה למתחילים

הנה שאילתה לדוגמה ProductPerformanceView שמציגה את ביצועי החשבון שלכם ב-30 הימים האחרונים, בפילוח לפי marketingMethod וגם offerId. אפשר לנסות את הדוגמה הקצרה הזו כדי לקבל להכיר את Merchant Reports API.

נדרשות מדדי ביצועים ותובנות תפקיד כדי לאחזר את הדוח הזה. לצפייה דרישות לגבי פרטים נוספים.

כדי לשלוח את הבקשה, צריך להעביר את השאילתה הבאה של Merchant Center שפה accounts.reports.search method:

SELECT
  marketingMethod,
  offerId,
  impressions,
  clicks,
  clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-11-01' AND '2020-11-30'

כתובת URL של בקשת HTTP

הבקשה מורכבת מ-HTTP POST לשרת ה-Merchant Reports API כתובת ה-URL הבאה:

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

השלמת דוגמה של בקשת HTTP

הנה דוגמה מלאה שמציגה את הגדרת הדוח בתוך בקשת HTTP POST:

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
              marketingMethod,
              offerId,
              impressions,
              clicks,
              clickThroughRate
            FROM ProductPerformanceView
            WHERE date BETWEEN '2020-11-01' AND '2020-11-30'"
}

תגובה לדוגמה:

{
  "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"
      }
    }
  ]
}