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 específica no añade datos de atribución a Adapty, ya que obtenemos todo lo que necesitamos 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
Los eventos no llegan a Adapty
- 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 ASA detallada y no orgánica enviarán sus eventos a Asapty. Verás “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 una configuración correcta, asegúrate de que el toggle Receive Apple Search Ads attribution in Adapty esté habilitado en la pestaña App Settings -> Apple Search Ads.
access_level_updated aparece como fallido en el Event Feed
access_level_updated es un evento exclusivo de webhooks. Adapty nunca lo envía a esta integración. Sin embargo, Adapty registra un resultado para cada integración habilitada, y un evento no compatible se muestra como un error.