Method: accounts.campaignReport.generate

Erstellt basierend auf den angegebenen Spezifikationen einen Kampagnenbericht.

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 erstellt werden soll. Beispiel: accounts/pub-9876543210987654

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

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

object (CampaignReportSpec)

Kampagnenberichtsspezifikation

Antworttext

Campaign Report API-Antwort.

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

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

object (ReportRow)

Die Kampagnenberichtsdaten 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 in der Übersicht über OAuth 2.0.

CampaignReportSpec

Die Spezifikation zum Erstellen eines Kampagnenberichts. Die Spezifikation zum Abrufen von IMPRESSIONEN und KLICKS unterteilt nach CAMPAIGN_ID kann beispielsweise wie folgt 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 erstellt wird. Der Zeitraum beträgt maximal 30 Tage.
dimensions[]

enum (Dimension)

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

enum (Metric)

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

string

Sprache, die für den lokalisierten Text verwendet wird, z. B. bestimmte anwendbare Dimensionswerte. Das Sprach-Tag ist im IETF-BCP47 definiert. Wenn kein Wert angegeben oder 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“, die mit der Kampagnen-ID aus der Kampagnenlisten-API übereinstimmt.
CAMPAIGN_NAME Dies ist der Name der Kampagne.
AD_ID Die eindeutige ID der Anzeige, z. B. „123456789“.
AD_NAME Der Name der Anzeige. Dieser darf nicht eindeutig sein.
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 wird.
PLACEMENT_PLATFORM Die Plattform der App, auf der die Anzeige platziert wird.
COUNTRY Der Name des Ziellandes.
FORMAT 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 Die Häufigkeit, mit der eine Anzeige für den Nutzer ausgeliefert wird.
CLICKS Dieser Wert gibt an, wie oft ein Nutzer auf eine Anzeige klickt.
CLICK_THROUGH_RATE Die Anzahl der Klicks auf eine Anzeige geteilt durch die Anzahl der Anzeigenauslieferungen.
INSTALLS Gibt an, wie oft Apps auf Geräte heruntergeladen wurden.
ESTIMATED_COST Die geschätzten Kosten für die Auslieferung einer Anzeige einer Kampagne anstelle einer Anzeige, mit der Umsatz erzielt wird. Die Währung ist die Berichtswährung für Kampagnen.
AVERAGE_CPI Der durchschnittliche Cost-per-Install. Das ist der durchschnittliche Betrag, der ausgegeben wurde, um einen neuen Nutzer zu gewinnen. Die Währung ist die Berichtswährung für Kampagnen.
INTERACTIONS Dieser Wert gibt an, wie oft ein Nutzer mit einer Anzeige interagiert. Sie umfasst Klicks und Interaktionen.