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