Documento

La integración entre Singular y Braze mejora sus capacidades de marketing mediante la incorporación de datos de atribución móvil directamente en su plataforma de captación de clientes. Esta conexión sin fisuras le permite crear campañas de marketing de ciclo de vida más específicas y eficaces.

Importante:

Las redes publicitarias con restricciones de uso compartido de datos impiden la transmisión de postback a socios de terceros, anulando cualquier configuración de postback configurada. Consulte aquí más detalles sobre las fuentes de medios que tienen restricciones de uso compartido de datos con terceros.

Requisitos previos

Requisito	Descripción
Aplicación iOS o Android	Esta integración es compatible con aplicaciones iOS y Android. Dependiendo de su plataforma, pueden ser necesarios fragmentos de código en su aplicación. Encontrará información detallada sobre estos requisitos en el paso 1 del proceso de integración.
SDK Singular y SDK Braze	Además del SDK Braze necesario, debe instalar el SDK Singular

Integración

Para completar la integración Braze, deberá actualizar su integración Singular SDK y pasar el ID de dispositivo Braze a través de las Propiedades globales de Singular. Consulte nuestra documentación SDK sobre Propiedades Globales(documentación SDK Android y documentación SDK iOS).

Paso 1: Asignar ID de usuario

Android

Si tiene una aplicación Android, tendrá que incluir el siguiente fragmento de código, que pasa un ID de usuario Braze único a Singular.

// Retrieve the Braze deviceId

val brazeDeviceID = Braze.getInstance(context).deviceId

// Set the Singular Global Property in the Singular Config

val config = SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true)

// Retrieve the Braze deviceId

String brazeDeviceID = Braze.getInstance(context).getDeviceId();

// Set the Singular Global Property in the Singular Config

SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
   .withGlobalProperty("brazeDeviceID", brazeDeviceID, true);

iOS

Importante:

Antes de febrero de 2023, nuestra integración de atribución de Singular utilizaba el IDFV como identificador principal para hacer coincidir los datos de atribución de iOS. No es necesario que los clientes de Braze que utilicen Objective-C obtengan el Braze device_id y lo envíen a Singular al instalarlo, ya que no habrá interrupción del servicio.

Para aquellos que utilicen Swift SDK v5.7.0+, si desean seguir utilizando IDFV como identificador mutuo, deben asegurarse de que el campo useUUIDAsDeviceId está configurado como false para que no haya interrupciones en la integración.

Si se establece en true, debe implementar la asignación de iOS device ID para Swift con el fin de pasar el device_id de Braze a Singular al instalar la aplicación para que Braze coincida adecuadamente con las atribuciones de iOS.

// Retrieve the Braze deviceId

let brazeDeviceId = AppDelegate.braze?.deviceId

// Set the Singular Global Property in the Singular Config

config.setGlobalProperty("brazeDeviceId", withValue: brazeDeviceId, overrideExisting: true)

// Retrieve the Braze deviceId

NSString *brazeDeviceId = ((AppDelegate *)[UIApplication sharedApplication].delegate).braze.deviceId;

// Set the Singular Global Property in the Singular Config

[config setGlobalProperty:@"brazeDeviceId" withValue:brazeDeviceId overrideExisting:YES];

Paso 2: Obtenga la clave de importación de datos Braze

En Braze, vaya a Partner Integrations > Technology Partners y seleccione Singular.

Nota: Si utiliza la navegación anterior, encontrará Technology Partners en Integrations.

Aquí encontrará el punto final REST y generará su clave de importación de datos Braze. Una vez generada la clave, puede crear una nueva o invalidar una existente.

Deberá proporcionar la clave de importación de datos y el punto final REST al gestor de su cuenta Singular para completar la integración.

Paso 3: Activar Braze Postback

En Singular, vaya a Atribución > Configuración de socios en el menú de la izquierda.

Haga clic en el botón"Añadir socio" y busque"Braze".
Seleccione su App
Introduzca la clave de importación de datos Braze recibida en el paso anterior.
Seleccione el nombre de dominio Braze
Haga clic en Guardar

Paso 4: Confirmar la integración

Una vez que Braze reciba los datos de atribución de Singular, el indicador de estado de la conexión en la página de socios tecnológicos de Singular en Braze cambiará de "No conectado" a "Conectado". También se incluirá una marca de tiempo de la última solicitud realizada con éxito.

Tenga en cuenta que esto no ocurrirá hasta que recibamos datos sobre una instalación atribuida. Las instalaciones orgánicas, que deben excluirse del postback de Singular, son ignoradas por nuestra API y no se tienen en cuenta a la hora de determinar si se ha establecido una conexión correcta.