Datos del evento posterior a la instalación (PIE)

Introducción

Este punto de conexión permite a los anunciantes enviar datos de Vungle sobre cada evento en el nivel de usuario a medida que ocurren. La API de los datos de los eventos le permite a los anunciantes asistir a Vungle para que comprenda cuáles son los usuarios más valiosos para usted. Cuando nos envía información de los eventos en su aplicación, Vungle puede optimizar sus campañas para ayudarle a obtener los usuarios que le interesan.

Contenido

Solicitud de HTTP

http://ingest.vungle.com/eventData

POST

Admitimos solicitudes de POST con los siguientes tipos de contenido para el cuerpo:

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

Nota: Vungle recomienda utilizar el método POST con un cuerpo JSON.

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

GET

También admitimos solicitudes de GET con parámetros de consulta.

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

Parámetros obligatorios

Cada evento que nos envía cuenta con parámetros obligatorios y opcionales. Rechazaremos las solicitudes que no contengan los parámetros necesarios y le informaremos cuáles faltan. Consulte la sección de errores para obtener más detalles.

Identificador de dispositivos

Exigimos al menos UN identificador de dispositivos por evento, pero no es necesario pasarlos a todos.

Parámetro Descripción
device_idfa IDFA de Apple o ID de anuncios de los servicios de Google Play
device_mac La dirección MAC en formato canónico, separada por un guion o dos puntos
device_other_id Otros identificadores únicos. Por ejemplo, e.g. ID de Android, identificadores con hash, etc.

Nota: Vungle recomienda utilizar device_idfa siempre que sea posible.

Otros parámetros obligatorios

Debe pasar el resto de los parámetros obligatorios para que aceptemos el evento.

Parámetro Descripción
vungle_app_id ID de la aplicación como aparece en el panel de control de Vungle
trk Origen del evento entrante. En los casos de integración directa de servidor a servidor, debe utilizar el identificador propio; de lo contrario, debe identificar el proveedor de seguimiento. Por ejemplo, e.g. "tune", "kochava", "adjust", "appsflyer", etc.
event_trk_id  Este identificador debe ser único para el evento. Se usa para la desduplicación.
event_id El identificador de eventos de Vungle. Si el que produce este evento es un usuario que llega a su aplicación mediante una campaña de Vungle, el identificador del evento pasará a usted en el controlador de vistas o clics.
event_name Debe ser una cadena que identifique el evento que coincida en los usuarios. Por ejemplo, e.g. "tutorial-complete", "level-3", "purchase", etc.

Ejemplos

Un ejemplo de cuerpo de POST:

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

Un ejemplo de solicitud de 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"

Las cargas que se muestran previamente devuelven una respuesta de "200 positivos" y son ejemplos de la solicitud mínima que puede enviar a Vungle.

Parámetros opcionales

Estos parámetros son opciones, pero le permiten a Vungle determinar los usuarios valiosos, de modo que debe pasar la mayor cantidad posible.

Parámetro Por defecto Descripción
event_value Ninguno Valor numérico asociado al evento. Debe ser similar a otros eventos que envió a Vungle. Por ejemplo, en una IAP de $4.99, debe ser 4.99.
event_currency 'usd'  Si event_value es un valor monetario explícito, defina la divisa aquí.
event_iap_event falso Establezca una bandera aquí para indicar si el evento fue una compra en la aplicación.
device_limit_track falso Expresión booleana que indica si se estableció el "límite y seguimiento" del dispositivo.
event_datetime Marca de tiempo de la recepción del evento Marca de tiempo de la ocurrencia del evento. Si no se especifica la zona horaria, se asume que es UTC. La marca de tiempo debe tener un formato ISO 8601.
device_ip Ninguno Dirección IP del dispositivo.
device_make Ninguno Fabricante del dispositivo.
device_model Ninguno Modelo del dispositivo.
device_carrier Ninguno Proveedor de servicios del dispositivo.
device_language Ninguno Código de idioma del dispositivo ISO 639-1 (2 dígitos).
device_country Ninguno Código de país de la IP de origen ISO 3166 (2 dígitos).
device_user_agent  Ninguno Agente del usuario del navegador del dispositivo.
device_os Ninguno Número de versión del sistema operativo.

Nota: asegúrese de anotar el parámetro event_value y tenga en cuenta los valores de cada evento. Vungle no posee requisitos para los números reales que se utilizan, pero los eventos deben contener valores que sean similares entre sí. Vungle intentará maximizar el valor general de los tipos de usuarios que le mandamos.

Ejemplo de parámetros opcionales

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

Códigos de error

Devolvemos los siguientes códigos:

Código de error Significado
200  Correcto, gracias.
400 Solicitud incorrecta: su solicitud es errónea. Es probable que haya omitido alguno de los parámetros obligatorios. Compruebe el cuerpo de respuesta para obtener información.
500 Error interno del servidor: se produjo un error en nuestro servidor. Inténtelo nuevamente más tarde.
503 Servicio no disponible: estamos fuera de línea temporalmente debido a mantenimiento. Inténtelo nuevamente más tarde.

Si recibe un código de error "400 SOLICITUD INCORRECTA", compruebe el cuerpo de la respuesta. Haremos nuestro mejor esfuerzo para diagnosticar el problema. Es muy probable que haya uno o dos campos vacíos. Por ejemplo,

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

Devuelve una respuesta como la siguiente:

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

 

 

¿Tiene más preguntas? Enviar una solicitud

Comentarios