Asapty
Con la integración de Asapty puedes optimizar tus campañas de Search Ads. Adapty envía eventos de suscripción a Asapty para que puedas crear dashboards personalizados basados en la atribución de Apple Search Ads.
Esta integración en concreto no añade ningún dato de atribución a Adapty, ya que obtenemos todo lo necesario directamente desde ASA.
Configurar la integración
Conectar Adapty con Asapty
Para integrar Asapty, ve a Integrations > Asapty en el Adapty Dashboard y rellena el campo con tu Asapty ID.
El Asapty ID se encuentra en la sección Settings > General de tu cuenta de Asapty.
Configurar eventos y etiquetas
Justo debajo de las credenciales encontrarás tres grupos de eventos que puedes enviar a Asapty desde Adapty. Activa únicamente los que necesites. Consulta la lista completa de eventos que ofrece Adapty aquí.
Recomendamos usar los nombres de evento predeterminados que proporciona Asapty, aunque puedes cambiarlos según tus necesidades.
Conectar tu app con Asapty
Una vez completados los pasos anteriores, Adapty recibe automáticamente los datos de atribución de Asapty. No es necesario solicitar explícitamente esos datos en el código de tu aplicación. Para mejorar la precisión de la atribución, configura Asapty para que incluya el customerUserId en los datos de cada evento.
Estructura de eventos de Asapty
Adapty envía eventos a Asapty mediante una petición GET con parámetros de consulta. Cada URL de evento tiene este aspecto:
https://asapty.com/_api/mmpEvents/?source=adapty&asaptyid=a1b2c3d4&keywordid=12345&adgroupid=67890&campaignid=11223&conversiondate=1709294400000&event_name=subscription_renewed&install_time=1709100000&app_name=MyApp&json=%7B%22af_revenue%22%3A%229.99%22%2C%22af_currency%22%3A%22USD%22...%7DParámetros de consulta:
| Parámetro | Tipo | Descripción |
|---|---|---|
source | String | Siempre “adapty”. |
asaptyid | String | El Asapty ID de tus credenciales. |
keywordid | String | ID de palabra clave de Apple Search Ads (si está disponible). |
adgroupid | String | ID del grupo de anuncios de Apple Search Ads (si está disponible). |
campaignid | String | ID de campaña de Apple Search Ads (si está disponible). |
conversiondate | Long | Marca de tiempo del evento en milisegundos. |
event_name | String | Nombre del evento (mapeado desde el evento de Adapty). |
install_time | Long | Marca de tiempo de la instalación en segundos. |
app_name | String | Título de la app en Adapty (si está disponible). |
json | String | Cadena JSON codificada en URL con los detalles del evento (ver más abajo). |
El parámetro json es una cadena JSON codificada en URL que contiene los siguientes campos:
| Parámetro | Tipo | Descripción |
|---|---|---|
af_revenue | String | Importe de ingresos como cadena de texto. |
af_currency | String | Código de moneda (p. ej., “USD”). |
transaction_id | String | ID de transacción del store. |
original_transaction_id | String | ID de transacción original del store. |
purchase_date | Long | Marca de tiempo de la compra en milisegundos. |
original_purchase_date | Long | Marca de tiempo de la compra original en milisegundos. |
environment | String | Production o Sandbox. |
vendor_product_id | String | ID del producto en el store. |
profile_country | String | Código de país basado en la IP del usuario. |
store_country | String | Código de país del store del usuario. |
Solución de problemas
- Asegúrate de haber configurado Apple Search Ads en Adapty y de haber subido las credenciales; sin ellas, Asapty no funcionará.
- Solo los perfiles con atribución de ASA detallada y no orgánica enviarán sus eventos a Asapty. Verás el mensaje “The user profile is missing the required integration data.” si la atribución no es suficiente.
- Los perfiles creados antes de configurar las integraciones no podrán enviar sus eventos a Asapty.
- Si la integración con Adapty no funciona a pesar de estar correctamente configurada, comprueba que el toggle Receive Apple Search Ads attribution in Adapty esté activado en la pestaña App Settings -> Apple Search Ads.