Post-Install Event (PIE)-Daten

Einführung

Dieser Endpunkt ermöglicht es Werben, über jedes Event auf Nutzer Ebene, während es auftritt, Daten an Vungle zu senden. Der Nutzer der Event-Daten-API für Werber ist, Vungle beizubringen, welche Nutzer wertvoll für Sie sind. Wenn Sie uns Event-Informationen aus Ihrer App senden, kann Vungle Ihre Werbekampagnen anpassen, damit Sie die für Sie relevanten Nutzer erhalten.

Inhalt

HTTP-Anfrage

http://ingest.vungle.com/eventData

POST

Wir unterstützenPOST-Anfragen mit den folgenden Body-Inhaltstypen:

  • application/x-www-form-urlencoded  
  • application/json  

Hinweis: Vungle empfiehlt die Verwendung der POST-Methode mit einem JSON-Body.

curl -H "Content-Type: application/json" -d '{"data": "myData"}' "http://ingest.vungle.com/eventData"

GET

Wir unterstützen auch GET-Anfragen, die Query-Parameter verwenden.

curl "http://ingest.vungle.com/eventData?data=myData"

Erforderliche Parameter

Jedes Event, das Sie uns senden, hat sowohl erforderliche als auch optionale Parameter. Wir lehnen anfragen ab, die nicht über die nötigen Parameter verfügen und wir teilen Ihnen mit, welche Parameter fehlen. Sehen Sie zum Erhalt weiterer Details im Fehler-Abschnitt nach.

Geräte-Identifikator

Wir erfordern mindestens EINEN Geräte-Identifikator pro Event, so dass Sie nicht alle übergeben müssen.

Parameter Beschreibung
device_idfa Apple IDFA oder Google Play Services Advertising ID
device_mac Mac-Adresse im klassischen Format, entweder mit Bindestrich oder Doppelpunkt getrennt
device_other_id Einen weiteren einzigartigen Identifikator, e.g. die Android-ID, gehashte Identifikatoren usw.

Hinweis: Vungle empfiehlt die Verwendung von device_idfa, falls dies möglich ist!

Andere erforderliche Parameter

Damit wir das Event annehmen, müssen Sie alle verbleibenden Parameter an uns übergeben.

Parameter Beschreibung
vungle_app_id Die App-ID, die im Vungle-Dashboard angegeben ist
trk Die Quelle des eingehenden Events. Im Fall einer direkten Server-zu-Server-Integration sollten Sie sich selbst identifizieren. Anderenfalls sollten Sie den Tracking-Anbieter e.g. "tune", "kochava", "adjust", "appsflyer" usw. angeben
event_trk_id  Dies sollte ein für dieses Event einzigartiger Identifikator sein. Zur Entfernung von Duplikaten verwendet.
event_id Der Vungle Event-Identifikator. Falls dieses Event durch einen Nutzer durchgeführt wurde, der durch eine Vungle-Kampagne an Ihre App geraten ist, wurde dieser Identifikator in der Ansicht oder im Click-Tracker an Sie weitergegeben.
event_name Dies sollte ein String zur Identifizierung des Events sein, der bei allen Nutzern gleich bleibt, e.g. "tutorial-complete", "level-3", "purchase" usw.

Beispiele

Ein beispielhafter POST-Body:

{
  "device_idfa"   : "236A005B-700F-4889-B9CE-99",
  "vungle_app_id" : "myVungleApp",
  "trk"           : "tune",
  "event_trk_id"  : "uniqueID1234",
  "event_name"    : "tutorial-complete"
}

Eine beispielhafte GET-Anfrage:

curl "http://ingest.vungle.com/eventData?device_idfa=236A005B-700F-4889-B9CE-999EAB2B605D&vungle_app_id=myVungleApp&trk=tune&event_trk_id=uniqueID1234&event_name=tutorial-complete"

Die obenstehenden übermittelten Informationen würden die Antwort "200 OK" ausgeben und stellen beispielhaft eine Minimalanfrage an Vungle dar.

