Singular es una de las principales plataformas MMP (Mobile Measurement Partner) que recopila y presenta datos de campañas de marketing, lo que ayuda a las empresas a hacer seguimiento del rendimiento de sus campañas.

Adapty proporciona un conjunto completo de datos que te permite rastrear eventos de suscripción desde los stores en un solo lugar. Con Adapty, puedes ver fácilmente el comportamiento de tus suscriptores, conocer sus preferencias y usar esa información para comunicarte con ellos de forma dirigida y efectiva. Esta integración te permite, por tanto, rastrear eventos de suscripción en Singular y analizar con precisión cuántos ingresos generan tus campañas.

Adapty puede enviar a Singular todos los eventos de suscripción configurados en tu integración. Como resultado, podrás hacer seguimiento de esos eventos desde el dashboard de Singular. Esta integración es especialmente útil para evaluar la efectividad de tus campañas publicitarias.

Configurar la integración

Conectar Adapty con Singular

Para configurar la integración con Singular, ve a Integrations > Singular en tu Adapty Dashboard, activa el interruptor y rellena los campos.

Las siguientes credenciales están disponibles:

• Singular SDK Key: Obligatoria. La clave SDK de producción de tu app en Singular.
• Singular SDK Key (Sandbox): Opcional. La clave SDK para tu app de Singular en sandbox. Si no se configura, los eventos de sandbox no se enviarán a Singular.

Ambas claves se encuentran en el dashboard de Singular en Developer tools -> SDK Keys -> SDK Key (no SDK Secret):

Debajo de las credenciales encontrarás tres grupos de eventos que puedes enviar a Singular desde Adapty. Consulta la lista completa de eventos que ofrece Adapty aquí.

Te recomendamos usar los nombres de evento predeterminados que proporciona Adapty, aunque puedes modificarlos según tus necesidades.

Adapty enviará los eventos de suscripción a Singular mediante una integración server-to-server, lo que te permitirá ver todos los eventos de suscripción en tu dashboard de Singular y vincularlos con tus campañas de adquisición.

Conectar tu app con Singular

La integración entre Adapty y Singular es server-to-server, por lo que no necesitas añadir ningún código adicional en tu aplicación.

Estructura del evento

Adapty envía eventos a Singular mediante una solicitud GET con parámetros de consulta. Cada evento tiene esta estructura:

{
  "n": "subscription_renewed",
  "a": "singular_sdk_key_123",
  "p": "iOS",
  "i": "com.example.app",
  "ip": "192.168.100.1",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "ve": "17.0.1",
  "att_authorization_status": 3,
  "custom_user_id": "user_12345",
  "utime": 1709294400,
  "amt": 9.99,
  "cur": "USD",
  "purchase_product_id": "yearly.premium.6999",
  "purchase_transaction_id": "GPA.3383...",
  "e": "{\"is_revenue_event\":true,\"amt\":9.99,\"cur\":\"USD\",\"purchase_product_id\":\"yearly.premium.6999\",\"purchase_transaction_id\":\"GPA.3383...\"}"
}

Donde:

Parámetro	Tipo	Descripción
n	String	El nombre del evento (mapeado desde el evento de Adapty).
a	String	Tu Singular SDK Key.
p	String	Plataforma (“iOS” o “Android”).
i	String	ID de la app en el store (Bundle ID).
ip	String	Dirección IP del usuario.
idfa	String	Solo iOS. ID for Advertisers (en mayúsculas).
idfv	String	Solo iOS. ID for Vendors (en mayúsculas).
aifa	String	Solo Android. Google Advertising ID (en minúsculas).
andi	String	Solo Android. Android ID (en minúsculas).
asid	String	Solo Android. App Set ID (en minúsculas).
ve	String	Versión del sistema operativo.
att_authorization_status	Integer	Solo iOS. Estado ATT (p. ej., 3 para autorizado).
custom_user_id	String	El Customer User ID del usuario.
utime	Long	Marca de tiempo UNIX del evento en segundos.
amt	Float	Importe de los ingresos.
cur	String	Código de moneda (p. ej., “USD”).
purchase_product_id	String	El ID del producto en el store.
purchase_transaction_id	String	ID de transacción original.
e	String	Cadena JSON con los detalles del evento (ver más abajo).

El parámetro e (datos de evento personalizados) es una cadena codificada en JSON que contiene:

Parámetro	Tipo	Descripción
is_revenue_event	Boolean	true si el evento incluye ingresos.
amt	Float	Importe de los ingresos.
cur	String	Código de moneda.
purchase_product_id	String	El ID del producto en el store.
purchase_transaction_id	String	ID de transacción original.