Beispiel für den Schnelleinstieg

Hier ist eine Beispielabfrage für product_performance_view, mit der die Leistung Ihres Kontos in den letzten 30 Tagen aufgeschlüsselt nach marketing_method und offer_id zurückgegeben wird. Mit diesem kurzen Beispiel können Sie sich mit der Merchant Reports API vertraut machen.

Sie benötigen die Rolle Leistung und Statistiken, um diesen Bericht abzurufen. Weitere Informationen finden Sie in den Anforderungen.

Geben Sie dazu die folgende Merchant Center-Abfragesprache-Anweisung an die Methode accounts.reports.search weiter:

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-Anfrage-URL

Die Anfrage besteht aus einer HTTP-POST-Anfrage an den Merchant Reports API-Server unter der folgenden URL:

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

Vollständiges Beispiel für eine HTTP-Anfrage

Hier ein vollständiges Beispiel für die Berichtsdefinition in einer HTTP-POST-Anfrage:

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'"
}

Sie sehen hier ein Beispiel:

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