OneSignal

OneSignal es una plataforma líder de engagement con clientes que ofrece notificaciones push, correo electrónico, SMS y mensajería in-app. Integrar Adapty con OneSignal te permite acceder a todos tus eventos de suscripción en un solo lugar, lo que te permite activar comunicaciones automatizadas basadas en esos eventos.

Con Adapty puedes hacer seguimiento de eventos de suscripción en múltiples stores, analizar el comportamiento de los usuarios y usar esos datos para una comunicación más segmentada. Esta integración te ayuda a monitorear eventos de suscripción dentro de tu dashboard de OneSignal y asociarlos con tus campañas de adquisición.

Adapty actualiza las etiquetas de OneSignal en función de los eventos de suscripción, lo que te permite enviar notificaciones push personalizadas con una configuración mínima.

Características de la integración

Configurar la integración con OneSignal

Para configurar la integración:

1. Abre Integrations → OneSignal en tu Adapty Dashboard.

   

2. Activa el interruptor de la integración.

3. Introduce tu OneSignal App ID.

Para configurar la integración con OneSignal, ve a Integrations -> OneSignal en tu Adapty dashboard, activa el interruptor y configura las credenciales de la integración.

Obtener tu OneSignal App ID

Encuentra tu OneSignal App ID en tu OneSignal Dashboard:

1. Ve a Settings → Keys & IDs.

   

2. Copia tu OneSignal App ID y pégalo en el campo App ID del Adapty Dashboard.

   

Puedes encontrar más información sobre el ID de OneSignal en la siguiente documentación.

Configurar eventos

Adapty te permite enviar tres grupos de eventos a OneSignal. Activa los que necesites en el Adapty Dashboard. Puedes ver la lista completa de eventos disponibles con una descripción detallada aquí.

Adapty envía eventos de suscripción a OneSignal mediante una integración servidor a servidor, lo que te permite hacer seguimiento de toda la actividad relacionada con suscripciones en OneSignal.

Etiquetas personalizadas

Esta integración actualiza y asigna diversas propiedades a tus usuarios de Adapty como etiquetas, que luego se envían a OneSignal. Consulta la lista de etiquetas a continuación para encontrar las que mejor se adapten a tus necesidades.

Todos los valores de tipo float se redondean a enteros. Las cadenas de texto se mantienen sin cambios.

Además de las etiquetas predefinidas, puedes enviar atributos personalizados como etiquetas, lo que proporciona mayor flexibilidad en los datos que incluyes. Esto es útil para rastrear detalles específicos relacionados con tu producto o servicio.

Los atributos personalizados de usuario se envían automáticamente a OneSignal si la casilla Send user attributes está marcada en la página de integración. Si no está marcada, Adapty envía exactamente 10 etiquetas. Si está marcada, se pueden enviar más de 10 etiquetas, lo que permite capturar más datos.

Configuración del SDK

Hay dos formas de integrar OneSignal con Adapty:

1. Legacy (anterior a v5): Usa playerId (obsoleto en el OneSignal SDK v5).
2. Actual (v5+): Usa subscriptionId.

// SubscriptionID
OneSignal.Notifications.requestPermission({ accepted in
    Task {
        try await Adapty.setIntegrationIdentifier(
            key: "one_signal_subscription_id", 
            value: OneSignal.User.pushSubscription.id
        )
    }
}, fallbackToSettings: true)

// SubscriptionID
val oneSignalSubscriptionObserver = object: IPushSubscriptionObserver {
    override fun onPushSubscriptionChange(state: PushSubscriptionChangedState) {
        Adapty.setIntegrationIdentifier("one_signal_subscription_id", state.current.id) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
}

// SubscriptionID
IPushSubscriptionObserver oneSignalSubscriptionObserver = state -> {
    Adapty.setIntegrationIdentifier("one_signal_subscription_id", state.getCurrent().getId(), error -> {
        if (error != null) {
            // handle the error
        }
    });
};

// 1. Since OneSignal.User.pushSubscription.id may return null if called too early, 
// OneSignal suggests to listen for the updates:

OneSignal.User.pushSubscription.addObserver((state) {
   if (state.current.optedIn) {
      // now you can try to retrieve subscriptionId
   }
});

// 2. Then you can push subscriptionId to Adapty:
final subscriptionId = OneSignal.User.pushSubscription.id;
if (subscriptionId != null) {
   await Adapty().setIntegrationIdentifier(key: "one_signal_subscription_id", value: subscriptionId);
}

using AdaptySDK;
using OneSignalSDK;

var pushUserId = OneSignal.Default.PushSubscriptionState.userId;

Adapty.SetIntegrationIdentifier(
  "one_signal_player_id", 
  pushUserId, 
  (error) => {
  // handle the error
});

OneSignal.User.pushSubscription.addEventListener('change', (subscription) => {
  const subscriptionId = subscription.current.id;

  if (subscriptionId) {
    adapty.setIntegrationIdentifier("one_signal_subscription_id", subscriptionId);
  }
});

// PlayerID
// in your OSSubscriptionObserver implementation
func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
    if let playerId = stateChanges.to.userId {
        Task {
            try await Adapty.setIntegrationIdentifier(
                key: "one_signal_player_id", 
                value: playerId
            )
        }
    }
}

// PlayerID
val osSubscriptionObserver = OSSubscriptionObserver { stateChanges ->
    stateChanges?.to?.userId?.let { playerId ->
        Adapty.setIntegrationIdentifier("one_signal_player_id", playerId) { error ->
            if (error != null) {
                // handle the error
            }
        }
    }
}

// PlayerID
OSSubscriptionObserver osSubscriptionObserver = stateChanges -> {
    OSSubscriptionState to = stateChanges != null ? stateChanges.getTo() : null;
    String playerId = to != null ? to.getUserId() : null;
    
    if (playerId != null) {
        Adapty.setIntegrationIdentifier("one_signal_player_id", playerId, error -> {
            if (error != null) {
                // handle the error
            }
        });
    }
};

// PlayerID (pre-v5 OneSignal SDK)
// in your OSSubscriptionObserver implementation
func onOSSubscriptionChanged(_ stateChanges: OSSubscriptionStateChanges) {
    if let playerId = stateChanges.to.userId {
        Task {
            try await Adapty.setIntegrationIdentifier(
                key: "one_signal_player_id", 
                value: playerId
            )
        }
    }
}

OneSignal.addSubscriptionObserver(event => {
  const playerId = event.to.userId;
  
  adapty.setIntegrationIdentifier("one_signal_player_id", playerId);
});

Más información en la documentación de OneSignal:

• ID de suscripción push
• Cambios en la suscripción push

Gestionar múltiples dispositivos

Si un usuario tiene varios dispositivos, hacer seguimiento de los eventos de compra y las suscripciones puede ser complicado. OneSignal ofrece una forma de gestionar esto mediante IDs de usuario externos.

Para mantener los datos del usuario coherentes entre dispositivos:

1. Relaciona los distintos dispositivos en tu servidor y envía esos datos a OneSignal.
2. Usa el customer_user_id de Adapty como externalUserId en OneSignal. Si tu app no tiene un sistema de registro, considera usar otro identificador único que sea constante en todos los dispositivos del usuario.

Es importante mantener la coherencia del identificador de usuario en todos los dispositivos y actualizar OneSignal cada vez que cambie el ID de un usuario. Esto simplifica el seguimiento de la actividad y las suscripciones, garantiza una mensajería coherente y permite obtener análisis más precisos y una mejor experiencia de usuario. Para más detalles, consulta la documentación de ID de usuario externo de OneSignal.