Singular

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

A integração entre o Braze e o Singular permite importar dados de atribuição de instalação paga para segmentar de forma inteligente suas campanhas de ciclo de vida.

Pré-requisitos

Integração

Etapa 1: Mapear IDs de usuários

Android

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

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

iOS

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

Se estiver definido como true, implemente o mapeamento de ID do 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 possa corresponder adequadamente 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: Obtenha a chave de importação de dados do Braze

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

Aqui você encontra o endpoint REST e gera sua chave de importação de dados da Braze. Depois que a chave é gerada, você pode criar outra ou invalidar uma existente.

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

Etapa 3: Confirmar a integração

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

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

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

Os dados de atribuição para campanhas do Facebook e do X (antigo 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 singulares no Braze (opcional)

Usar links de rastreamento de cliques em suas campanhas da Braze permitirá que você veja facilmente quais campanhas estão gerando instalações de apps e reengajamento. Como resultado, você será capaz de medir seus esforços de marketing de forma mais eficaz e tomar decisões baseadas em dados sobre onde investir mais recursos para obter o máximo retorno sobre o investimento.

Para começar a usar os links de rastreamento de cliques da Singular, visite sua documentação. Você pode inserir os links de rastreamento de cliques da Singular diretamente em suas campanhas do Braze. A Singular usará então suas metodologias de atribuição probabilística para atribuir o usuário que clicou no link. Recomendamos anexar seus links de rastreamento Singular com um identificador de dispositivo para melhorar a precisão das atribuições de suas campanhas 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 %}