Personalização sem cópia usando CDI

Aprenda como sincronizar disparadores de Canvas usando CDI para personalização sem cópia. Este recurso acessa informações específicas do usuário da sua solução de armazenamento de dados e as passa para um Canvas de destino. Os passos do Canvas podem opcionalmente incluir campos de personalização que não são persistidos nos perfis de usuário do Braze.

Sincronizando disparadores de Canvas

Passos para início rápido

Se você já está familiarizado com o CDI do Braze, note que a configuração para uma sincronização de disparador de Canvas segue de perto o processo para integrações de CDI de dados do usuário, com as seguintes ressalvas:

• Apenas identificadores de ID externo ou alias de usuário são suportados. E-mails e números de telefone não são identificadores suportados.
• Apenas usuários existentes do Braze podem ser sincronizados. Novos usuários não podem ser criados.
• properties substitui a coluna payload. Esta é uma string JSON dos campos que você deseja usar como propriedades de entrada do Canvas para personalização.

Para começar, selecione o tipo de dado Disparadores de Canvas ao criar uma nova sincronização.

Usando disparadores de Canvas

Etapa 1: Configurar fonte de dados para disparadores de Canvas

• snowflake
• redshift
• bigquery
• databricks
• fabric
• file storage

1
2
3
4
5
6
7
8
9
10
11
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE OR REPLACE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
     UPDATED_AT TIMESTAMP_NTZ(9) NOT NULL DEFAULT SYSDATE(),
     --at least one of external_id or alias_name and alias_label is required  
     EXTERNAL_ID VARCHAR(16777216),
     --if using user alias, both alias_name and alias_label are required
     ALIAS_LABEL VARCHAR(16777216),
     ALIAS_NAME VARCHAR(16777216),
     PROPERTIES VARCHAR(16777216)
);

1
2
3
4
5
6
7
8
9
10
11
12
13
CREATE ROLE BRAZE_INGESTION_ROLE;

GRANT USAGE ON DATABASE BRAZE_CLOUD_PRODUCTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION TO ROLE BRAZE_INGESTION_ROLE;
GRANT SELECT ON TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC TO ROLE BRAZE_INGESTION_ROLE;

CREATE WAREHOUSE BRAZE_INGESTION_WAREHOUSE;
GRANT USAGE ON WAREHOUSE BRAZE_INGESTION_WAREHOUSE TO ROLE BRAZE_INGESTION_ROLE;

CREATE USER BRAZE_INGESTION_USER;
GRANT ROLE BRAZE_INGESTION_ROLE TO USER BRAZE_INGESTION_USER;

1
2
3
4
5
6
7
8
9
10
11
CREATE DATABASE BRAZE_CLOUD_PRODUCTION;
CREATE SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION;
CREATE TABLE BRAZE_CLOUD_PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC (
    updated_at timestamptz default sysdate not null,
    --at least one of external_id or alias_name and alias_label is required
    external_id varchar not null,.
    --if using user alias, both alias_name and alias_label are required
    alias_label varchar,
    alias_name varchar,
    properties varchar(max)
 );

1
2
3
CREATE USER braze_user PASSWORD '{password}';
GRANT USAGE ON SCHEMA BRAZE_CLOUD_PRODUCTION.INGESTION to braze_user;
GRANT SELECT ON TABLE CANVAS_TRIGGERS_SYNC TO braze_user;

1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

1
2
3
4
5
6
7
8
9
10
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.CANVAS_TRIGGERS_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp,
  --At least one of external_id or alias_name and alias_label is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  properties JSON
);

1
CREATE SCHEMA BRAZE-CLOUD-PRODUCTION.INGESTION;

1
2
3
4
5
6
7
8
9
10
CREATE TABLE `BRAZE-CLOUD-PRODUCTION.INGESTION.USERS_ATTRIBUTES_SYNC`
(
  updated_at TIMESTAMP DEFAULT current_timestamp(),
  --At least one of external_id or alias_name and alias_label is required  
  external_id STRING,
  --If using user alias, both alias_name and alias_label are required
  alias_name STRING,
  alias_label STRING,
  properties STRING, STRUCT, or MAP
);

