Configuração do parceiro Braze
O Braze é uma rede de análise e de anúncios integrada à Adjust. Nossa integração permite que o Braze receba dados de atribuição e eventos in-app por meio de callbacks automáticos.
Neste artigo, saiba como configurar a mensuração com o Braze para seu aplicativo. Isso inclui a ativação da integração e a escolha dos dados que a Adjust pode compartilhar com o Braze.
Antes de começar
Requisitos
- Permissões de Administrador, Editor ou Editor personalizado na Adjust.
- SDK versão 4.0.0 da Adjust e posteriormente para mapear os parâmetros do SDK aos parâmetros de Braze. Siga os guias abaixo para usar essa funcionalidade.
iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade / Xamarin | Cocos2d-x | Titanium | Corona
No painel do Braze
Antes de ativar a integração da Adjust com o Braze, você precisa completar os seguintes passos:
1. Mapear os IDs dos dispositivos
Android
Se tiver um aplicativo Android, você precisa enviar um ID do dispositivo do Braze único ao Android. Use o método addSessionPartnerParameter()
no SDK da Adjust para configurar esse valor. Você precisa incluir esse trecho de código antes de iniciar o SDK Android do Braze no Adjust.onCreate()
.
Adjust.addSessionPartnerParameter("braze_device_id", Braze.getInstance(getApplicationContext()).getDeviceId()););
iOS
Objective-C
A Adjust coleta o IDFV para o seu aplicativo iOS e o envia ao Braze. Depois, o Braze mapeia esse ID a um ID do dispositivo único.
O Braze armazena os valores do IDFA de usuários com opt-in se você estiver coletando o IDFA com o Braze. Caso contrário, o IDFV é usado como um identificador fallback para mapear usuários.
Swift
Se tiver um aplicativo iOS, você pode optar por coletar o IDFV definindo o campo useUUIDAsDeviceId
no SDK Braze Swift como false
. Se não estiver configurada, a atribuição no iOS não vai fazer um mapeamento adequado da atribuição ao Braze. Para mais informações, consulte a coleta de IDFV na documentação do Braze.
2. Gerar a chave de importação de dados do Braze
- No Braze, vá até Technology Partners (Parceiros de Tecnologia) e selecione Adjust.
- Lá, você vai encontrar o endpoint REST e gerar sua chave de importação de dados do Braze.
Uma vez gerada, você pode criar uma nova chave ou invalidar uma já existente. Use a chave de importação de dados e o endpoint REST para configurar a integraçāo da Adjust com o Braze. Para mais informações, consulte a documentação do Braze.
Selecione Braze e o seu aplicativo no Campaign Lab
- Em Campaign Lab, selecione Parceiros.
- Selecione Novo parceiro > Braze. Selecione Próximo para ir para a próxima tela.
- Na tela Seleção de aplicativos, escolha o aplicativo para o qual deseja criar o link e habilite a integração para compartilhar dados com o Braze.
- Selecione Próximo.
Habilitar o compartilhamento de dados
Habilite o compartilhamento de dados para ativar a integração com o Braze. Para habilitá-lo:
- Insira sua chave de importação de dados e seu endpoint.
Depois que você ativar o compartilhamento de dados com o Braze, a Adjust enviará automaticamente os seguintes dados ao Braze, por padrão:
- Instalações
Observação: assim que o Braze receber os dados da Adjust sobre uma instalação atribuída, o indicador do status da conexão do Braze na página dos parceiros de tecnologia da Adjust muda de "Não conectado" para "Conectado". Você também encontrará ali uma marca temporal da última requisição bem sucedida.
Configurar suas opções de compartilhamento de dados
Se estiver trabalhando com um aplicativo multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Separar opções de compartilhamento de dados no nível de plataforma selecionando Use configurações específicas da plataforma .
- Defina as mesmas configurações de compartilhamento dos dados para múltiplas plataformas selecionando Use configurações globais .
Agora, em O que será compartilhado por padrão?, revise as atividades que a Adjust compartilha com o Braze por padrão.
- Instalações
Envio de dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o Braze por meio de callbacks. O Braze pode usar essas informações para otimizar o desempenho.
Receita in-app (de compras in-app)
O compartilhamento de receita in-app permite que Braze receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar os dados.
Mapear eventos
Mapeie os eventos que você deseja compartilhar com os valores que o Braze pode receber. Os dados de eventos não mapeados não são compartilhados com o Braze.
Mapear eventos individuais
Se você tiver um aplicativo multiplataforma, poderá optar por compartilhar eventos diferentes por plataforma com o Braze. Isso possibilita:
- Definir eventos individuais para gerenciar estratégias de campanha para cada plataforma.
- Personalizar o compartilhamento de dados por plataforma.
Em Mapear eventos, siga estes passos para escolher os eventos in-app que você quer enviar diretamente ao Braze.
Selecione Mapear evento.
Na lista Evento da Adjust, escolha o evento da Adjust que você deseja compartilhar com o Braze.
Em Evento do parceiro, selecione o evento do Braze que corresponde ao evento da Adjust.
Para aplicativos de plataforma única e aplicativos multiplataforma com compartilhamento de dados habilitado apenas para uma única plataforma, mapeie eventos apenas para essa plataforma. Para aplicativos multiplataforma com compartilhamento de dados habilitado para várias plataformas, você pode:
- Selecionar Usar mapeamento específico da plataforma para mapear eventos separados no nível da plataforma ou para não mapear eventos para determinadas plataformas.
- Selecionar Usar mapeamento global para mapear os mesmos eventos para todas as plataformas.
Na lista de Eventos do parceiro, escolha ou insira um nome de evento personalizado que você deseja mapear ao evento da Adjust.
Selecione Aplicar.
Agora o Braze receberá dados de eventos in-app para todos os seus eventos vinculados.
Mapear todos os eventos
Se o Braze oferecer suporte para o mapeamento automático de todos os eventos, em Mapear eventos, selecione Mapear todos os eventos. Isso economiza tempo no mapeamento de eventos individuais.
Agora o Braze receberá dados de eventos in-app de todos os seus eventos vinculados.
Mapear parâmetros
Normalmente, é necessário mapear os parâmetros para compartilhar dados personalizados com o Braze.
Os parâmetros do parceiro (disponíveis no SDK da Adjust, versão 4.0+) permitem à Adjust coletar pontos de dados personalizados do seu aplicativo e enviá-los ao Braze. Isso permite que o Braze receba detalhes de eventos personalizados para cada um de seus eventos vinculados.
Antes de adicionar novos parâmetros de parceiros ao SDK da Adjust, confira se não há parâmetros de parceiros que já atendem seus requisitos.
Para compartilhar parâmetros do parceiro com o Braze, siga estes passos.
Configure os parâmetros do parceiro no SDK da Adjust.
- Confira Antes de começar para ver todos os links de plataformas de desenvolvimento de SDK.
Em Configure suas opções de compartilhamento de dados, selecione Parâmetros.
Em Mapear parâmetros, você pode especificar como deseja enviar à rede os parâmetros do parceiro definidos no SDK:
- Selecione Mapear parâmetro.
- No campo Parâmetro do SDK, insira o nome do parâmetro de SDK que você deseja compartilhar com a rede.
- No campo Parâmetro do parceiro, insira o parâmetro de rede que corresponde ao parâmetro do SDK.
Se você configurar os parâmetros do parceiro no SDK da Adjust sem configurar o compartilhamento de parâmetros no painel, a Adjust encaminhará os parâmetros conforme nomeados no SDK da Adjust.
Habilitar o Braze para seu aplicativo
Na tela de Revisão de configuração, revise suas escolhas. Você também pode retornar e fazer alterações em:
- Seu app selecionado
- Opções de compartilhamento de dados
Selecione Habilitar parceiro para habilitar o Braze para seu aplicativo. Os parceiros de análise não trabalham com links para campanhas. Uma vez ativada, nossa integração envia dados de atribuição e de eventos no aplicativo por meio de callbacks automatizados.
Instruções de configuração de parceiros específicos
Observação: o protocolo do endpoint não deve ser inserido, então não inclua https://
no campo de ativação. Por último, observe que o Braze exige parâmetros específicos para receber dados de callback.
Parâmetros predefinidos
O Braze permite enviar uma série de parâmetros predefinidos. Se você anexar qualquer um desses parâmetros a um evento no seu SDK da Adjust, eles serão encaminhados ao Braze. Encontre mais informações sobre como anexar parâmetros dos parceiros no readme específico do SDK para o SDK ou SDKs que você está usando. Abaixo temos uma lista dos parâmetros predefinidos que o Braze aceita:
Chave de parâmetro > Valor
external_id
> obrigatório para enviar eventos ao Braze.braze_device_id
> obrigatório para enviar dados do Android ao Braze.product_id
> obrigatório para enviar eventos com receita ao Braze. Para enviar callbacks de eventos ao Braze, você precisa implementarexternal_id
como um parâmetro do parceiro de eventos no SDK da Adjust. Para o encaminhamento de eventos com receita, você deve definir também oproduct_id
como parâmetro de parceiro para eventos.
Para apps Android, você deve implementar também o braze_device_id
como ambos parâmetro de parceiro de sessão e evento. Finalmente, para o encaminhamento de eventos com receita, você deve definir o product_id
como um parâmetro de parceiro para eventos com receita. O Braze não é compatível com dados orgânicos, do Facebook ou do Twitter, por isso, não serão enviados callbacks para essas campanhas.
Callbacks
No momento, a Adjust não envia dados de campanhas orgânicos, do Facebook e do Twitter ao Braze.
Para saber mais como usar essa integração nos seus casos de uso, confira nossa página com o Braze. Em caso de dúvidas sobre as informações fornecidas nessa página, escreva para partners@adjust.com .
Lista de todos os parâmetros encaminhados ao Braze
O Braze solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
Placeholder | Informação |
{currency} | Código da moeda ISO 4217 original enviado pelo SDK da Adjust |
{idfa} | ID para anunciantes (apenas iOS) |
{partner_parameters} | Parâmetros dos parceiros personalizados coletados pelo SDK da Adjust ou requisição S2S e transmitidos a fornecedores terceiros via postbacks |
{revenue} | Receita, conforme enviada pelo SDK da Adjust (em centavos) |
{win_adid} | Identificador de publicidade do Windows |
{adgroup_name} | Nome do grupo de anúncios (Adgroup) |
{app_id} | ID da Store App ou Google Play Store |
{campaign_name} | Nome da campanha |
{created_at} | Marca temporal da atividade |
{creative_name} | Nome do criativo |
{network_name} | Nome de rede |