Configuração do Braze
O Braze é um parceiro de analytics integrado à Adjust. Nossa integração permite que o Braze receba dados mensurados na Adjust por meio de callbacks automáticos. Use esses dados com as ferramentas de parceiros para analytics e insights.
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
Credenciais
INSTALL API KEY, EVENT API KEY e ENDPOINT
- Para obter ajuda para encontrar suas credenciais, entre em contato com seu representante 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 fazer isso:
- Insira seus INSTALL API KEY, EVENT API KEY e ENDPOINT.
Depois que você habilitar o compartilhamento de dados com o Braze, a Adjust enviará automaticamente os seguintes dados ao Braze, por padrão:
- instalação
- evento
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 Usar as configurações específicas da plataforma.
- Definir as mesmas configurações de compartilhamento de dados para múltiplas plataformas selecionando Usar as configurações globais.
Agora, em O que será compartilhado por padrão?, revise as atividades que o Adjust compartilha com o Braze por padrão:
- instalação
- evento
Enviar dados adicionais
Escolha a quantidade e o tipo de dados que deseja compartilhar com o Braze por meio de retornos de chamada. O Braze pode usar essas informações para otimizar o desempenho.
Para enviar dados adicionais, você pode revisar e personalizar o seguinte:
Receita in-app (a partir de compras in-app)
O compartilhamento de receita in-app permite que o Braze receba valores de receita junto com seus dados de eventos com receita. Você precisa mapear eventos que geram receita para compartilhar esses dados.
Mapear parâmetros
Normalmente é necessário mapear os parâmetros para compartilhar dados personalizados com o Braze.
Os parâmetros de parceiros (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 do parceiro ao SDK da Adjust, confira se não há parâmetros pré-existentes que já atendem seus requisitos.
Para encaminhar parâmetros de parceiros ao 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 Revisão da 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 do SDK do SDK ou dos SDKs que você está usando. Abaixo temos uma lista dos parâmetros predefinidos que o Braze aceita:
Parameter key> Valor
- external_id> obrigatório para o envio de eventos ao Braze
- braze_device_id> obrigatório para o envio de dados do Android ao Braze
- product_id> obrigatório para o envio de eventos com receita ao Braze Para enviar callbacks de eventos ao Braze, você deve implementar "external_id" como um parâmetro do parceiro de eventos no SDK da Adjust. Para o envio de eventos de receita, você deve configurar product_id como um parâmetro do parceiro para eventos.
Nos aplicativos Android, você também deve implementar "braze_device_id" como parâmetro do parceiro de sessão e de eventos. Para o encaminhamento de eventos com receita, você deve configurar "product_id" como um parâmetro do 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 esses trackers.
Callbacks
No momento, a Adjust não envia dados de campanha 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 a Braze
O Braze solicita que a Adjust envie os seguintes parâmetros (pontos de dados) com seus callbacks:
Placeholder | Informação |
{currency} | O 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 solicitação S2S e transmitidos a fornecedores de terceira parte 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, conforme retirado do tracker |
{app_id} | Store App ID ou Google Play Store |
{campaign_name} | Nome da campanha, conforme retirado do tracker |
{created_at} | Marca temporal da atividade |
{creative_name} | Nome criativo, conforme retirado do tracker |
{network_name} | Nome da rede, conforme retirado do tracker |