Adjust
A Adjust é uma empresa de atribuição e análise de dados móveis que combina a atribuição de fontes de publicidade com análises avançadas para obter um quadro abrangente de business intelligence.
Essa integração é mantida pela Adjust.
Sobre a integração
A integração entre a Braze e a Adjust permite importar dados de atribuição de instalações não orgânicas para segmentar de forma mais inteligente dentro das suas campanhas de ciclo de vida.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta Adjust | Uma conta Adjust é necessária para aproveitar essa parceria. |
| App iOS ou Android | Essa integração é compatível com apps iOS e Android. Dependendo da sua plataforma, podem ser necessários snippets de código no seu aplicativo. Detalhes sobre esses requisitos podem ser encontrados na etapa 1 do processo de integração. |
| SDK da Adjust | Além do SDK da Braze, é necessário instalar o SDK da Adjust. |
Integração
Etapa 1: Mapear IDs de dispositivo
Android
Se você tem um app Android, deve passar um ID de dispositivo exclusivo da Braze para a Adjust. Esse ID pode ser definido no método addGlobalPartnerParameter() do SDK da Adjust. O snippet de código a seguir deve ser incluído antes de inicializar o SDK em Adjust.initSdk.
Adjust.addGlobalPartnerParameter("braze_device_id", Braze.getInstance(getApplicationContext()).getDeviceId());
iOS
Se você tem um app iOS, seu IDFV será coletado pela Adjust e enviado à Braze. Esse ID será então mapeado para um ID de dispositivo exclusivo na Braze.
A Braze ainda armazenará os valores de IDFA para os usuários que aceitaram, caso você esteja coletando o IDFA com a Braze, conforme descrito em nosso Guia de upgrade para iOS. Caso contrário, o IDFV será usado como identificador de fallback para mapear os usuários.
Se você tem um app iOS, pode optar por coletar o IDFV definindo o campo useUUIDAsDeviceId como false. Se não for definido, a atribuição do iOS provavelmente não será mapeada com precisão da Adjust para a Braze. Para saber mais, consulte Coletando IDFV.
Se você planeja enviar eventos pós-instalação da Adjust para a Braze, precisará:
1) Garantir que você adicione external_id como parâmetro de sessão e evento no SDK da Adjust. Para encaminhamento de eventos de receita, você também precisará configurar product_id como parâmetro para eventos. Visite a documentação da Adjust para saber mais sobre como definir parâmetros de parceiros para encaminhamento de eventos.
2) Gerar uma nova chave de API para inserir na Adjust. Isso pode ser feito selecionando o botão Generate API Key na página de parceiro da Adjust no dashboard da Braze.
Etapa 2: Obter a chave de importação de dados da Braze
Na Braze, navegue até Integrações de Parceiros > Parceiros de Tecnologia e selecione Adjust.
Aqui, você encontra o endpoint REST e gera sua chave de importação de dados da Braze. Após a chave ser gerada, você pode criar uma nova chave 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 Adjust.
Etapa 3: Configurar a Braze na Adjust
- No dashboard da Adjust, navegue até App Settings e depois até Partner Setup e selecione Add Partners.
- Selecione Braze (formerly Appboy) e forneça a chave de importação de dados e o endpoint REST da Braze.
- Selecione Save & Close.
Etapa 4: Confirmar a integração
Na página de parceiros de tecnologia da Adjust 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 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 Adjust enviou um postback pela última vez.
Para confirmar que os dados de atribuição de instalação estão fluindo da Adjust, 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 Adjust e não as armazena como dados de instalação atribuída.
Campos de dados disponíveis
Supondo que você configure sua integração conforme sugerido, a Braze mapeia os dados do Adjust para filtros de segmento, conforme descrito na tabela a seguir.
| Campo de dados do Adjust | Filtro de Segment da Braze |
|---|---|
{network_name} |
Install Attribution Source |
{campaign_name} |
Install Attribution Campaign |
{adgroup_name} |
Install Attribution Adgroup |
{creative_name} |
Install Attribution Ad |
Dados de atribuição do Facebook e X (antigo Twitter)
Os dados de atribuição de Campaigns 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 da Adjust na Braze (opcional)
Usar links de rastreamento de cliques nas suas Campaigns da Braze permite que você veja facilmente quais campaigns 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 os links de rastreamento de cliques da Adjust, acesse a documentação deles. Você pode inserir os links de rastreamento de cliques da Adjust diretamente nas suas Campaigns da Braze. A Adjust então 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 Adjust para melhorar a precisão das atribuições das suas Campaigns da Braze. Isso atribuirá de forma determinística o usuário que clicou no link.
Para Android, a Braze permite que os clientes optem pela coleta do Google Advertising ID (GAID). O GAID também é coletado nativamente pela integração SDK da Adjust. Você pode incluir o GAID nos seus links de rastreamento de cliques da Adjust utilizando a seguinte lógica Liquid:
{% if most_recently_used_device.${platform} == 'android' %}
aifa={{most_recently_used_device.${google_ad_id}}}
{% endif %}
Para iOS, adicione o identificador de dispositivo da Braze para melhorar a atribuição determinística. Em Liquid, most_recently_used_device.${id} é o ID do dispositivo da Braze, que pode ser o IDFV ou um UUID dependendo da configuração useUUIDAsDeviceId do seu Swift SDK. As URLs de rastreamento de cliques da Adjust geralmente usam um parâmetro de consulta idfv para esse valor:
{% if most_recently_used_device.${platform} == 'ios' %}
idfv={{most_recently_used_device.${id}}}
{% endif %}
Esta recomendação é totalmente opcional
Se você atualmente não usa nenhum identificador de dispositivo — como o ID do dispositivo da Braze ou o GAID — nos seus links de rastreamento de cliques, ou não planeja usar no futuro, a Adjust ainda pode atribuir esses cliques por meio de sua modelagem probabilística.