Method: accounts.campaignReport.generate

Erstellt einen Kampagnenbericht basierend auf den angegebenen 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 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 Generieren eines Kampagnenberichts. Die Spezifikation zum Abrufen von IMPRESSIONEN und KLICKS aufgeteilt 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 wurde. Der maximale Zeitraum beträgt 30 Tage.

dimensions[]

enum (Dimension)

Liste der Dimensionen des Berichts. Anhand der Wertekombination dieser Dimensionen wird die Zeile des Berichts bestimmt. Wenn keine Dimensionen angegeben werden, gibt der Bericht eine einzelne Zeile mit angeforderten Messwerten für das gesamte Konto zurück.

metrics[]

enum (Metric)

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

languageCode

string

Sprache, die für lokalisierten Text verwendet wird, z. B. bestimmte relevante Dimensionswerte. Das Sprach-Tag wird in IETF BCP47 definiert. Die Standardeinstellung ist „en-US“. falls nicht angegeben oder ungültig.

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 stimmt mit der Kampagnen-ID aus der Kampagnenlisten-API überein.
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 ist.
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“, und ist 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 dem Nutzer eine Anzeige präsentiert wurde.
CLICKS Die Häufigkeit, mit der 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 für die Gewinnung eines neuen Nutzers ausgegeben wurde. Die Währung ist die Berichtswährung für Kampagnen.
INTERACTIONS Dieser Wert gibt an, wie oft ein Nutzer mit einer Anzeige interagiert. Diese umfassen Klicks und Interaktionen.