Method: accounts.campaignReport.generate

Erstellt einen Kampagnenbericht auf Grundlage der bereitgestellten Spezifikationen.

HTTP-Anfrage

POST https://admob.googleapis.com/v1beta/{parent=accounts/*}/campaignReport:generate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Ressourcenname des Kontos, für das der Bericht generiert werden soll. Beispiel: accounts/pub-9876543210987654

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "reportSpec": {
    object (CampaignReportSpec)
  }
}
Felder
reportSpec

object (CampaignReportSpec)

Spezifikation für Kampagnenberichte.

Antworttext

Antwort der Campaign Report API.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "rows": [
    {
      object (ReportRow)
    }
  ]
}
Felder
rows[]

object (ReportRow)

Die Daten aus dem Kampagnenbericht des angegebenen Publishers. Von der API werden maximal 100.000 Zeilen zurückgegeben.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/admob.readonly
  • https://www.googleapis.com/auth/admob.report

Weitere Informationen finden Sie unter OAuth 2.0 Overview.

CampaignReportSpec

Die Spezifikation zum Generieren eines Kampagnenberichts. Die Spezifikation zum Abrufen von IMPRESSIONS und CLICKS, aufgeschlüsselt nach CAMPAIGN_ID, kann beispielsweise so aussehen:

{
  "dateRange": {
    "startDate": {"year": 2021, "month": 12, "day": 1},
    "endDate": {"year": 2021, "month": 12, "day": 30}
  },
  "dimensions": ["CAMPAIGN_ID"],
  "metrics": ["IMPRESSIONS", "CLICKS"],
}
JSON-Darstellung 
{
  "dateRange": {
    object (DateRange)
  },
  "dimensions": [
    enum (Dimension)
  ],
  "metrics": [
    enum (Metric)
  ],
  "languageCode": string
}
Felder
dateRange

object (DateRange)

Der Zeitraum, für den der Bericht generiert wird. Der maximale Zeitraum beträgt 30 Tage.
dimensions[]

enum (Dimension)

Liste der Dimensionen des Berichts. Die Zeile des Berichts wird durch die Kombination der Werte dieser Dimensionen bestimmt. Wenn keine Dimensionen angegeben sind, enthält der Bericht eine einzelne Zeile mit den angeforderten Messwerten für das gesamte Konto.
metrics[]

enum (Metric)

Liste der Messwerte des Berichts. In einem Bericht muss mindestens ein Messwert angegeben werden.
languageCode

string

Sprache für lokalisierten Text, z. B. bestimmte anwendbare Dimensionswerte. Das Sprachentag ist in IETF BCP47 definiert. Wenn keine Angabe erfolgt oder die Angabe ungültig ist, wird standardmäßig „en-US“ verwendet.

Dimension

Die Dimensionen des Kampagnenberichts.

Enums
DIMENSION_UNSPECIFIED Standardwert einer nicht angegebenen Dimension. Nicht verwenden.
DATE Ein Datum im Format JJJJMMTT (z. B. „20210701“).
CAMPAIGN_ID Die eindeutige ID der Kampagne, z. B. „123456789“. Sie entspricht der Kampagnen-ID aus der Campaign List API.
CAMPAIGN_NAME Dies ist der Name der Kampagne.
AD_ID Die eindeutige ID der Anzeige, z. B. „123456789“.
AD_NAME Der Name der Anzeige, der nicht eindeutig sein muss.
PLACEMENT_ID Die anbieterspezifische eindeutige ID der App, in der die Anzeige platziert wird. Beispiel: com.goog.bar für Android und 123456789 für iOS-Apps.
PLACEMENT_NAME Der Name der App, in der die Anzeige platziert ist.
PLACEMENT_PLATFORM Die Plattform der App, in der die Anzeige platziert ist.
COUNTRY Der Name des Ziellandes.
FORMAT Das Format des Anzeigenblocks (z. B. „Banner“ oder „Nativ“), eine Dimension für die Anzeigenauslieferung.

Messwert

Die Messwerte des Kampagnenberichts.

Enums
METRIC_UNSPECIFIED Standardwert für ein nicht festgelegtes Feld. Nicht verwenden.
IMPRESSIONS Dieser Wert gibt an, wie oft einem Nutzer eine Anzeige präsentiert wird.
CLICKS Dieser Wert gibt an, wie oft ein Nutzer auf eine Anzeige geklickt hat.
CLICK_THROUGH_RATE Dieser Wert wird ermittelt, indem die Anzahl der Klicks auf die Anzeige durch die Anzahl der Auslieferungen der Anzeige geteilt wird.
INSTALLS Gibt an, wie oft Apps auf Geräte heruntergeladen wurden.
ESTIMATED_COST Die geschätzten Kosten für die Bereitstellung einer Anzeige für eine Kampagne statt einer Anzeige, mit der Umsatz erzielt wird. Die Währung ist die Berichtswährung für Kampagnen.
AVERAGE_CPI Der durchschnittliche Cost-per-Install ist der durchschnittliche Betrag, der ausgegeben wurde, um einen neuen Nutzer zu gewinnen. Die Währung ist die Berichtswährung für Kampagnen.
INTERACTIONS Die Häufigkeit, mit der ein Nutzer mit einer Anzeige interagiert. Dazu gehören Klicks und Interaktionen.