Integración con Meta Ads

Se necesita la ayuda de un desarrollador

Necesitará la ayuda de su equipo de desarrollo para configurar la integración. Por favor, comparta esta guía con ellos.

La integración con Meta Ads le permite sincronizar las audiencias de Pushwoosh con sus cuentas publicitarias de Meta. Úsela para segmentar o excluir usuarios en campañas publicitarias y añadir anuncios de pago como otro canal en su customer journey.

Casos de uso

Use esta integración para:

• segmentar usuarios de alto valor en múltiples canales para aumentar las compras o la interacción
• resegmentar a los usuarios que responden menos en otros canales
• crear audiencias de supresión para que los clientes leales no reciban anuncios innecesarios

Prerrequisitos

Antes de conectar Meta Ads, asegúrese de que:

• Tiene el rol de Admin en su cuenta de Pushwoosh. Consulte Gestionar el acceso y los permisos de los usuarios para saber cómo funcionan los roles y permisos.
• Tiene un Facebook Business Manager configurado para gestionar los activos de Facebook de su marca, incluyendo cuentas publicitarias, páginas y aplicaciones.
• Tiene una Cuenta publicitaria de Facebook activa vinculada a su Business Manager.
• El administrador de su Facebook Business Manager le ha concedido permisos de Gestionar campañas o Gestionar cuentas publicitarias para las cuentas publicitarias que planea usar con Pushwoosh.
• Ha aceptado los términos y condiciones de la cuenta publicitaria para esas cuentas.
• Ha aceptado los Términos de las audiencias personalizadas de Facebook para las cuentas publicitarias de Facebook que planea usar con Pushwoosh.

Configurar Meta Ads en Pushwoosh

1. En Pushwoosh, vaya a Settings > 3rd party integrations.

2. En la tarjeta de Meta Ads, haga clic en Login page.

3. Inicie sesión en su cuenta de Meta y, a continuación, haga clic en Continuar.

4. Seleccione las cuentas publicitarias que desea conectar.

5. Revise los permisos solicitados para la cuenta publicitaria y el acceso empresarial.

6. Haga clic en Guardar. Meta mostrará una confirmación de que su cuenta está conectada.

Revisar el estado de la conexión

Después de la configuración, será redirigido a la página de Meta Ads en Pushwoosh.

La tabla de cuentas publicitarias lista cada cuenta conectada con:

• Nombre de la cuenta publicitaria
• Cuenta empresarial
• ID

Abra los tres puntos al final de una fila y elija Eliminar cuenta publicitaria para eliminar esa cuenta publicitaria de la lista en Pushwoosh.

Gestionar las cuentas publicitarias conectadas

En la página de Meta Ads, haga clic en Gestionar cuentas para abrir el diálogo. Use el interruptor en cada fila para incluir o excluir esa cuenta publicitaria de la integración. Haga clic en Aplicar para guardar los cambios o en Cancelar para cerrar sin guardar.

Para ajustar la vista de la lista:

• Active o desactive Mostrar solo conectadas para limitar las filas que aparecen.
• Escriba en Buscar por nombre o id… para encontrar cuentas en la lista.

Mapear etiquetas del proyecto a campos de Meta

El mapeo de propiedades de usuario le permite indicar a Pushwoosh qué atributos de usuario de Meta deben actualizar qué campos de Nombre de la etiqueta en su proyecto. De esa manera, cuando los datos provienen de Meta, se guardan donde usted espera.

Nota

Para la sincronización de audiencias, Pushwoosh siempre envía un identificador por usuario desde Email, Número de teléfono o MADID, dependiendo de lo que exista en el perfil. Configure el mapeo cuando desee que Meta reciba atributos de usuario adicionales más allá de los identificadores anteriores.

1. En la página de Meta Ads, haga clic en Mapear datos de usuario.

2. Para cada Campo de Facebook en la columna de la izquierda, elija un Nombre de la etiqueta en su proyecto desde el control de la derecha. Mapee solo las filas que necesite.

Campos mapeados automáticamente

Pushwoosh mapea estos campos automáticamente. No los establece en Mapear etiquetas del proyecto a campos de Meta:

