Documento

A integração entre a Singular e a Braze melhora as suas capacidades de marketing ao incorporar dados de atribuição móvel diretamente na sua plataforma de envolvimento do cliente. Esta conexão perfeita permite-lhe criar campanhas de marketing de ciclo de vida mais direcionadas e eficazes.

Importante:

As redes de anúncios com restrições de partilha de dados impedem a transmissão de postback a parceiros terceiros, anulando quaisquer definições de postback configuradas. Veja mais detalhes aqui para fontes de mídia que têm restrições de compartilhamento de dados com terceiros.

Pré-requisitos

Requisito	Descrição
Aplicativo iOS ou Android	Esta integração suporta aplicações iOS e Android. Dependendo da sua plataforma, podem ser necessários trechos de código na sua aplicação. Detalhes sobre esses requisitos podem ser encontrados na etapa 1 do processo de integração.
SDK do Singular e SDK do Braze	Além do SDK Braze necessário, é preciso instalar o SDK Singular

Integração

Para concluir a integração com o Braze, será necessário atualizar a integração do SDK do Singular e passar a ID do dispositivo Braze por meio das Propriedades globais do Singular. Consulte nossa documentação do SDK sobre Propriedades globais(documentação do SDK do Android e documentação do SDK do iOS).

Etapa 1: mapear IDs de usuário

Android

Se você tiver um aplicativo Android, precisará incluir o seguinte trecho de código, que passa um ID de usuário Braze exclusivo para o 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 fevereiro de 2023, nossa integração de atribuição Singular usava o IDFV como o identificador principal para corresponder aos dados de atribuição do iOS. Não é necessário que os clientes Braze que usam Objective-C busquem o Braze device_id e o enviem para a Singular após a instalação, pois não haverá interrupção do serviço.

Para aqueles que usam o Swift SDK v5.7.0+, se desejarem continuar usando o IDFV como identificador mútuo, é necessário garantir que o campo useUUIDAsDeviceId esteja definido como false para que não haja interrupção da integração.

Se definido como true, você deve implementar o mapeamento iOS device ID para Swift a fim de passar o device_id do Braze para o Singular na instalação do aplicativo para que o Braze corresponda adequadamente às atribuições do 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];

Etapa 2: obter a chave de importação de dados do Braze

No Braze, navegue até Partner Integrations > Technology Partners e selecione Singular.

Nota: Se você estiver usando a navegação mais antiga, poderá encontrar Parceiros de Tecnologia em Integrações.

Aqui, você encontrará o ponto de extremidade REST e gerará sua chave de importação de dados do Braze. Depois que a chave for gerada, você pode criar uma nova chave ou invalidar uma existente.

Você precisará fornecer a chave de importação de dados e o ponto de extremidade REST ao seu gerente de conta Singular para concluir a integração.

Etapa 3: Ativar o Postback do Braze

No Singular, navegue até Atribuição > Configuração de parceiro no menu à esquerda.

Clique no botão"Adicionar parceiro" e procure por"Braze".
Selecione seu aplicativo
Insira a chave de importação de dados do Braze recebida na etapa anterior
Selecione o nome de domínio Braze
Clique em Guardar

Etapa 4: Confirmar a integração

Quando o Braze receber dados de atribuição da Singular, o indicador de status da conexão na página de parceiros de tecnologia da Singular no Braze mudará de "Não conectado" para "Conectado". Um registro de data e hora da última solicitação bem-sucedida também será incluído.

Observe que isso não ocorrerá até recebermos dados sobre uma instalação atribuída. As instalações orgânicas, que devem ser excluídas do postback do Singular, são ignoradas por nossa API e não são contadas ao determinar se uma conexão bem-sucedida foi estabelecida.