Branch para atribuição

A Branch é uma plataforma de links móveis que ajuda a adquirir, engajar e medir em todos os dispositivos, canais e plataformas por meio de uma visão holística de todos os pontos de contato dos usuários.

Essa integração é mantida pela Branch.

Sobre a integração

A integração da Braze com a Branch ajuda você a entender exatamente quando e onde os usuários foram adquiridos, além de como personalizar suas jornadas por meio de atribuição robusta e deep linking.

Pré-requisitos

Integração

Etapa 1: Mapear IDs de dispositivo

Android

Se você tem um app Android, será necessário passar um ID de dispositivo exclusivo da Braze para o Branch. Esse ID pode ser definido no método setRequestMetadataKey() do SDK do Branch. O trecho de código a seguir deve ser incluído antes de chamar initSession. Você também deve inicializar o SDK da Braze antes de definir os metadados de solicitação no SDK do Branch.

• java
• kotlin

1

Branch.getInstance().setRequestMetadata("$braze_install_id", Braze.getInstance(context).deviceId);

1

Branch.getInstance().setRequestMetadata("$braze_install_id", Braze.getInstance(context).deviceId)

iOS

Importante

Antes de fevereiro de 2023, nossa integração de atribuição com o Branch usava o Identifier for Vendor (IDFV) como identificador principal para corresponder os 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 ao Branch 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ê deve implementar o mapeamento de ID de dispositivo iOS para Swift a fim de passar o device_id da Braze ao Branch na instalação do app, para que a Braze faça a correspondência correta das atribuições do iOS.

• objective-c
• swift

1
2
3
4

[braze deviceIdOnQueue:dispatch_get_main_queue() completion:^(NSString * _Nonnull deviceId) {
  [[Branch getInstance] setRequestMetadataKey:@"$braze_install_id" value:deviceId];
  // Branch init
}];

1
2
3
4

braze.deviceId { deviceId in
  Branch.getInstance.setRequestMetadata("$braze_install_id", deviceId)
  // Branch init
}

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

Na Braze, acesse Integrações com Parceiros > Parceiros de Tecnologia e selecione Branch.

Lá, 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. A chave de importação de dados e o endpoint REST são usados na próxima etapa ao configurar um postback no dashboard do Branch.

Etapa 3: Configurar Data Feeds

1. No Branch, na seção Exports, selecione Data Feeds.
2. Na página Data Feeds Manager, selecione a guia Data Integrations no topo da página.
3. Selecione Braze na lista de parceiros de dados disponíveis.
4. Na página de exportação da Braze, forneça a chave de importação de dados e o endpoint REST que você encontrou no dashboard da Braze e selecione Enable.

Etapa 4: Confirmar a integração

Na página de parceiros de tecnologia do Branch na Braze, o indicador de conexão mostra Not Connected até que você gere uma chave de API de importação de dados na Etapa 2. Após gerar a chave, o indicador muda para Connected e exibe um carimbo de data/hora. Esse carimbo 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 o Branch enviou um postback pela última vez.

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

Mapeamento de campos

Os campos de atribuição do Branch são mapeados para a Braze da seguinte forma:

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

Os dados de atribuição de campanhas do Facebook e 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 do Branch na Braze (opcional)

Usar links de rastreamento de cliques em suas campanhas na Braze permite que você veja facilmente quais campanhas estão gerando instalações e reengajamento do app. 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 os links de rastreamento de cliques do Branch, visite a documentação deles. Você pode inserir os links de rastreamento de cliques do Branch diretamente nas suas campanhas na Braze. O Branch 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 do Branch para melhorar a precisão das atribuições das suas campanhas na 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' %}
user_data_aaid={{most_recently_used_device.${google_ad_id}}}
{% endif %}

1
2
3

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

Nota

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