• Email
• Phone number
• MADID

3. Haga clic en Guardar para aplicar el mapeo o en Cancelar para cerrar sin guardar.

Habilitar la recolección de MADID en el SDK

Meta Ads hace coincidir a los usuarios utilizando identificadores de dispositivo (MADID) recolectados a través del SDK móvil. El SDK de Pushwoosh no recolecta identificadores de publicidad (GAID en Android, IDFA en iOS) automáticamente. Ambas plataformas requieren el consentimiento explícito del usuario antes de que el identificador pueda ser leído. En su aplicación, solicite el consentimiento del usuario, lea el identificador cuando se le permita y pase el valor al SDK.

Android

1. Añada la dependencia

implementation 'com.google.android.gms:play-services-ads-identifier:...'

2. Declare el permiso AD_ID (requerido para targetSdk ≥ 33)

Añada esto a su AndroidManifest.xml:

<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>

Precaución

Sin este permiso en Android 13+, AdvertisingIdClient.getAdvertisingIdInfo() devuelve silenciosamente un UUID con ceros (00000000-0000-0000-0000-000000000000). El SDK de Pushwoosh normaliza eso a null, por lo que no se envía ningún MADID al servidor y la coincidencia de audiencias de Meta no funcionará.

3. Recupere el GAID y páselo al SDK

getAdvertisingIdInfo debe ser llamado en un hilo de fondo:

String gaid = AdvertisingIdClient.getAdvertisingIdInfo(context).getId();

Pushwoosh.getInstance().setAdvertisingId(gaid);

Para borrar el valor almacenado en el backend, pase null o una cadena vacía:

Pushwoosh.getInstance().setAdvertisingId(null);

Notas de comportamiento:

• Si el valor no ha cambiado desde la última llamada exitosa, no se realiza ninguna solicitud de red.
• Si la solicitud de red falla, reintente en el próximo inicio de la aplicación.
• La llamada se ignora cuando Pushwoosh.stopCommunication() está activo.
• El UUID con ceros (00000000-0000-0000-0000-000000000000) se trata igual que null — el MADID almacenado se borra en el backend.

iOS

1. Añada la descripción de uso a Info.plist

Apple requiere esta clave antes de mostrar el diálogo de permiso ATT:

<key>NSUserTrackingUsageDescription</key>
<string>We use your advertising identifier to show you relevant ads.</string>

2. Declare el dominio de seguimiento en su manifiesto de privacidad

Si su aplicación utiliza IDFA para el seguimiento, Apple requiere que liste los dominios que reciben datos de seguimiento en su manifiesto de privacidad (PrivacyInfo.xcprivacy). Consulte TN3182 para conocer los requisitos completos.

Establezca NSPrivacyTracking en true y añada el dominio de seguimiento de Pushwoosh a NSPrivacyTrackingDomains:

<key>NSPrivacyTracking</key>
<true/>
<key>NSPrivacyTrackingDomains</key>
<array>
    <string>tracking.svc-nue.pushwoosh.com</string>
</array>

Nota

Si el usuario no ha concedido el permiso ATT, iOS bloquea las solicitudes de red a todos los dominios listados en NSPrivacyTrackingDomains. El MADID no se enviará independientemente de lo que haga su código.

3. Solicite la autorización de seguimiento y pase el IDFA al SDK

ATTrackingManager requiere iOS 14 o posterior. Si su objetivo de despliegue es inferior a iOS 14, envuelva la llamada en una comprobación de disponibilidad.

El SDK de Pushwoosh no llama a ATTrackingManager. Solicite la autorización de seguimiento en su aplicación y luego pase el resultado al SDK:

import AppTrackingTransparency
import AdSupport

if #available(iOS 14, *) {
    ATTrackingManager.requestTrackingAuthorization { status in
        let idfa = status == .authorized
            ? ASIdentifierManager.shared().advertisingIdentifier.uuidString
            : nil
        Pushwoosh.configure.setAdvertisingId(idfa)
    }
}

Para borrar el valor almacenado en el backend, pase nil o una cadena vacía:

Pushwoosh.configure.setAdvertisingId(nil)

Notas de comportamiento:

