mParticle por Rokt
A CDP da mParticle ajuda você a fazer mais com os seus dados. Os melhores profissionais de marketing usam a mParticle para orquestrar dados em todo o growth stack, para vencer nos momentos mais importantes da jornada do cliente.
A integração entre a Braze e a mParticle permite que você controle com praticidade o fluxo de informações entre os dois sistemas:
- Sincronize os públicos da mParticle com a Braze para segmentação de Campaign e Canvas na Braze.
- Compartilhe dados entre as duas plataformas. Isso pode ser feito por meio da integração do kit mParticle e da integração de servidor a servidor.
- Envie a interação do usuário da Braze para a mParticle por meio do Currents, tornando-a acionável em todo o growth stack.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta mParticle | É necessário ter uma conta mParticle para usar essa parceria. |
| Instância da Braze | Sua instância da Braze pode ser encontrada na página de visão geral da API (por exemplo, US-01 ou US-02). |
| Chave de identificação do app da Braze | Sua chave de identificação do app. Ela pode ser encontrada em Manage Settings > API Key no dashboard da Braze. |
| Chave da API REST do espaço de trabalho | (Servidor para servidor) Uma chave da API REST da Braze Ela pode ser criada em Developer Console > API Settings > API Key no dashboard da Braze. |
Integração
Públicos
Use a parceria entre a Braze e a mParticle para configurar sua integração e importar públicos da mParticle diretamente na Braze para redirecionamento, criando um ciclo completo de dados de um sistema para outro.
Qualquer integração que você configurar registrará pontos de dados. Se você tiver dúvidas sobre as particularidades dos pontos de dados da Braze, seu gerente de conta da Braze poderá esclarecê-las.
Encaminhamento de públicos
A mParticle oferece três maneiras de definir atributos de associação a coortes, controladas pela configuração “Enviar Segments como”. Consulte as seções a seguir para o processamento de cada opção:
- Atributo de string único
- Atributo de array único
- Um atributo por Segment
- Atributo de array único e atributo de string único
- Atributo de array único e um atributo por Segment
- Atributo de string único e um atributo por Segment
- Atributo de array único, atributo de string único e um atributo por Segment
Atributo de string único
A mParticle criará um único atributo personalizado chamado SegmentMembership. O valor desse atributo é uma string de IDs de público da mParticle separados por vírgula que correspondem ao usuário. Esses IDs de público podem ser encontrados no dashboard da mParticle em Audiences.
Por exemplo, se um público da mParticle chamado “Ibiza dreamers” tiver o ID de público “11036”, você poderá segmentar esses usuários com o filtro SegmentMembership — matches regex — 11036.
Embora essa seja a opção padrão na mParticle, a maioria dos usuários opta por usar atributos de array único pela experiência de filtragem ao criar Segments na Braze.
Esta solução não é recomendada se você tiver mais do que alguns poucos públicos, pois os atributos personalizados podem ter até 255 caracteres. Isso significa que não será possível armazenar dezenas ou centenas de públicos em um perfil de usuário com esse método. Se você tiver um grande número de coortes por usuário, recomendamos fortemente a configuração “um atributo por Segment”.
Atributo de array único
A mParticle cria um único atributo personalizado de array na Braze para cada usuário, chamado SegmentMembershipArray. O valor desse atributo é um array de IDs de público da mParticle que correspondem ao usuário.
Por exemplo, se um usuário for membro de três públicos da mParticle com os IDs de público “13053”, “13052” e “13051”, você poderá segmentar os usuários que correspondem a um desses públicos com o filtro SegmentMembershipArray — includes value — 13051.
Os atributos de array da Braze têm um comprimento máximo padrão de 500. Se algum dos seus usuários for membro de mais de 500 públicos, a Braze truncará as informações de associação. Para contornar esse problema, entre em contato com seu gerente de conta da Braze para aumentar o limite máximo de comprimento do array.
Um atributo por Segment
A mParticle criará um atributo personalizado booleano para cada público ao qual um usuário pertence. Por exemplo, se um público da mParticle se chamar “Possible Parisians”, você poderá segmentar esses usuários com o filtro In Possible Parisians - equals - true.
Atributo de array único e atributo de string único
A mParticle enviará atributos conforme descrito tanto pelo atributo de array único quanto pelo atributo de string único.
Atributo de array único e um atributo por Segment
A mParticle enviará atributos conforme descrito tanto pelo atributo de array único quanto pelo um atributo por Segment.
Atributo de string único e um atributo por Segment
A mParticle enviará atributos conforme descrito tanto pelo atributo de string único quanto pelo um atributo por Segment.
Atributo de array único, atributo de string único e um atributo por Segment
A mParticle enviará atributos conforme descrito pelo atributo de array único, atributo de string único e um atributo por Segment.
Etapa 1: Criar um público na mParticle
Para criar um público na mParticle:
- Navegue até Audiences > Single Workspace > + New Audience.
- Para conectar a Braze como uma saída para o seu público, você deve fornecer os seguintes campos:
| Nome do campo | Descrição |
|---|---|
| Chave de API | No dashboard da Braze, acesse Configurações > Chaves de API. |
| Sistema operacional da chave de API | Selecione a qual sistema operacional sua chave de API da Braze corresponde. Essa seleção limitará os tipos de tokens por push encaminhados em uma atualização de público. |
| Enviar Segments como | O método de envio de públicos para a Braze. Consulte a seção Encaminhamento de públicos para mais detalhes. |
| Chave da API REST do espaço de trabalho | Chave da API REST da Braze com permissões completas. Ela pode ser criada no dashboard da Braze em Configurações > Chaves de API. |
| Tipo de identidade externa | O tipo de identidade de usuário da mParticle a ser encaminhado como ID externo para a Braze. Recomendamos manter o valor padrão, Customer ID. |
| Tipo de identidade de e-mail | O tipo de identidade de usuário da mParticle a ser encaminhado como e-mail para a Braze. |
| Instância da Braze | Especifique para qual cluster seus dados da Braze serão encaminhados. |
- Por fim, salve seu público.
Você deverá começar a ver os públicos sincronizando com a Braze em poucos minutos. A associação ao público só será atualizada para usuários com external_ids (ou seja, não para usuários anônimos). Para saber mais sobre como criar públicos da mParticle na Braze, consulte a documentação da mParticle sobre Configurações.
Etapa 2: Segmentar usuários na Braze
Na Braze, para criar um Segment desses usuários, navegue até Segments em Engagement e dê um nome ao seu Segment. A seguir, dois exemplos de Segments dependendo da opção selecionada em Enviar Segments como. Para mais detalhes sobre cada opção, consulte Encaminhamento de públicos.
- Atributo de array único: Selecione
SegmentMembershipArraycomo seu filtro. Em seguida, use a opção “includes value” e insira o ID do público desejado.
- Um atributo por Segment: Selecione seu atributo personalizado como filtro. Em seguida, use a opção “equals” e escolha a lógica apropriada.
Após salvar, você pode referenciar esse Segment durante a criação de Canvas ou Campaign na etapa de direcionamento de usuários.
Desativação e exclusão de conexões
Como a mParticle não mantém Segments diretamente na Braze, ela não excluirá Segments quando a conexão de público correspondente da mParticle for excluída ou desativada. Quando isso acontece, a mParticle não atualizará os atributos de usuário do público na Braze para remover o público de cada usuário.
Para remover o público de um usuário da Braze antes da exclusão, ajuste os filtros do público para forçar o tamanho do público a 0 antes de excluí-lo. Após o cálculo do público ser concluído e retornar 0 usuários, exclua o público. Em seguida, a associação ao público será atualizada na Braze para false na opção de atributo único ou removerá o ID do público do formato de array.
Mapeamento de dados
Os dados podem ser mapeados para a Braze usando a integração de kit incorporado se você quiser conectar seus apps móveis e web à Braze por meio da mParticle. Você também pode usar a integração de API de servidor para servidor para encaminhar dados do lado do servidor para a Braze.
Independentemente da abordagem escolhida, você deve configurar a Braze como uma saída:
Configure suas configurações de saída da Braze
Na mParticle, navegue até Setup > Outputs > Add Outputs e selecione Braze para abrir a configuração do kit da Braze. Clique em Save quando terminar.
| Nome da configuração | Descrição |
|---|---|
| Chave de identificador do app Braze | Sua chave de identificador do app Braze pode ser encontrada no dashboard da Braze em Settings > API Keys. Observe que as chaves de API serão diferentes para cada plataforma (iOS, Android e web). |
| Tipo de identidade externa | O tipo de identidade de usuário da mParticle a ser encaminhado como um ID externo para a Braze. Recomendamos manter o valor padrão, Customer ID. |
| Tipo de identidade de e-mail | O tipo de identidade de usuário da mParticle a ser encaminhado como e-mail para a Braze. Recomendamos manter o valor padrão, Email. |
| Instância da Braze | O cluster para o qual seus dados da Braze serão encaminhados; deve ser o mesmo cluster em que seu dashboard está. |
| Ativar encaminhamento de fluxo de eventos | (Servidor para servidor) Quando ativado, todos os eventos serão encaminhados em tempo real. Caso contrário, todos os eventos serão encaminhados em massa. Ao optar por ativar o encaminhamento de fluxo de eventos, verifique se os dados que você está enviando para a Braze respeitam os limites de frequência. |
Integração de kit incorporado
Os SDKs da mParticle e da Braze estarão presentes no seu aplicativo por meio da integração de kit incorporado. No entanto, ao contrário de uma integração direta com a Braze, a mParticle se encarrega de chamar a maioria dos métodos do SDK da Braze por você. Os métodos da mParticle que você usa para rastrear dados de usuários serão automaticamente mapeados para os métodos do SDK da Braze.
Esses mapeamentos do SDK da mParticle para Android, iOS e Web são de código aberto e podem ser encontrados na página do GitHub da mParticle.
A integração do SDK de kit incorporado permite que você aproveite nosso pacote completo de recursos (push, mensagens no app e todo o rastreamento de análise de mensagens relevante).
Para Content Cards e integrações personalizadas de mensagens no app, chame os métodos do SDK da Braze diretamente.
Etapa 1: Integre os SDKs da mParticle
Integre os SDKs apropriados da mParticle em seu app com base nas necessidades da sua plataforma:
Etapa 2: Complete a integração do kit de eventos Braze da mParticle
Embora o SDK da Braze não precise ser incluído diretamente no seu website ou app para esta integração com a mParticle, o seguinte kit Appboy da mParticle deve ser instalado para encaminhar dados do seu app para a Braze.
O guia de integração do kit de eventos Braze da mParticle orientará você pelas instruções personalizadas de alinhamento entre mParticle e Braze com base nas suas necessidades de envio de mensagens (push, monitoramento de localização, etc.).
Etapa 3: Configurações de conexão para sua saída Braze
Na mParticle, navegue até Connections > Connect > [Sua plataforma desejada] > Connect Output para adicionar a Braze como saída. Em seguida, selecione Save.
Nem todas as configurações de conexão se aplicam a todas as plataformas e tipos de integração. Para uma análise detalhada das configurações de conexão e das plataformas a que se aplicam, consulte a documentação da mParticle.
Integração de API de servidor
Este é um complemento para encaminhar seus dados de backend para a Braze se você estiver usando os SDKs do lado do servidor da mParticle (por exemplo, Ruby, Python, etc.). Para configurar esta integração de servidor para servidor com a Braze, siga a documentação da mParticle.
A integração de servidor para servidor não oferece suporte a recursos de UI da Braze, como mensagens no app, Content Cards ou notificações por push. Também existem dados capturados automaticamente, como campos no nível do dispositivo, que não estão disponíveis por esse método.
Considere uma integração lado a lado se quiser usar esses recursos.
Para que os dados do lado do servidor sejam encaminhados para a Braze, eles devem incluir um external_id; usuários anônimos não serão encaminhados.
Configurações de conexão para sua saída Braze
Na mParticle, navegue até Connections > Connect > [Sua plataforma desejada] > Connect Output para adicionar a Braze como saída. Clique em Save quando terminar.
Nem todas as configurações de conexão se aplicam a todas as plataformas e tipos de integração. Para uma análise detalhada das configurações de conexão e das plataformas a que se aplicam, consulte a documentação da mParticle.
Antes de ativar “Enriched User Attributes” ou “Enriched User Identities”, recomendamos revisar Excedentes de pontos de dados para garantir que você esteja ciente de como essas configurações afetarão o uso de pontos de dados.
Detalhes do mapeamento de dados
Tipos de dados
Nem todos os tipos de dados são compatíveis entre ambas as plataformas.
- As propriedades de eventos personalizados suportam objetos do tipo string, numérico, booleano ou data. Não suportam arrays ou objetos aninhados.
- Os atributos personalizados suportam objetos do tipo string, numérico, booleano, data e arrays, mas não suportam objetos ou objetos aninhados.
A Braze não aceita timestamps anteriores ao ano 0 ou posteriores ao ano 3000 em atributos personalizados do tipo Time. A Braze processará esses valores quando forem enviados pela mParticle, mas o valor será armazenado como uma string.
Mapeamento de dados
| Tipo de dado mParticle | Tipo de dado Braze | Descrição |
|---|---|---|
| Atributos de usuário (reservados) | Atributo padrão | Por exemplo, a chave de atributo de usuário reservada $FirstName da mParticle é mapeada para o campo de atributo padrão first_name da Braze. |
| Atributos de usuário (outros) | Atributo personalizado | Quaisquer atributos de usuário enviados à mParticle que estejam fora de suas chaves de atributos de usuário reservadas são registrados na Braze como atributos personalizados. Os atributos de usuário suportam string, numérico, booleano, data e arrays, mas não suportam objetos ou objetos aninhados. |
| Evento personalizado | Evento personalizado | Os eventos personalizados da mParticle são reconhecidos pela Braze como eventos personalizados. Os atributos de evento são encaminhados como propriedades de evento personalizado. Os atributos de evento enviados à Braze como propriedades de evento suportam objetos do tipo string, numérico, booleano ou data, mas não suportam arrays ou objetos aninhados. |
| Evento de comércio de compra | Evento de compra | Os eventos de comércio de compra serão mapeados para eventos de compra da Braze. Alterne o valor da configuração para agrupar dados de eventos de comércio para registrar compras no nível do pedido ou do produto. Por exemplo, se false, um único evento de entrada com dois produtos, promoções ou impressões únicos resultaria em pelo menos dois eventos de saída da Braze. Se definido como true, resultaria em um único evento de saída com um array aninhado de produtos, promoções ou impressões, respectivamente.Para saber mais sobre os campos de comércio adicionais que serão registrados, consulte a documentação da mParticle. Ao definir “bundle commerce event data” como false, os atributos de produto enviados à Braze como propriedades de evento de compra suportam objetos do tipo string, numérico, booleano ou data, mas não suportam arrays ou objetos aninhados. |
| Todos os outros eventos de comércio | Evento personalizado | Todos os outros eventos de comércio serão mapeados para eventos personalizados. Alterne o valor da configuração para agrupar dados de eventos de comércio para registrar compras no nível do pedido ou do produto. Por exemplo, se false, um único evento de entrada com dois produtos, promoções ou impressões únicos resultaria em pelo menos dois eventos de saída da Braze. Se definido como true, resultaria em um único evento de saída com um array aninhado de produtos, promoções ou impressões, respectivamente.Além de certos valores de comércio padrão, os atributos de produto serão registrados como propriedades de evento da Braze. Para saber mais sobre os campos de comércio adicionais que serão registrados, consulte a documentação da mParticle Ao definir “bundle commerce event data” como false, os atributos de produto enviados à Braze como propriedades de evento suportam objetos do tipo string, numérico, booleano ou data, mas não suportam arrays ou objetos aninhados. |
Mapeamento de identidade de usuário
Para cada saída da mParticle, você pode selecionar o tipo de identidade externa a ser enviado para a Braze como external_id. Embora o valor padrão seja customer ID, você pode optar por mapear outro ID, como MPID, para enviar à Braze como external_id. Esteja ciente de que escolher um identificador diferente do customer ID pode influenciar como os dados são enviados na Braze.
Por exemplo, mapear o MPID para o external_id da Braze terá os seguintes efeitos:
- Devido à natureza de quando o MPID é atribuído, todos os usuários receberão um
external_idno início da sessão. - A configuração do Currents pode exigir mapeamento adicional devido aos diferentes tipos de dados entre MPID e
external_id.
Encaminhamento de solicitações de exclusão (solicitações de titulares de dados)
Encaminhe solicitações de exclusão para a Braze configurando uma saída de solicitação de titular de dados para a Braze. Para encaminhar solicitações de exclusão para a Braze, siga a documentação da mParticle.
Potenciais excedentes de pontos de dados
Atributos de usuário enriquecidos
Ativando o enriquecimento de atributos/identidades de usuário (somente servidor para servidor)
Nas configurações de conexão da mParticle, a Braze recomenda desativar Include Enriched User Attributes. Se ativado, a mParticle encaminhará todos os atributos de usuário disponíveis (como atributos padrão, atributos personalizados e atributos calculados) do perfil existente para a Braze em cada evento registrado. Isso resulta em alto consumo de pontos de dados, pois a mParticle envia à Braze os mesmos atributos inalterados em cada chamada.
Por exemplo, se um usuário adicionar nome, sobrenome e número de telefone durante a primeira sessão e, posteriormente, se inscrever em uma newsletter adicionando as mesmas informações e um e-mail, disparando um evento de inscrição na newsletter:
- Se ativado (padrão), cinco pontos de dados serão consumidos. (evento de inscrição, endereço de e-mail, nome, sobrenome e número de telefone)
- Se desativado, dois pontos de dados serão consumidos (evento de inscrição e endereço de e-mail)
Desativar essa configuração não verificará se os dados foram alterados. No entanto, impedirá que a integração envie todos os atributos de usuário no perfil do usuário que não foram recebidos no lote original de entrada ou definidos explicitamente como um atributo para o evento. Ainda assim, é importante verificar se apenas os deltas estão sendo enviados para a Braze.
Considerações ao desativar os atributos de usuário enriquecidos
Existem algumas considerações ao desativar Include Enriched User Attributes:
- A integração servidor para servidor usa a API de eventos da mParticle para enviar eventos à Braze. Cada solicitação é disparada por um evento. Quando um atributo de usuário é alterado, como a atualização de um endereço de e-mail, mas não está associado a um evento específico (por exemplo, um evento personalizado de atualização de perfil), o novo valor só é passado para uma saída como a Braze como um “atributo enriquecido” na carga útil do próximo evento disparado pelo usuário. Quando Include Enriched User Attributes está desativado, esse novo valor de atributo não associado a um evento específico não será passado para a Braze.
- Para resolver isso, recomendamos criar um evento separado de “atualização de atributo de usuário” que envie apenas o(s) atributo(s) de usuário específico(s) que foram atualizados para a Braze. Com essa abordagem, você ainda estará registrando um ponto de dados adicional para o evento de “atualização de atributo de usuário”, mas o uso de pontos de dados será muito menor do que enviar todos os atributos de usuário em cada chamada com o recurso ativado.
- Os atributos calculados são passados para a Braze como um atributo de usuário enriquecido. Portanto, quando “Enriched User Attributes” está desativado, eles não serão mais passados para a Braze. Para encaminhar atributos calculados à Braze quando “Enriched User Attributes” estiver desativado, um feed de atributos calculados pode ajudar sem enviar todos os atributos. O feed disparará uma atualização para a Braze quando um atributo calculado for alterado.
Solução de problemas
Solução de problemas de notificações por push no iOS com o kit de eventos da Braze
Se as notificações por push não estiverem funcionando ao usar o kit de eventos da Braze (integração de kit incorporado) no iOS, verifique o seguinte:
- Encaminhamento do token por push: confirme que a mParticle está encaminhando tokens por push para a Braze. No dashboard da mParticle, verifique se a conexão do kit da Braze está com push ativado e se a credencial correta de push da Apple está configurada no dashboard da Braze.
- Ordem de inicialização do kit: O kit da Braze precisa ser inicializado antes que seu app solicite permissões de push. Se as permissões de push forem solicitadas antes que o kit esteja ativo, o token por push pode não ser encaminhado para a Braze. Verifique se o SDK da mParticle é iniciado no começo do ciclo de vida do app.
- Method swizzling: O kit da mParticle para Apple usa method swizzling para encaminhar automaticamente tokens por push e lidar com eventos de notificação por push. Se você desativou o swizzling ou outro SDK está interferindo, os tokens por push podem não chegar à Braze. Verifique se o swizzling está ativado na configuração da mParticle.
- Gerenciamento manual de tokens: Se você gerencia tokens por push manualmente (por exemplo, implementando
application:didRegisterForRemoteNotificationsWithDeviceToken:), certifique-se de que está passando o token para a mParticle atribuindo-o à propriedade de token de notificação por push, por exemplo:MParticle.sharedInstance().pushNotificationToken = deviceToken. O kit então o encaminhará para a Braze. - Incompatibilidade de ambiente: confirme se o ambiente da credencial APNs (desenvolvimento vs. produção) corresponde à build do seu app. Para saber mais, consulte Solução de problemas de push no iOS.
- Tempo de inicialização do kit: Se você acessa a instância da Braze a partir de
didFinishLaunchingWithOptions, o kit da mParticle pode não estar pronto quando um push chega. Inicialize o gerenciamento de push emuserNotificationCenter(_:didReceive:withCompletionHandler:)(ou no delegate equivalente de resposta de notificação) para que o kit da Braze esteja ativo quando o usuário abrir uma notificação.
Envio de dados desnecessários ou duplicados para a Braze
A Braze contabiliza um ponto de dados cada vez que um atributo é passado para a Braze, mesmo que o valor não tenha sido alterado. Por esse motivo, a Braze recomenda encaminhar apenas os dados necessários para ações dentro da Braze e garantir que apenas deltas de atributos sejam passados.
Eventos não estão aparecendo na Braze
Se eventos ou atributos da mParticle não estão aparecendo na Braze, o problema geralmente é uma configuração incorreta na sua conexão ou mapeamento de eventos da mParticle, e não uma indisponibilidade da Braze. Verifique o seguinte:
- Saída da conexão: confirme se a Braze está ativada como saída para a conexão relevante e se a instância correta da Braze, o identificador do app e a chave da API REST estão configurados.
- Mapeamento de identidade: sincronizações servidor-a-servidor e de público exigem um
external_id. Usuários anônimos não são encaminhados. - Mapeamento de eventos: verifique se os eventos estão sendo roteados para a saída da Braze e se tipos de dados não suportados (objetos aninhados, arrays em propriedades de eventos) não estão sendo descartados.
Se a configuração parecer correta, mas os dados ainda não chegarem, entre em contato com o suporte da mParticle para revisar os logs de entrega do lado deles.