Bericht-API 1.0 für Werber

Überblick

Hinweis: Die Bericht-API 1.0 ist unsere vorherige API. Verwenden Sie sie für Transaktionen die vor dem 5. Juli 2017 stattgefunden haben. Verwenden Sie für Transaktionen am oder nach dem 5. Juli 2017 die Bericht-API 2.0, die hier dokumentiert ist.

Die Bericht-API bietet Werbern eine programmatische Methode, um auf Daten zuzugreifen, die sich im Dashboard befinden. Ihr Bericht-API-Schlüssel ist für alle Apps derselbe. Jede App hat eine einzigartige Bericht-API-ID, die Sie auf der entsprechenden Seite der Anwendung finden.

Host Header anfordern API
https://ssl.vungle.com Content-Type: application/json Die Sicherheit wird abgewickelt, indem ein API-Schlüssel als Abfrageparameter weitergegeben wird. Ihr API-Schlüssel wird automatisch im Vungle Dashboard generiert.
Wenn Sie noch keinen besitzen, lesen Sie unter Wie fordere ich einen Schlüssel für die Bericht-API an?

Werber

Ressource Parameter Beschreibung
GET /api/campaigns key=[API Key] active=[true/false] Gibt eine Liste der Kampagnen in Ihrem Besitz zurück. Wenn "active" angegeben wird, werden die Kampagnen zur ausschließlichen Anzeige aktiver oder inaktiver Kampagnen gefiltert.

Beispielantwort:

{   
    "rate" : 0.01,
    "rateType" : "complete",
    "campaignId" : "51896da23436ae313c3939b9",
    "type" : "external",
    "name" : "Feed the Rat",
    "spent" : 2131
}

Ressource Parameter Beschreibung
GET /api/campaigns/[Campaign ID] key=[API Key] date=[YYYY-MM-DD] Gibt die Statistiken für die angegebene Kampagne zum angegebenen Datum zurück.

Beispielantwort:

{
    "clicks" : 1129,
    "completedViews" : 23080,
    "date" : "2012-08-19",
    "campaignId" : "51896da23436ae313c3939b9",
    "installs" : 590,
    "impressions" : 26722,
    "name" : "Feed the Rat",
    "views" : 26546,
    "dailySpend": 566
}
Ressource Parameter Beschreibung
GET /api/campaigns/[Campaign ID]/installs key=[API Key] start=[YYYY-MM-DD] end=[YYYY-MM-DD] Gibt eine List der Installationen zurück, die auf die angegebene Kampagne im angegebenen Datumsbereich zurückzuführen sind.

Beispielantwort:

{
    "time_clicked": "2012-08-17T01:52:32.024Z",
    "time_installed": "2012-08-17T01:54:33.034Z",
    "openUDID": "e2c42c159286124f34702e770cc702240c2707e8",
    "mac": "98d6bb786fdd"
},
{
    "time_clicked": "2012-08-17T01:52:32.024Z",
    "time_installed": "2012-08-17T01:54:33.034Z",
    "openUDID": "e2c42c159286124f34702e770cc702240c2707e8",
    "mac": "98d6bb786fdd"
}

Metriken auf Geo-Ebene

Ressource Parameter Beschreibung
GET /api/campaigns/[Campaign ID]/geo/[Country_Code] key=[API Key] date=[YYYY-MM-DD] OR start=[YYYY-MM-DD] end=[YYYY-MM-DD]

Gibt die Geoinformationen einer Kampagne in bestimmten Ländern zurück. Das Land wird durch die Verwendung eines "Country_Code" mit zwei Buchstaben angegeben (z.B. US). Sie können entweder mit Hilfe der Parameter "start" und "end" einen Bereich oder mit "date" ein bestimmtes Datum angeben, allerdings nicht beides.

Beispielantwort:

{
"date": "2015-07-08",
"country": "US",
"views": 34029,
"completes": 32094,
"clicks": 1822,
"installs": 609,
"spend": 582,
"eRPM": 8.9
}
Ressource Parameter Beschreibung
GET /api/campaigns/[Campaign ID]/geo/all key=[API Key] date=[YYYY-MM-DD] OR start=[YYYY-MM-DD] end=[YYYY-MM-DD]

Gibt die Geoinformationen einer Kampagne in allen Ländern zurück. Sie können entweder mit Hilfe der Parameter "start" und "end" einen Bereich oder mit "date" ein bestimmtes Datum angeben, allerdings nicht beides.

Beispielantwort:

[
{
"date": "2015-07-08",
"country": "US",
"views": 34029,
"completes": 32094,
"clicks": 1822,
"installs": 609,
"spend": 582,
"eRPM": 8.9
},
{
"date": "2015-07-08",
"country": "CA",
"views": 34235,
"completes": 3190,
"clicks": 1509,
"installs": 523,
"spend": 498,
"eRPM": 7.6
}
]

Beachten Sie, dass Vungle im Fall von fehlenden Daten in Ihrer Anfrage eine Antwort mit "empty 200" zurückgibt. Dies bedeutet, dass die Anfrage stattgefunden hat, allerdings keine Daten zur Rückgabe verfügbar sind.

Haben Sie Fragen? Anfrage einreichen

Kommentare