• Si el valor no ha cambiado desde la última llamada exitosa, no se realiza ninguna solicitud de red.
• Si la solicitud de red falla, llame a setAdvertisingId de nuevo en el próximo inicio de la aplicación.
• La llamada se ignora cuando Pushwoosh_ALLOW_SERVER_COMMUNICATION está deshabilitado.
• El UUID con ceros (00000000-0000-0000-0000-000000000000) se trata igual que nil o una cadena vacía — el MADID almacenado se borra en el backend.

Llame a requestTrackingAuthorization desde el flujo principal de la interfaz de usuario de su aplicación. Apple recomienda hacerlo después de mostrar su propia pantalla explicativa, no inmediatamente al iniciar.

Cómo funciona

Una vez que llama a setAdvertisingId, el SDK envía el valor al punto final de seguimiento de Pushwoosh como el campo madid junto con el código de la aplicación y el ID de hardware del dispositivo. Pushwoosh utiliza este identificador para hacer coincidir sus registros de dispositivos con las audiencias de Meta Ads para la sincronización.

Sincronizar audiencias en journeys

El punto de Sincronización de audiencias en Journey Builder vincula su journey a una Audiencia Personalizada de Meta. Cada vez que un usuario llega a ese punto, Pushwoosh le pide a Meta que lo añada a la audiencia o lo elimine de ella.

Por ejemplo, puede usar esto para dejar de mostrar un anuncio de un seminario web a los usuarios que ya se han registrado, para no malgastar el presupuesto publicitario en personas que ya no necesitan verlo.

Para configurar la sincronización de audiencias:

1. Abra Journey Builder.

2. Añada una Entrada basada en audiencia. En Fuente de audiencia, elija un segmento o lista de Pushwoosh que defina quién entra en este journey. Por ejemplo, un segmento Usuarios con la etiqueta webinar_registered establecida en true. Solo esos usuarios se moverán a través del journey y llegarán a Sincronización de audiencias.

3. Añada el punto de Sincronización de audiencias.

4. En Cómo sincronizar la información de los usuarios con la audiencia de Meta, elija una opción:

   • Añadir usuarios a la audiencia. Añade a cada usuario que llega a este paso a la audiencia de Meta que seleccione. Por ejemplo, use esto para empezar a mostrar un anuncio a los usuarios que se inscribieron pero aún no han asistido.
   • Eliminar usuarios de la audiencia. Elimina a cada usuario que llega a este paso de esa audiencia de Meta. En este ejemplo, seleccione esta opción para dejar de mostrar el anuncio del seminario web a los usuarios que ya se registraron.

5. En Cuenta de Meta Ads, seleccione la cuenta publicitaria conectada.

6. En Audiencia, seleccione la audiencia de Meta, por ejemplo Webinar.

7. Haga clic en Aplicar para guardar el punto o en Cancelar para cerrar sin guardar.

8. Termine de configurar el journey y luego láncelo.

Cuando esos usuarios llegan a Sincronización de audiencias, son eliminados de la audiencia Webinar en Meta, por lo que ya no ven el anuncio del seminario web allí.

Comportamiento y manejo de errores

El procesamiento del journey depende de la disponibilidad de la cuenta y la audiencia de Meta:

• Meta actualiza la audiencia solo cuando puede hacer coincidir al usuario con los datos que proporciona Pushwoosh. Si Meta no puede hacer coincidir al usuario, la audiencia no cambia para ese usuario, y continúan en el journey.
• Si un perfil llega al punto de Sincronización de audiencias mientras la cuenta publicitaria conectada está desconectada, el journey se detiene para ese perfil y Pushwoosh envía notificaciones del sistema y por correo electrónico.
• Si una audiencia seleccionada no se encuentra en Meta y la API devuelve un error, el journey se detiene para ese perfil y Pushwoosh envía notificaciones del sistema y por correo electrónico.

Estadísticas de sincronización de audiencias

Después del lanzamiento, abra las estadísticas para el paso de Sincronización de audiencias para ver el volumen de entradas, adiciones y eliminaciones, y perfiles omitidos. Para detalles de las métricas, consulte Sincronización de audiencias en Estadísticas de Customer Journey.