Optionale Parameter

Diese Parameter sind optional; sind aber wichtig, damit Vungle bestimmen kann, welche Nutzer wertvoll sind. Deshalb sollten Sie möglichst viele davon weitergeben.

Parameter Standard Beschreibung
event_value None Einige numerische werte, die mit dem Event in Verbindung stehen. Sollten in Verbindung mit anderen Events stehen, die Sie an Vungle senden. Zum Beispiel sollte $4.99 IAP zu 4.99. werden.
event_currency 'usd'  Falls event_value ein ausdrücklicher Währungswert ist, geben Sie hier die Währung an.
event_iap_event false Setzen Sie hier eine Flagge, um anzugeben, ob das Event ein Kauf innerhalb der App war.
device_limit_track false Boolean dafür, ob das Gerät die Einstellung "limit ad treacking" hat.
event_datetime Zeitstempel für Event-Empfang Zeitstempel für Event-Auftreten. Wenn die Zeitzone nicht angegeben wird, nehmen wir UTC an. Der Zeitstempel sollte im ISO 8601-Format sein.
device_ip None IP-Adresse des Geräts.
device_make None Gerätehersteller.
device_model None Gerätemodell.
device_carrier None Geräte-Mobilfunkanbieter.
device_language None ISO-639-1-Sprachcode des Geräts (2 Stellen).
device_country None ISO-3166-Ländercode der Quell-IP (2 Stellen).
device_user_agent  None User-Agent des Gerätebrowsers.
device_os None Versionsnummer des Betriebssystems.

Hinweis: Stellen Sie sicher, dass Sie den event_value-Parameter und die Werte für jeden Event beachten. Vungle ist agnostisch hinsichtlich der tatsächlich verwendeten Werte. Events sollten aber Werte haben, die einander relativ bedeutungsvoll sind. Vungle versucht den Gesamtwert der Nutzertypen zu erhöhen, die wir Ihnen senden.

Beispielhafte optionale Parameter

{
  "event_currency"      : "usd",
  "event_iap_event"     : true,
  "device_limit_track"  : false,
  "event_datetime"      : "2015-03-15T13:27:36Z",
  "device_ip"           : "201.15.25.11",
  "device_make"         : "samsung",
  "device_model"        : "sm-g900v",
  "device_carrier"      : "verizon",
  "device_language"     : "es",
  "device_country"      : "us",
  "device_user_agent"   : "Mozilla/5.0 (Linux; U; Android 2.2.1; fr-fr; HTC_DesireZ_A7272 Build/FRG83D) AppleWebKit/533.1 (KHTML, like Gecko), Version/4.0 Mobile Safari/533.1",
  "device_os"           : "4.3.2",
  "event_value"         : 1.99
} 

Fehlercodes

Wir geben die folgenden Codes zurück:

Fehlercode Bedeutung
200  OK – Danke!
400 Schlechte Anfrage – Ihre Anfrage ist ätzend. Höchstwahrscheinlich haben Sie einen der erforderlichen Parameter ausgelassen. Überprüfen Sie den Body der Antwort auf Fehler.
500 Interner Serverfehler – Wir hatten ein Problem mit unserem Server. Versuchen Sie es später erneut.
503 Der Dienst ist nicht verfügbar – Wir sind zur Wartung vorübergehend offline. Versuchen Sie es später erneut.

Wenn wir mit "400 BAD REQUEST" antworten, überprüfen Sie bitte den Body der Antwort. Wir versuchen dann herauszufinden, was schief gegangen ist. Meistens handelt es sich dabei um ein oder zwei fehlende Felder. Zum Beispiel

curl "http://ingest.vungle.com/eventData?trk=tune&event_trk_id=uniqueID1234"

Würde eine Antwort ausgeben, die so aussieht:

{
  "missing_fields":
  [
    "vungle_app_id",
    "trk",
    "event_trk_id",
    "event_name",
    "device_idfa | device_mac | device_other_id"
  ]
}

 

 

Haben Sie Fragen? Anfrage einreichen

Kommentare