mParticle por Rokt
A plataforma de dados do cliente 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 campanhas 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 do identificador do app Braze | A chave do identificador do seu 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 Console do desenvolvedor > Configurações de API > Chave de API 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 para a Braze para redirecionamento, criando um ciclo completo de dados de um sistema para outro.
Qualquer integração configurada registrará pontos de dados. Se você tiver alguma dúvida sobre as nuances dos pontos de dados da Braze, seu gerente de conta da Braze poderá respondê-la.
Encaminhamento de públicos
A mParticle oferece três maneiras de definir atributos de associação a coortes, controladas pela configuração “Send Segments As”. Consulte as seções a seguir para saber o processamento de cada opção:
- Atributo de string única
- Atributo de matriz única
- Um atributo por segmento
- Atributo de matriz única e atributo de string única
- Atributo de matriz única e um atributo por segmento
- Atributo de string única e um atributo por segmento
- Atributo de matriz única, atributo de string única e um atributo por segmento
Atributo de string única
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írgulas 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 “Ibiza dreamers” tiver um ID de público de “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 matriz única para a experiência de filtragem ao criar segmentos na Braze.
Essa solução não é recomendada se você tiver mais do que alguns públicos, porque os atributos personalizados podem ter até 255 caracteres, portanto, não será possível armazenar dezenas ou centenas de públicos em um perfil de usuário usando esse método. Se tiver um grande número de coortes por usuário, recomendamos fortemente a configuração “um atributo por segmento”.
Atributo de matriz única
A mParticle cria um único atributo personalizado de matriz na Braze para cada usuário, chamado SegmentMembershipArray. O valor desse atributo é uma matriz 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 matriz da Braze têm um comprimento máximo de 25. Se algum dos seus usuários for membro de mais de 25 públicos, as informações de associação serão truncadas pela Braze. Para contornar esse problema, entre em contato com o representante da Braze para aumentar o limite máximo de comprimento da matriz.
Um atributo por segmento
A mParticle criará um atributo personalizado booleano para cada público ao qual o usuário pertence. Por exemplo, se um público da mParticle for chamado de “Possible Parisians”, você poderá segmentar esses usuários com o filtro In Possible Parisians — equals — true.
Atributo de matriz única e atributo de string única
A mParticle enviará atributos conforme descrito pelo atributo de matriz única e pelo atributo de string única.
Atributo de matriz única e um atributo por segmento
A mParticle enviará atributos conforme descrito pelo atributo de matriz única e um atributo por segmento.
Atributo de string única e um atributo por segmento
A mParticle enviará atributos conforme descrito pelo atributo de string única e um atributo por segmento.
Atributo de matriz única, atributo de string única e um atributo por segmento
A mParticle enviará atributos conforme descrito pelo atributo de matriz única, atributo de string única e um atributo por segmento.
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 seu público, você deve fornecer os seguintes campos:
| Nome do campo | Descrição |
|---|---|
| Chave de API | Encontrada no dashboard da Braze em Configurações > Chaves de API. Se estiver usando a navegação mais antiga, poderá encontrar as chaves de API em Console do desenvolvedor > Configurações 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 do público. |
| Enviar segmentos como | O método de envio de públicos para a Braze. Consulte a seção Encaminhamento de públicos para obter 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 do usuário mParticle a ser encaminhado como um ID externo para a Braze. Recomendamos deixar esse valor como padrão, ID do cliente. |
| Tipo de identidade de e-mail | O tipo de identidade de usuário da mParticle a ser encaminhado como o 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 sendo sincronizados com a Braze em alguns minutos. A associação do público só será atualizada para usuários com external_ids (ou seja, usuários não anônimos). Para saber mais sobre como criar o público da Braze na mParticle, consulte a documentação da mParticle em Configurações.
Etapa 2: Segmentar usuários na Braze
Na Braze, para criar um segmento desses usuários, navegue até Segments em Engagement e nomeie seu segmento. A seguir, dois exemplos de segmentos, dependendo da opção selecionada para Enviar segmentos como. Para obter mais detalhes sobre cada opção, consulte Encaminhamento de públicos.
- Atributo de matriz única: Selecione
SegmentMembershipArraycomo seu filtro. Em seguida, use a opção “includes value” e insira o ID do público desejado.
- Um atributo por segmento: Selecione seu atributo personalizado como o filtro. Em seguida, use a opção “equals” e escolha a lógica apropriada.
Depois de salvo, você pode fazer referência a esse segmento durante a criação do Canvas ou da campanha na etapa de direcionamento de usuários.
Desativação e exclusão de conexões
Como a mParticle não mantém segmentos diretamente na Braze, ela não excluirá segmentos quando a conexão do público correspondente da mParticle for excluída ou desativada. Quando isso acontecer, a mParticle não atualizará os atributos do 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, primeiro ajuste os filtros de público para forçar o tamanho do público a 0. Depois que o cálculo do público for concluído e retornar 0 usuários, exclua o público. Em seguida, a associação do público será atualizada na Braze para false para a opção de atributo único ou removerá o ID do público do formato de matriz.
Mapeamento de dados
Os dados podem ser mapeados para a Braze usando a integração do kit incorporado se você quiser conectar seus apps móveis e da 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, configure a Braze como saída:
Configure suas definições de saída da Braze
Na mParticle, navegue até Setup > Outputs > Add Outputs e selecione Braze para abrir a configuração do kit Braze. Salve quando concluir.
| Nome da configuração | Descrição |
|---|---|
| Chave do identificador do app Braze | Sua chave de identificador do app Braze pode ser encontrada no dashboard da Braze em Configurações > Chaves de API. Observe que as chaves de API serão diferentes para cada plataforma (iOS, Android e Web). |
| Tipo de identidade externa | O tipo de identidade do usuário mParticle a ser encaminhado como um ID externo para a Braze. Recomendamos deixar esse valor como padrão, ID do cliente. |
| Tipo de identidade de e-mail | O tipo de identidade de usuário da mParticle a ser encaminhado como um e-mail para a Braze. Recomendamos deixar esse valor como padrão, E-mail. |
| Instância da Braze | O cluster para o qual seus dados da Braze serão encaminhados; esse deve ser o mesmo cluster em que seu dashboard está. |
| Ativar o 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 do fluxo de eventos, certifique-se de que os dados que você está enviando para a Braze respeitarão os limites de taxa. |
Integração de kit incorporado
Os SDKs da mParticle e da Braze estarão presentes no seu aplicativo por meio da integração do kit incorporado. No entanto, ao contrário de uma integração direta da Braze, a mParticle se encarrega de chamar a maioria dos métodos do SDK da Braze para você. Os métodos da mParticle usados 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 do kit incorporado permite que você aproveite nosso conjunto completo de recursos (push, mensagens no app e todo o rastreamento de análise de dados de mensagens relevantes).
Para Cartões de conteúdo e integrações personalizadas de mensagens no app, chame os métodos do SDK da Braze diretamente.
Etapa 1: Integrar os SDKs da mParticle
Integre os SDKs da mParticle apropriados no seu app com base nas necessidades da sua plataforma:
Etapa 2: Concluir a integração do kit de eventos Braze da mParticle
Embora o SDK da Braze não precise ser incluído diretamente no seu site ou app para essa integração da mParticle, o seguinte mParticle Appboy Kit deve ser instalado para encaminhar dados do seu app para a Braze.
O guia de integração do kit de eventos da Braze elaborado pela mParticle oferece as instruções de alinhamento personalizado da mParticle e da Braze com base nas suas necessidades de envio de mensagens (push, monitoramento de localização etc.).
Etapa 3: Configurações de conexões para sua saída da Braze
Na mParticle, navegue até Connections > Connect > [Sua plataforma desejada] > Connect Output para adicionar a Braze como uma 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 obter um detalhamento das configurações de conexão e das plataformas às quais elas se aplicam, consulte a documentação da mParticle.
Integração da API do servidor
Esse é um complemento para rotear seus dados de backend para a Braze se estiver usando os SDKs do lado do servidor da mParticle (por exemplo, Ruby, Python, etc.). Para configurar essa integração de servidor para servidor com a Braze, siga a documentação da mParticle.
A integração servidor a servidor não oferece suporte aos recursos da interface do usuário da Braze, como mensagens no app, Cartões de conteúdo ou notificações por push. Também existem dados capturados automaticamente, como campos em nível de dispositivo, que não estão disponíveis por meio desse 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ões para sua saída da Braze
Na mParticle, navegue até Connections > Connect > [Sua plataforma desejada] > Connect Output para adicionar a Braze como uma saída. Salve quando concluir.
Nem todas as configurações de conexão se aplicam a todas as plataformas e tipos de integração. Para obter um detalhamento das configurações de conexão e das plataformas às quais elas se aplicam, consulte a documentação da mParticle.
Antes de ativar “Enriched User Attributes” ou “Enriched User Identities”, recomendamos revisar os excedentes de pontos de dados para saber como essas configurações afetam 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 as duas plataformas.
- As propriedades de eventos personalizados são compatíveis com objetos dos tipos string, numérico, booleano ou data. Não oferecem suporte a matrizes ou objetos aninhados.
- Os atributos personalizados suportam objetos string, numéricos, booleanos, de data e matrizes, mas não suportam objetos ou objetos aninhados.
A Braze não oferece suporte a registros de data e hora anteriores ao ano 0 ou posteriores ao ano 3000 nos atributos personalizados do tipo Time. A Braze absorverá esses valores quando eles forem enviados pela mParticle, mas o valor será armazenado como uma string.
Mapeamento de dados
| Tipo de dados mParticle | Tipo de dados da Braze | Descrição |
|---|---|---|
| Atributos do 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 do usuário (outros) | Atributo personalizado | Quaisquer atributos de usuário passados para a mParticle que estejam fora de suas chaves de atributo de usuário reservadas são registrados na Braze como um atributo personalizado. Os atributos de usuário suportam valores dos tipos string, numérico, booleano, data e matriz, mas não suportam objetos ou objetos aninhados. |
| Evento personalizado | Evento personalizado | Os eventos personalizados da mParticle são reconhecidos pela Braze como um evento personalizado. Os atributos de eventos são encaminhados como propriedades de eventos personalizados. Os atributos de eventos passados à Braze como propriedades de eventos suportam objetos dos tipos string, numérico, booleano ou data, mas não suportam matrizes nem objetos aninhados. |
| Evento de compra comercial | Evento de compra | Os eventos de compra comercial são mapeados para eventos de compra da Braze. Alterne o valor do agrupamento de dados de eventos comerciais para registrar as 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 exclusivos resultaria em pelo menos dois eventos Braze de saída. Se definido como true, isso resultaria em um único evento de saída com uma matriz aninhada 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 do produto passados para a Braze como propriedades do evento de compra suportam objetos do tipo string, numérico, booleano ou data, mas não suportam matrizes nem objetos aninhados. |
| Todos os outros eventos comerciais | Evento personalizado | Todos os outros eventos comerciais serão mapeados para eventos personalizados. Alterne o valor do agrupamento de dados de eventos comerciais para registrar as 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 exclusivos resultaria em pelo menos dois eventos Braze de saída. Se definido como true, isso resultaria em um único evento de saída com uma matriz aninhada de produtos, promoções ou impressões, respectivamente.Além de certos valores comerciais padrão, os atributos do produto serão registrados como propriedades do evento 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 do produto passados para a Braze como propriedades do evento suportam objetos do tipo string, numérico, booleano ou data, mas não suportam matrizes nem objetos aninhados. |
Mapeamento da identidade do usuário
Para cada saída da mParticle, você pode selecionar o tipo de identidade externa a ser enviada à Braze como external_id. Embora o valor padrão seja o ID do cliente, você pode optar por mapear outro ID, como MPID, para enviar à Braze como external_id. Esteja ciente de que a escolha de um identificador diferente do ID do cliente pode influenciar a forma como os dados são enviados na Braze.
Por exemplo, o mapeamento do MPID para seu 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 do titular dos dados)
Encaminhe solicitações de exclusão à Braze configurando uma saída de solicitação do titular dos dados para a Braze. Para encaminhar solicitações de exclusão à Braze, acesse a documentação da mParticle.
Potenciais excedentes de pontos de dados
Atributos enriquecidos do usuário
Como ativar atributos e identidades enriquecidos de usuários (somente servidor para servidor)
Nas configurações de conexão da mParticle, a Braze recomenda desativar a opção Include Enriched User Attributes. Se ativada, 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 um alto consumo de pontos de dados porque a mParticle envia à Braze os mesmos atributos inalterados em cada chamada.
Por exemplo, se um usuário adicionar seu nome, sobrenome e número de telefone durante a primeira sessão e, posteriormente, se inscrever para receber um boletim informativo e adicionar as mesmas informações e um e-mail, disparando um evento de inscrição no boletim informativo:
- 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)
A desativação dessa configuração não verificará se há dados alterados. No entanto, isso impedirá que a integração envie todos os atributos de usuário no perfil do usuário que não foram recebidos no lote de entrada original ou explicitamente definidos como um atributo para o evento. É importante ainda verificar se apenas os deltas são passados para a Braze.
Considerações sobre a desativação de atributos enriquecidos do usuário
Há algumas considerações que devem ser levadas em conta ao desativar Include Enriched User Attributes:
- A integração de servidor para servidor usa a API de eventos da mParticle para enviar eventos para a Braze. Cada solicitação é disparada por um evento. Quando um atributo do 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 estiver 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 a criação de um evento separado de “atributo de usuário atualizado” que envie apenas os atributos específicos do usuário que foram atualizados para a Braze. Note que, com essa abordagem, você ainda estará registrando um ponto de dados adicional para o evento “user attribute updated”, mas o uso de pontos de dados será muito menor do que o envio de todos os atributos de usuários em todas as chamadas 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” estiver desativado, eles não serão mais passados para a Braze. Para encaminhar atributos calculados para a 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 downstream 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 Braze
Se as notificações por push não estiverem funcionando ao usar o kit de eventos Braze (integração de kit incorporado) no iOS, verifique o seguinte:
- Encaminhamento de 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 Braze tem o 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 Braze deve 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 início do ciclo de vida do seu app.
- Method swizzling: O kit Apple da mParticle 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.
- Tratamento 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 ao build do seu app. Para mais detalhes, consulte Solução de problemas de push no iOS.
Envio de dados desnecessários ou duplicados para a Braze
A Braze conta um ponto de dados toda 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ção dentro da Braze e garantir que apenas deltas de atributos estejam sendo passados.
Editar esta página no GitHub