- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CampaignReportSpec
- Dimension
- Messwert
- Beispiele
- Testen!
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 |
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 ( |
Felder | |
---|---|
reportSpec |
Kampagnenberichtsspezifikation |
Antworttext
Campaign Report API-Antwort.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"rows": [
{
object ( |
Felder | |
---|---|
rows[] |
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 ( |
Felder | |
---|---|
dateRange |
Der Zeitraum, für den der Bericht erstellt wird. Der Zeitraum beträgt maximal 30 Tage. |
dimensions[] |
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[] |
Liste der Messwerte des Berichts. In einem Bericht muss mindestens ein Messwert angegeben sein. |
languageCode |
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. |