Skip to content

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 entre a Braze e a Branch ajuda a entender exatamente quando e onde aconteceu a aquisição de um usuário e a personalizar a jornada de cada um por meio de atribuição robusta e deep linking.

Pré-requisitos

Integração

Etapa 1: Mapear IDs de dispositivos

Android

Se você tiver um app para Android, precisará passar um ID de dispositivo exclusivo da Braze para a Branch. Esse ID pode ser definido no método setRequestMetadataKey() do SDK da 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 da solicitação no SDK da Branch.

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

iOS

Para quem usa o Swift SDK v5.7.0+, se você deseja continuar usando o IDFV como 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 Branch na instalação do app para que a Braze possa corresponder adequadamente as atribuições do iOS.

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: Obtenha a chave de importação de dados da Braze

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

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

Esta imagem mostra a caixa "Importação de dados para atribuição de instalação" encontrada na página de tecnologia da Branch. Essa caixa contém a chave de importação de dados e o endpoint REST.

Etapa 3: Configurar Data Feeds

  1. Na Branch, na seção Exports, selecione Data Feeds.
  2. Na página Data Feeds Manager, selecione a guia Data Integrations na parte superior 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

Depois que a Braze receber dados de atribuição da Branch, o indicador de status da conexão na página de parceiros de tecnologia da Branch na Braze mudará de “Not Connected” para “Connected” e incluirá um registro de data e hora da última solicitação bem-sucedida.

Esse status é alterado somente depois que a Braze recebe dados sobre uma atribuição de instalação. A Braze ignora as instalações orgânicas (as exclui do postback da Branch) e não as conta ao determinar se a conexão foi bem-sucedida.

Dados de atribuição do Facebook e do X (antigo 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 da Branch na Braze (opcional)

Usar links de rastreamento de cliques nas suas campanhas da Braze permitirá que você veja facilmente quais campanhas estão gerando instalações de apps e reengajamento. Como resultado, você poderá 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 ROI.

Para começar a usar os links de rastreamento de cliques da Branch, consulte a documentação da Branch. Você pode inserir os links de rastreamento de cliques da Branch diretamente nas suas campanhas da Braze. A Branch 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 da Branch com um identificador de dispositivo 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.

Para Android, a Braze permite que os clientes façam a aceitação da coleta do Google Advertising ID (GAID). O GAID também é coletado nativamente pela integração do SDK da Branch. Você pode incluir o GAID nos seus links de rastreamento de cliques da Branch utilizando a seguinte lógica Liquid:

1
2
3
{% if most_recently_used_device.${platform} == 'android' %}
user_data_aaid={{most_recently_used_device.${google_ad_id}}}
{% endif %}

Para iOS, tanto a Braze quanto a Branch coletam automaticamente o IDFV de forma nativa por meio das nossas integrações de SDK. Isso pode ser usado como o identificador do dispositivo. Você pode incluir o IDFV nos seus links de rastreamento de cliques da Branch utilizando a seguinte lógica Liquid:

1
2
3
{% if most_recently_used_device.${platform} == 'ios' %}
user_data_idfv={{most_recently_used_device.${id}}}
{% endif %}
New Stuff!