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

Julia Randall

10 novembre 2022 22:31

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.

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