# Integración con AppsFlyer ESP 2.0

<Aside type="caution" icon="setting" title="Se necesita ayuda del desarrollador">
Necesitarás ayuda de tu equipo de desarrollo para configurar la integración. Comparte esta guía con ellos.
</Aside>

[AppsFlyer](https://www.appsflyer.com/) es una plataforma de atribución móvil y análisis de marketing. [AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide) es la integración de AppsFlyer para proveedores de servicios de correo electrónico (ESP). Conecta Pushwoosh con ESP 2.0 para habilitar el seguimiento de enlaces en campañas de correo electrónico. En esta integración, Pushwoosh envuelve las URL, y la solución ESP 2.0 mantiene el funcionamiento de los enlaces profundos (deep linking) para Universal Links de iOS y App Links de Android cuando los enlaces se envuelven para su seguimiento.

Esta integración también envía datos de clics en enlaces a AppsFlyer, lo que te brinda una visibilidad completa del rendimiento del correo electrónico junto con tus otros canales de marketing y te permite medir el impacto real del correo electrónico en la adquisición y el engagement de los usuarios.

## Resumen de la integración


### Prerrequisitos

*   Aplicación de Pushwoosh con [envío de correo electrónico configurado](/es/product/first-steps/start-with-your-project/configure-platforms/email-verification/)
*   Cuenta de AppsFlyer con la [integración AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide). Esta es una función premium. Contacta a tu CSM de AppsFlyer o al soporte de AppsFlyer para obtener acceso.



### Entidades sincronizadas

Los clics en enlaces de correo electrónico a través de tu Dominio de Seguimiento de Clics se registran como estadísticas de clics en Pushwoosh y como eventos de clic con datos de atribución en AppsFlyer.

### Casos de uso

*   **Seguimiento de clics en correos electrónicos:** Mide los clics en enlaces de correo electrónico a través de AppsFlyer.
*   **Deep linking desde el correo electrónico:** Mantén el funcionamiento de Universal Links (iOS) y App Links (Android) cuando los enlaces en los correos electrónicos están envueltos.

### Cómo funciona la integración


Una vez que la integración está activa, cada clic pasa por tres pasos:

1.  Pushwoosh reemplaza los enlaces en tus correos electrónicos con URL de seguimiento en tu CTD, por ejemplo:
    `https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...`

2.  Cuando un usuario toca el enlace, la solicitud va a AppsFlyer a través del CNAME configurado. AppsFlyer registra la atribución, maneja el deep linking y redirige al usuario a la URL final o a la aplicación a través de Universal Link / App Link. También envía una solicitud GET a Pushwoosh, pasando tu CTD en el encabezado Host, para que Pushwoosh pueda registrar el clic:
```
   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>
```

3.  Pushwoosh recibe la solicitud y registra el clic para sus propias estadísticas.

## Configuración de la integración

<Aside type="note" title="Pushwoosh vs. AppsFlyer">
Pushwoosh solo participa en la configuración inicial del CTD. El resto de la integración se completa del lado de AppsFlyer.
</Aside>

### Paso 1. Crear y activar un dominio de seguimiento de clics

El **Dominio de Seguimiento de Clics (CTD)** es la parte del dominio de una URL de enlace rastreada que se muestra en un mensaje de correo electrónico. Combina un subdominio con tu dominio principal, por ejemplo, `clickpush.esp-integrations1.com`. El subdominio se crea en la configuración de DNS de tu dominio con tu proveedor de dominio, generalmente agregando un registro CNAME.
<Aside type="caution" title="Se requiere un nuevo CTD">
Crear un nuevo CTD es obligatorio para la integración con AppsFlyer ESP 2.0, incluso si ya estás utilizando un dominio de seguimiento de clics existente. Usar uno nuevo evita impactar el tráfico de tus campañas de correo electrónico actuales.

Para más detalles, consulta la guía de AppsFlyer: [Configura tu integración de ESP con AppsFlyer](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-1-create-a-onelink-template-for-your-email-campaign).
</Aside>

1.  Decide qué subdominio usarás como tu CTD (por ejemplo, `clickpush.esp-integrations1.com`).
2.  En Pushwoosh, abre **Ajustes**, luego selecciona **Configurar Plataformas**.
3.  En la página de **Configuración del canal de Email**, desplázate hasta **Dominio de seguimiento personalizado** y selecciona **Activar**.

<Aside type="note" >
La sección **Dominio de seguimiento personalizado** solo se muestra después de que el canal de correo electrónico esté configurado para tu aplicación. Si no la ves, completa primero la [configuración de correo electrónico](/es/product/first-steps/start-with-your-project/configure-platforms/email-verification/).
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Panel de Control de Pushwoosh: Ajustes, Configurar Plataformas, Configuración del canal de Email, Dominio de seguimiento personalizado con Activar."/>

4.  Ingresa tu CTD en el campo **Dominio** y selecciona **Siguiente**.

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="Diálogo para activar dominio de seguimiento personalizado: Campo de Dominio, Cancelar y Siguiente."/>

5.  Fuera de Pushwoosh, abre el servicio donde administras el DNS público para el dominio de tu CTD (generalmente tu registrador de dominios, un host de DNS o tu cuenta de hosting). En su editor de DNS o de zona para ese dominio, agrega el **CNAME** que Pushwoosh muestra en este paso para que tu CTD apunte a `api.pushwoosh.com`.

<Aside type="note" title="Propagación de DNS">
Los cambios de DNS suelen tener efecto en minutos, pero pueden tardar hasta 48 horas.
</Aside>

6.  En Pushwoosh, selecciona **Verificar**.

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="Paso de DNS del dominio de seguimiento personalizado: CNAME a api.pushwoosh.com, Atrás, Verificar y Guardar."/>

7.  Cuando la verificación sea exitosa, selecciona **Guardar**.
8.  Si necesitas cambiar el **Dominio** o el registro DNS, selecciona **Atrás** y ajusta los pasos anteriores.

9.  Después de hacer clic en **Guardar**, tu CTD aparece en la lista de **Dominio de seguimiento personalizado** en la **Configuración del canal de Email**.

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="Configuración del canal de Email: Sección de dominio de seguimiento personalizado mostrando el CTD guardado en la lista."/>

Para desactivarlo más tarde, selecciona `...` junto a tu CTD, luego selecciona **Desactivar dominio de seguimiento personalizado**.

<Aside type="tip">
Antes de continuar, envía un correo electrónico de prueba y confirma que el enlace utiliza tu CTD.

**Ejemplo de enlace rastreado**

`https://clickpush.example.com/json/1.3/emailRedirect?d=...`
</Aside>

### Paso 2. Iniciar la integración en AppsFlyer

En la [plataforma de AppsFlyer](https://hq1.appsflyer.com/), inicia la integración ESP 2.0. Sigue la [guía de AppsFlyer para configurar tu integración de ESP](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer).

AppsFlyer te pedirá los siguientes detalles:

*   **Dominio de seguimiento de clics:** tu CTD (por ejemplo, `clickpush.example.com`)
*   **Endpoint del ESP:** `api.pushwoosh.com` (el destino del CNAME que se muestra en Pushwoosh cuando activas el dominio de seguimiento personalizado)

AppsFlyer validará la configuración. Mantén el CNAME del CTD apuntando a **`api.pushwoosh.com`** hasta que se complete la validación.

### Paso 3. Actualizar el CNAME a AppsFlyer

Después de que AppsFlyer valide la configuración, te dará un dominio de enrutamiento (por ejemplo, `jyvls.espclicks.appsflyer.com`).

Actualiza tu CNAME para que el CTD apunte a AppsFlyer en lugar de a Pushwoosh:

**Antes:**

`clickpush.example.com` → `api.pushwoosh.com`

**Después:**

`clickpush.example.com` → `jyvls.espclicks.appsflyer.com` (usa el dominio proporcionado por AppsFlyer)

<Aside type="note" title="Tiempo de propagación">
Después de actualizar el CNAME, la integración puede tardar hasta 24 horas en empezar a funcionar.
</Aside> 

Después de cambiar el CNAME, envía un correo electrónico de prueba y verifica que los enlaces se abran correctamente y que los clics aparezcan en AppsFlyer.

## Qué sucede a continuación

Una vez que el cambio surta efecto, el tráfico de clics pasará por la infraestructura de AppsFlyer. AppsFlyer proporciona la capa de enrutamiento, SSL, AASA (Apple App Site Association) y Android App Links.

Pushwoosh continuará envolviendo los enlaces y registrando las estadísticas de clics. No se necesita ninguna configuración adicional en Pushwoosh.

Para obtener más información sobre la configuración y las pruebas del lado de AppsFlyer, consulta:

<LinkCard title="Configura tu integración de ESP con AppsFlyer" href="https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-5-test-the-link" />

<LinkCard title="Guía de integración de proveedores de servicios de correo electrónico" href="https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide" />