---
title: "Asapty"
description: "Descubre Asapty y su papel en el ecosistema de suscripciones de Adapty."
---

Con la integración de [Asapty](https://asapty.com/) 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](apple-search-ads).

## Configurar la integración \{#set-up-integration\}

### Conectar Adapty con Asapty \{#connect-adapty-to-asapty\}

Para integrar Asapty, ve a [Integrations > Asapty](https://app.adapty.io/integrations/asapty) en el Adapty Dashboard y rellena el campo con tu Asapty ID.

  <img src="/assets/shared/img/895de2b-CleanShot_2023-08-14_at_18.57.462x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

El Asapty ID se encuentra en la sección Settings > General de tu cuenta de Asapty.

### Configurar eventos y etiquetas \{#configure-events-and-tags\}

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í](events).

  <img src="/assets/shared/img/58ddf41-CleanShot_2023-08-15_at_15.11.072x.webp"
  style={{
    border: '1px solid #727272', /* border width and color */
    width: '700px', /* image width */
    display: 'block', /* for alignment */
    margin: '0 auto' /* center alignment */
  }}
/>

Recomendamos usar los nombres de evento predeterminados que proporciona Asapty, aunque puedes cambiarlos según tus necesidades.

### Conectar tu app con Asapty \{#connect-your-app-to-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 \{#asapty-event-structure\}

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...%7D
```

Pará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 \{#troubleshooting\}

- Asegúrate de haber configurado [Apple Search Ads](apple-search-ads) en Adapty y de haber [subido las credenciales](https://app.adapty.io/settings/apple-search-ads); 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**](https://app.adapty.io/settings/apple-search-ads).