Documentación API
Integra IZI App Solution con tu infraestructura y MMPs favoritos para automatizar y optimizar tus campañas
Mobile Measurement Partners Soportados
Guía de Integración Paso a Paso
1
Configuración inicial del MMP
Configura tu cuenta y app en tu MMP preferido
// 1. Crea tu app en el dashboard del MMP
// 2. Obtén tu App ID / SDK Key
// 3. Instala el SDK en tu aplicación
// Ejemplo con AppsFlyer (iOS)
import AppsFlyerLib
AppsFlyerLib.shared().appsFlyerDevKey = "YOUR_DEV_KEY"
AppsFlyerLib.shared().appleAppID = "YOUR_APP_ID"
AppsFlyerLib.shared().start()2
Configuración de postbacks
Establece los postbacks para recibir datos en tiempo real
// URL de postback IZI App Solution
https://api.iziapp.es/v1/postback
// Parámetros requeridos:
{
"app_id": "{app_id}",
"event_name": "{event_name}",
"event_time": "{event_time}",
"attribution_partner": "{partner_name}",
"campaign_id": "{campaign_id}",
"adgroup_id": "{adgroup_id}",
"creative_id": "{creative_id}",
"country": "{country}",
"platform": "{platform}",
"idfa": "{idfa}",
"gaid": "{gaid}",
"ip": "{ip}",
"revenue": "{revenue}",
"currency": "{currency}"
}3
Mapeo de eventos
Define los eventos que quieres trackear
// Eventos estándar soportados
{
"install": "first_open",
"registration": "complete_registration",
"login": "login",
"purchase": "purchase",
"add_to_cart": "add_to_cart",
"level_achieved": "level_achieved",
"tutorial_completion": "tutorial_completion",
"subscription": "start_trial"
}
// Ejemplo de tracking de compra
trackEvent("purchase", {
revenue: 9.99,
currency: "EUR",
product_id: "premium_pack",
quantity: 1
})4
Validación y testing
Verifica que los datos fluyen correctamente
// Endpoint de validación
GET https://api.iziapp.es/v1/validate/{app_id}
// Respuesta esperada
{
"status": "success",
"app_id": "com.example.app",
"mmp_connected": true,
"events_received": 145,
"last_event": "2024-01-15T10:30:00Z",
"warnings": [],
"configuration": {
"postback_url": "configured",
"events_mapped": 8,
"fraud_prevention": "enabled"
}
}5
Autenticación API
Obtén tus credenciales y comienza a usar la API
// Headers de autenticación
headers: {
'X-API-Key': 'your_api_key',
'X-Account-ID': 'your_account_id',
'Content-Type': 'application/json'
}
// Ejemplo de llamada API
const response = await fetch('https://api.iziapp.es/v1/campaigns', {
method: 'GET',
headers: {
'X-API-Key': 'izi_k_1234567890abcdef',
'X-Account-ID': 'acc_987654321'
}
});¿Necesitas ayuda con la integración?
Nuestro equipo técnico está disponible para guiarte en cada paso