VISTO
Casos de uso
Pré-requisitos
Antes de começar, você precisará do seguinte:
Pré-requisito | Descrição |
---|---|
Uma campanha SEEN | É necessária uma campanha SEEN para aproveitar essa parceria. |
Fonte de dados | Você precisará enviar dados ao SEEN para personalizar seus vídeos. Certifique-se de que todos os dados relevantes estejam disponíveis no Braze e que você passe os dados com braze_id como identificador. |
URL do webhook de transformação de dados do Braze | A transformação de dados do Braze será usada para reformatar os dados de entrada do SEEN para que possam ser aceitos pelo endpoint /users/track do Braze. |
Limite de taxa
Integração do SEEN com o Braze
Este exemplo usa um webhook POST para enviar dados ao SEEN e uma transformação de dados para receber os dados de volta ao Braze. Se você tiver várias campanhas de vídeo com o SEEN, repita o processo para conectar o Braze a todas as campanhas de vídeo.
Etapa 1: Criar uma campanha de webhook
Dê um nome à sua campanha e consulte a tabela a seguir para criar seu webhook:
Campo | Informações |
---|---|
URL do webhook | Use o seguinte URL de webhook. Você receberá seu campaign_slug do SEEN para chamar o endpoint correto.https://api.seen.io/v1/campaigns/{campaign_slug}/receivers/ |
Método HTTP | Use o POST método. |
Corpo da solicitação | Digite o corpo da solicitação em um texto bruto semelhante ao seguinte.
Para saber mais, consulte API do SEEN. |
Cabeçalhos da solicitação | Use as informações a seguir para preencher os cabeçalhos de sua solicitação: - Autorização: Token {token} - Content-Type: application/json Você receberá seu token de autenticação do SEEN. |
Agora é possível testar o webhook com um usuário, alternando para a guia Teste.
Etapa 2: Criar transformação de dados
- Essas são as duas atribuições que usaremos neste exemplo.
- Dê um nome à sua transformação e, em seguida, selecione Iniciar do zero e defina Destino como POST: Rastreamento de usuários.
- Selecione Compartilhar o URL do webhook com o SEEN.
- Você pode usar o código abaixo como ponto de partida para a transformação:
1
2
3
4
5
6
7
8
9
10
11
let brazecall = {
"attributes": [
{
"braze_id": payload.customer_id,
"_update_existing_only": true,
"landing_page_url": payload.landing_page_url,
"email_thumbnail_url": payload.email_thumbnail_url
}
]
};
return brazecall;
Se você quiser incluir outros dados, certifique-se de incluí-los também. Lembre-se de discutir também com o SEEN para que a carga útil do retorno de chamada inclua todos os campos necessários.
6. Envie uma carga útil de teste para o endpoint fornecido.
1
2
3
4
5
6
7
8
9
{
"customer_id": "101",
"campaign_slug": "onboarding",
"landing_page_url": "your.subdomain.com/v/12345",
"video_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/output.m3u8",
"thumbnail_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/thumbnail.jpg",
"email_thumbnail_url": "https://motions.seen.io/298abdcf-1f0f-46e7-9c26-a35b4c1e83cc/d3c1dffdf063986ad521a63e3e68fd7d1100c90a/email_thumbnail.jpg"
}
7. Selecione Validate (Validar ) para garantir que tudo funcione como planejado. 8.