1
2
3
4
5
6
7
8
9
10
11
CREATE OR ALTER TABLE [warehouse].[schema].[CDI_table_name] 
(
  UPDATED_AT DATETIME2(6) NOT NULL,
  PROPERTIES VARCHAR NOT NULL,
  --at least one of external_id or alias_name and alias_label is required  
  EXTERNAL_ID VARCHAR,
  --if using user alias, both alias_name and alias_label are required
  ALIAS_NAME VARCHAR,
  ALIAS_LABEL VARCHAR
)
GO

Etapa 2: Configure seu Canvas de destino

1. Configure seu Canvas de destino para os gatilhos do Canvas. Crie um novo ou selecione um Canvas acionado por API existente. Consulte Tipos de agendamento de entrada para instruções sobre como criar um canvas com um tipo de agendamento de entrega acionado por API.
2. Após selecionar o tipo de agendamento de entrega acionado por API, continue com a configuração do Canvas e construa seu Canvas. Os Canvases podem variar de envios simples de mensagens únicas a fluxos de trabalho complexos de clientes com várias etapas.
3. Dentro das etapas do seu Canvas, use Propriedades de entrada do Canvas para personalizar mensagens com campos de propriedades que você planeja sincronizar da sua tabela de origem.
   • Por exemplo, se na Etapa 1 você instrumentou um campo de propriedades para account_balance, você usaria a seguinte modelagem Liquid para personalizar sua mensagem: \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Após construir seu Canvas, lance-o e prossiga para Etapa 3.

Etapa 3: Crie sua sincronização de cópia zero

Com a configuração da sua origem concluída e o Canvas de destino lançado, crie uma nova sincronização de dados:

1. No Braze, vá para Configurações de Dados > Ingestão de Dados na Nuvem.
2. Configure a conexão inserindo os detalhes da conexão (ou reutilize credenciais existentes) e a tabela de origem de Etapa 1.
3. Forneça um nome para a integração.
4. Selecione o tipo de dados Gatilhos do Canvas.
5. Escolha seu Canvas de destino (da Etapa 2).
6. Escolha uma frequência de sincronização.
7. Configure as preferências de notificação.
8. Selecione Test Connection para confirmar que tudo funciona como esperado. Se conectando ao Snowflake, primeiro adicione a chave pública exibida no dashboard ao usuário criado para o Braze se conectar ao Snowflake. Para completar esta etapa, você precisará de acesso SECURITYADMIN ou superior no Snowflake.
9. Salve a sincronização para começar a sincronizar os disparadores do Canvas.

Quando a sincronização for executada, os usuários na sua tabela de origem começarão a entrar no Canvas. Use a análise de dados do Canvas e a página de logs de sincronização de Ingestão de Dados na Nuvem para monitorar a performance.

Considerações

Os disparadores do Canvas CDI utilizam o limite de frequência da sua API REST para /canvas/trigger/send. Se você estiver usando este endpoint simultaneamente com os disparadores do Canvas CDI e sua integração com a API REST, espere que o uso combinado conte para o seu limite de frequência.

Enquanto os disparadores do Canvas CDI estão em acesso antecipado, considere os seguintes detalhes:

• Até 5 sincronizações ativas de disparadores do Canvas por espaço de trabalho
• Cada execução de sincronização entrará usuários em seu respectivo Canvas de destino a uma taxa máxima de aproximadamente 3,75 milhões de usuários por hora.
  • Esteja preparado para tempos de entrada mais longos de origem para Canvas quando:
    • Sincronizando mais de 3,75 milhões de usuários por execução de sincronização.
    • Usando disparadores do Canvas CDI quando já saturando o limite de frequência da sua API REST para /canvas/trigger/send.