Post-Install Event (PIE)-Daten

Julia Randall

10. November 2022 22:31

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.

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"
  ]
}