Singular

A Singular é uma plataforma unificada de análise de dados de marketing que oferece atribuição, agregação de custos, análise de marketing, relatórios criativos e automação de fluxo de trabalho.

Essa integração é mantida pela Singular.

Sobre a integração

A integração da Braze com a Singular permite importar dados de atribuição de instalações pagas para segmentar de forma inteligente dentro das suas campanhas de ciclo de vida.

Pré-requisitos

Integração

Etapa 1: Mapear IDs de usuário

Android

Se você tem um app Android, precisará incluir o seguinte snippet de código, que passa um ID de usuário exclusivo da Braze para a Singular.

1
2
3

String appboyDeviceId = Braze.getInstance(context).getDeviceId();
SingularConfig config = new SingularConfig("SDK KEY", "SDK SECRET")
  .withGlobalProperty(“brazeDeviceID”, appboyDeviceId, true);

iOS

Importante

Antes de fevereiro de 2023, nossa integração de atribuição com a Singular usava o Identifier for Vendor (IDFV) como identificador principal para corresponder dados de atribuição do iOS. Não é necessário que clientes da Braze usando Objective-C busquem o device_id da Braze e o enviem para a Singular na instalação, pois não há interrupção do serviço.

Para quem usa o Swift SDK v5.7.0+, se você deseja continuar usando o IDFV como identificador mútuo, deve garantir que o campo useUUIDAsDeviceId esteja definido como false para que não haja interrupção da integração.

Se estiver definido como true, você precisará implementar o mapeamento de ID de dispositivo iOS para Swift a fim de passar o device_id da Braze para a Singular na instalação do app, para que a Braze corresponda corretamente as atribuições do iOS.

• objective-c
• swift

1
2
3
4
5
6

SingularConfig* config = [[SingularConfig
  alloc] initWithApiKey:SDKKEY andSecret:SDKSECRET];

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

1

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

Etapa 2: Obter a chave de importação de dados da Braze

Na Braze, navegue até Integrações com parceiros > Parceiros de tecnologia e selecione Singular.

Nessa página, você encontrará o endpoint REST e poderá gerar sua chave de importação de dados da Braze. Após a geração da chave, você pode criar uma nova ou invalidar uma existente.

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

Etapa 3: Confirmar a integração

Na página de parceiros de tecnologia da Singular na Braze, o indicador de conexão mostra Not Connected até você gerar uma chave de API de importação de dados na Etapa 2. Após a geração da chave, o indicador muda para Connected e exibe um registro de data e hora. Esse registro reflete quando a integração foi configurada pela primeira vez na Braze (quando a chave de importação de dados foi criada), e não quando a Singular enviou um postback pela última vez.

Para confirmar que os dados de atribuição de instalação estão fluindo da Singular, verifique se os dados de instalação não orgânica aparecem nos filtros de Segment da Braze. A Braze ignora instalações orgânicas dos postbacks da Singular e não os armazena como dados de instalação atribuída.

Dados de atribuição do Facebook e X (anteriormente Twitter)

Os dados de atribuição de campanhas do Facebook e X (anteriormente Twitter) não estão disponíveis por meio de nossos parceiros. Essas fontes de mídia não permitem que seus parceiros compartilhem dados de atribuição com terceiros e, portanto, nossos parceiros não podem enviar esses dados para a Braze.

URLs de rastreamento de cliques da Singular na Braze (opcional)

Usar links de rastreamento de cliques em suas campanhas da Braze permite que você veja facilmente quais campanhas estão gerando instalações de app e reengajamento. Com isso, você poderá medir seus esforços de marketing de forma mais eficaz e tomar decisões orientadas por dados sobre onde investir mais recursos para obter o máximo ROI.

Para começar a usar links de rastreamento de cliques da Singular, acesse a documentação deles. Você pode inserir os links de rastreamento de cliques da Singular diretamente em suas campanhas da Braze. A Singular usará suas metodologias de atribuição probabilística para atribuir o usuário que clicou no link. Recomendamos adicionar um identificador de dispositivo aos seus links de rastreamento da Singular para melhorar a precisão das atribuições das suas campanhas da Braze. Isso atribuirá de forma determinística o usuário que clicou no link.

• android
• ios

1
2
3

{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3

{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}

Nota

Essa recomendação é totalmente opcional
Se você não utiliza identificadores de dispositivo atualmente — como o ID de dispositivo da Braze ou o GAID — nos seus links de rastreamento de cliques, ou não planeja usar no futuro, a Singular ainda pode atribuir esses cliques por meio de sua modelagem probabilística.