Amplitude para Currents
A Amplitude é uma plataforma de análise de dados e business intelligence de produtos.
A integração bidirecional entre a Braze e a Amplitude permite sincronizar suas coortes da Amplitude, características de usuários e eventos na Braze, bem como aproveitar o Braze Currents para exportar seus eventos da Braze para a Amplitude a fim de realizar análises mais profundas dos dados de seu produto e marketing.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta Amplitude | Uma conta Amplitude é necessária para aproveitar essa parceria. |
| Currents | Para exportar dados de volta para o Amplitude, você precisa ter o Braze Currents configurado para sua conta. |
Integração de exportação de dados
Uma lista completa dos eventos e propriedades de eventos que podem ser exportados da Braze para o Amplitude pode ser encontrada nas seções a seguir. Todos os eventos enviados ao Amplitude incluirão o external_user_id do usuário como o ID de usuário do Amplitude. As propriedades de eventos específicas da Braze serão enviadas sob a chave event_properties nos dados enviados ao Amplitude.
Para usar esse recurso, o ID de usuário do Amplitude deve corresponder ao ID externo da Braze.
A Braze enviará dados de eventos apenas para usuários que tenham seu external_user_id definido ou para usuários anônimos que tenham seu device_id definido. Para os usuários anônimos, será necessário sincronizar o ID de dispositivo do Amplitude com o ID de dispositivo da Braze no SDK. Por exemplo:
1
amplitude.setDeviceId(Appboy.getInstance(context).getDeviceId();)
Você pode exportar dois tipos de eventos para o Amplitude: Eventos de engajamento com mensagem, que consistem nos eventos da Braze diretamente relacionados ao envio de mensagens, e Eventos de comportamento do cliente, que incluem outras atividades no app ou website, como sessões, eventos personalizados e compras rastreadas pela plataforma. Todos os eventos regulares são prefixados com [Appboy], e todos os eventos personalizados são prefixados com [Appboy] [Custom Event]. As propriedades de eventos personalizados e de compra são prefixadas com [Custom event property] e [Purchase property], respectivamente.
Todas as coortes nomeadas e importadas para a Braze serão prefixadas com [Amplitude] e sufixadas com seu cohort_id. Isso significa que uma coorte chamada “TEST_COHORT” com o cohort_id “abcd1234” será intitulada [Amplitude] TEST_COHORT: abcd1234 nos filtros da Braze.
Entre em contato com seu gerente de conta ou abra um ticket de suporte se precisar de acesso a direitos de eventos adicionais.
Etapa 1: Configurar a integração do Amplitude na Braze
No Amplitude, localize sua chave de API de exportação do Amplitude.
Mantenha sua chave de API do Amplitude atualizada. Se as credenciais do seu conector expirarem, o conector deixará de enviar eventos. Se isso persistir por mais de 48 horas, os eventos do conector serão descartados e os dados serão permanentemente perdidos.
Etapa 2: Criar o Braze Current
Na Braze, navegue até Currents > + Create Current > Create Amplitude Export. Forneça um nome de integração, e-mail de contato, chave de API de exportação do Amplitude e região do Amplitude nos campos listados. Em seguida, selecione os eventos que deseja rastrear; uma lista de eventos disponíveis é fornecida. Por fim, clique em Launch Current
Os eventos enviados do Braze Currents para o Amplitude serão contabilizados na sua cota de volume de eventos do Amplitude.
Se você receber um erro “Invalid API key” ao colar sua chave de API do Amplitude, tente digitar a chave manualmente. Alguns navegadores podem adicionar caracteres ocultos ao copiar e colar, o que pode causar erros de validação.
Para saber mais, consulte a documentação do Amplitude sobre a Integração Appboy Amplitude.
Limites de frequência
O Currents se conecta à API HTTP da Amplitude, que tem um limite de frequência de 30 eventos/segundo por dispositivo e um limite não documentado de 500 mil eventos/dia por dispositivo. Se esses limites forem excedidos, a Amplitude aplicará throttling nos eventos registrados pelo Currents. Se um dispositivo na sua integração exceder esse limite de frequência, você poderá ter uma postergação no momento em que os eventos de todos os dispositivos aparecerão na Amplitude.
Os dispositivos não devem reportar mais de 30 eventos/segundo ou 500 mil eventos/dia em circunstâncias normais, e esse padrão de eventos só deve ocorrer devido a uma integração mal configurada. Para evitar esse tipo de postergação, certifique-se de que sua integração SDK reporte eventos em uma taxa normal, conforme especificado nas nossas instruções de integração SDK, e evite executar testes automatizados que gerem muitos eventos para um único dispositivo.
Eventos do Currents compatíveis
A Braze oferece suporte à exportação dos seguintes eventos para o Amplitude:
Para ver a estrutura da carga útil de cada evento, selecione a guia Amplitude no glossário de eventos de engajamento com mensagem e no glossário de eventos de comportamento do cliente.