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 unter Anforderungen.

Hinweis: In diesem Leitfaden wird die zugrunde liegende HTTP-Anfrage als Lehrmittel gezeigt. Wir empfehlen jedoch, eine der Clientbibliotheken zu verwenden, um Anfragen zu senden.

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/ACCOUNT_ID/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 https://merchantapi.googleapis.com/reports/v1beta/accounts/ACCOUNT_ID/reports:search HTTP/1.1

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

Weitere Informationen zu den für Abfragen verfügbaren Feldern finden Sie unter Felder in der Tabelle productPerformanceView.