Données d'événements post-installation (PIE)

Introduction

Ce point de terminaison permet aux publicitaires d'envoyer des données Vungle concernant chaque événement au niveau de l'utilisateur lorsqu'il se produit. Le but de l'API des données de l'événement est que les publicitaires aident Vungle à identifier les utilisateurs ayant le plus de valeur pour vous. Lorsque vous nous envoyez des informations d'événements dans votre application, Vungle peut optimiser vos campagnes pour vous aider à attirer les utilisateurs représentant le plus d'intérêt pour vous.

Contenu

Demande HTTP

http://ingest.vungle.com/eventData

POST

Nous prenons en charge les demandes POST avec les types de contenus suivants :

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

Remarques : Vungle recommande d'utiliser la méthode POST avec un corps JSON.

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

GET

Nous prenons également en charge les demandes GET à l'aide des paramètres de requête.

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

Paramètres obligatoires

Chaque événement que vous nous envoyez possède des paramètres obligatoires et facultatifs. Nous rejetterons toutes les demandes ne disposant pas des paramètres nécessaires, et nous vous indiquerons les paramètres manquants. Consultez la section des erreurs pour en savoir plus.

Identificateur d'appareil

Nous exigeons au moins UN identificateur d'appareil par événement, afin que vous ne soyez pas obligé de tous les transmettre.

Paramètre Description
device_idfa ID de publicité d'Apple IDFA ou des services Google Play
device_mac Adresse Mac au format canonique, séparée par un tiret ou deux points
device_other_id D'autres identificateurs uniques, e.g. ID Android, identificateurs hachés, etc.

Remarque : Vungle recommande d'utiliser device_idfa dans la mesure du possible !

Autres paramètres obligatoires

Vous devez transmettre tous les paramètres obligatoires restants pour que nous acceptions l'événement.

Paramètre Description
vungle_app_id ID d'application tel qu'indiqué sur le tableau de bord Vungle
trk Source de l'événement entrant. Dans le cas d'une intégration directe de serveur à serveur, vous devez vous auto-identifier et identifier le fournisseur du suivi, e.g. tune, kochava, adjust, appsflyer, etc.
event_trk_id  Il doit s'agir d'un identificateur unique propre à l'événement. Utilisé pour la déduplication.
event_id L'identificateur d'événements Vungle. Si cet événement avait été réalisé par un utilisateur attiré sur votre application par une campagne Vungle, cet identificateur d'événements vous aurait été transmis dans l'affichage ou le suivi de clic
event_name Il doit s'agir d'une chaîne qui identifie l'événement cohérent entre les utilisateurs, e.g. tutorial-complete, level-3, purchase, etc.

Exemples

Un exemple de corps POST :

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

Un exemple de demande GET :

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"

Les charges utiles renverront une réponse 200 OK, et sont des exemples de la demande minimum que vous pouvez envoyer à Vungle.

Paramètres facultatifs

Ces paramètres sont facultatifs, mais ils sont importants pour que Vungle identifie les utilisateurs ayant de la valeur ; vous devez donc en transmettre autant que possible.

Paramètre Valeur par défaut Description
event_value Aucun Certaines valeurs numériques associées à l'événement. Doit avoir un rapport avec d'autres événements que vous envoyez à Vungle. Par exemple, un achat intégré à l'application de $4.99 doit avoir la valeur 4.99.
event_currency 'usd'  Si event_value est une valeur monétaire explicite, définissez la devise ici.
event_iap_event false Définissez un indicateur ici pour préciser si l'événement était un achat intégré à l'application.
device_limit_track false Booléen si une limite du suivi des publicités est définie pour l'appareil.
event_datetime Horodatage de la réception de l'événement Horodatage de l'occurrence de l'événement Si aucun fuseau horaire n'est spécifié, nous supposons qu'il s'agit d'UTC. L'horodatage doit être au format ISO 8601.
device_ip Aucun Adresse IP de l'appareil
device_make Aucun Fabricant de l'appareil.
device_model Aucun Modèle de l'appareil.
device_carrier Aucun Fournisseur de l'appareil.
device_language Aucun Code de langage ISO 639-1 de l'appareil (2 chiffres).
device_country Aucun Code pays de l'IP source ISO 3166 (2 chiffres).
device_user_agent  Aucun Agent utilisateur du navigateur de l'appareil
device_os Aucun Numéro de version du système d'exploitation.

Remarque : veillez à noter le paramètre event_value, et tenez compte des valeurs de chaque événement. Vungle ne s'attache pas aux nombres réels utilisés, mais les événements doivent avoir des valeurs en relation les unes avec les autres. Vungle cherchera à optimiser la valeur globale des types d'utilisateurs que nous vous envoyons.

Exemples de paramètres facultatifs

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

Codes d'erreur

Nous renvoyons les codes suivants :

Code d'erreur Signification
200  OK – Merci !
400 Mauvaise demande – Ta demande craint. Il semblerait que vous ayez oublié l'un des paramètres obligatoires. Vérifiez le corps de la réponse pour en savoir plus.
500 Erreur interne du serveur – Nous avons rencontré un problème avec notre serveur. Veuillez réessayer ultérieurement.
503 Service indisponible – Nous sommes temporairement hors ligne pour réaliser des travaux de maintenance. Veuillez réessayer ultérieurement.

Si nous répondons par " 400 MAUVAISE DEMANDE ", vérifiez le corps de la réponse. Nous ferons de notre mieux pour identifier le problème, qui semble être causé par un ou deux champs manquants. Par exemple,

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

Renverrait ne réponse comme ceci :

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

 

 

Vous avez d’autres questions ? Envoyer une demande

Commentaires