Skip to content

Airbridge

A Airbridge é uma plataforma unificada de medição móvel para descobrir fontes de crescimento por meio de atribuição móvel, medição incremental e modelagem de marketing mix.

Essa integração é mantida pela Airbridge.

Sobre a integração

A integração do Braze e Airbridge permite que você passe todos os dados de atribuição da instalação não orgânica do Airbridge para o Braze para criar campanhas de marketing personalizadas.

Pré-requisitos

Integração

Etapa 1: mapeie o ID do dispositivo

A integração de servidor para servidor pode ser habilitada incluindo os seguintes trechos de código em seus aplicativos.

Android

Se você tiver um app para Android, precisará passar um ID de dispositivo da Braze exclusivo para a Airbridge.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// MainApplciation.java
@Override
public void onCreate() {
    super.onCreate();
    // Initialize Airbridge SDK
    AirbridgeConfig config = new AirbridgeConfig.Builder("APP_NAME", "APP_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .setAutoStartTrackingEnabled(false)
        .build();
    Airbridge.init(this, config);
    
    // Set device alias into Airbridge SDK
    Airbridge.getCurrentUser().setAlias("braze_device_id", Braze.getInstance(this).getDeviceId());
    // Explicitly start tracking
    Airbridge.startTracking();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// MainApplication.kt
override fun onCreate() {
    super.onCreate()
    // Initialize Airbridge SDK
    val config = AirbridgeConfig.Builder("YOUR_APP_NAME", "YOUR_APP_SDK_TOKEN")
        // Make Airbridge SDK explicitly start tracking
        .setAutoStartTrackingEnabled(false)
        .build()
    Airbridge.init(this, config)

    // Set device alias into Airbridge SDK
    Airbridge.getCurrentUser().setAlias("braze_device_id", Braze.getInstance(this).deviceId)
    // Explicitly start tracking
    Airbridge.startTracking()
}

iOS

Se você tiver um app para iOS, será possível coletar o IDFV definindo o campo useUUIDAsDeviceId como falso. Se não for definido, a atribuição do iOS provavelmente não será mapeada com precisão da Airbridge para a Braze. Para saber mais, consulte “Coleta de IFDV”.

1
2
3
4
5
6
7
8
9
10
11
// AppDelegate.swift
func application(
  _ application: UIApplication,
  didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]?
) {
    AirBridge.setAutoStartTrackingEnabled(false)
    AirBridge.getInstance("YOUR_APP_TOKEN", appName:"YOUR_APP_NAME", withLaunchOptions:launchOptions)

    AirBridge.state()?.addUserAlias(withKey:"braze_device_id", value:Appboy.sharedInstance()?.getDeviceId())
    AirBridge.startTracking()
}
1
2
3
4
5
6
7
8
9
10
// AppDelegate.m
-           (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
  AirBridge.autoStartTrackingEnabled = NO;
  [AirBridge getInstance:@"YOUR_APP_TOKEN" appName:@"YOUR_APP_NAME" withLaunchOptions:launchOptions];

    [AirBridge.state addUserAliasWithKey:@"braze_device_id" value:Appboy.sharedInstance.getDeviceId];
    [AirBridge startTracking];
}

React Native

1
2
3
4
Braze.getInstallTrackingId(function (error, brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
    Airbirdge.state.startTracking()
})

Cordova

1
2
3
4
AppboyPlugin.getDeviceId(function (brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
  Airbridge.state.startTracking()
})

Flutter

1
2
3
4
BrazePlugin.getInstallTrackingId().then((brazeID) {
    Airbridge.state.setDeviceAlias("braze_device_id", brazeID)
  Airbridge.state.startTracking()
})

Unity

1
2
3
string BrazeID = AppboyBinding.GetInstallTrackingId();
AirbridgeUnity.SetDeviceAlias("braze_device_id", BrazeID);
AirbridgeUnity.StartTracking()

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

No Braze, navegue para Integrações de Parceiros > Parceiros de Tecnologia e selecione Airbridge.

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 do Airbridge.

Etapa 3: Configure Braze no dashboard do Airbridge

  1. Na Airbridge, navegue até Integrations > Third-party Integrations (Integrações > Integrações de terceiros) na barra lateral esquerda e selecione Braze.
  2. Forneça a chave de importação de dados e o ponto de extremidade REST que você encontrou no dashboard do Braze.
  3. Selecione o tipo de evento (Install Event ou Install & Deeplink Open Event) e salve.

Para obter instruções mais detalhadas, visite Airbridge.

Etapa 4: Confirmar a integração

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

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

Campos de dados disponíveis

Airbridge pode enviar quatro tipos de dados de atribuição para a Braze listados no seguinte gráfico de campo de dados. Esses dados podem ser visualizados no dashboard do Airbridge e são usados para atribuição da instalação e filtragem de usuários.

Supondo que você configure sua integração conforme sugerido, a Braze mapeará os dados de instalação para filtros de segmento.

Campo de dados do Airbridge Filtro de segmento Braze Descrição
Channel Instalação por origem O canal ao qual as instalações ou aberturas de deeplink são atribuídas
Campaign Instalação por campanha A campanha em que as instalações ou aberturas de deeplink são atribuídas
Ad Group Instalação por grupo de anúncio O grupo de anúncios ao qual as instalações ou aberturas de deeplink são atribuídas
Ad Creative Instalação por anúncio O criativo do anúncio ao qual as instalações ou aberturas de deeplink são atribuídas

Sua base de usuários pode ser segmentada por dados de atribuição no dashboard da Braze usando os filtros de atribuição da instalação.

Dados de atribuição do Meta Business

Os dados de atribuição para campanhas do Meta Business não estão disponíveis através de nossos parceiros. Esta fonte de mídia não permite 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 clique da Airbridge na Braze (opcional)

O uso de links de rastreamento de cliques em suas campanhas do Braze mostra quais campanhas geram instalações de aplicativos e reengajamento. Use os resultados para medir o desempenho do marketing e decidir onde investir recursos para obter um ROI mais forte.

Para começar com os links de rastreamento de cliques do Airbridge, visite Airbridge. Depois que a configuração estiver concluída, você pode inserir diretamente os links de rastreamento de cliques do Airbridge em suas campanhas do Braze. Airbridge 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 do Airbridge com um identificador de dispositivo para melhorar a precisão das atribuições de suas campanhas do 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 ID de publicidade do Google (GAID). O GAID também é coletado nativamente pela integração SDK da Airbridge. Você pode incluir o GAID nos seus links de rastreamento de cliques da Airbridge utilizando a seguinte lógica Liquid:

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

Para iOS, tanto a Braze quanto a Airbridge coletam de modo automático o IDFV nativamente através 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 Airbridge utilizando a seguinte lógica Liquid:

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