Personalização de cópia zero usando CDI

Saiba como sincronizar os acionadores do Canvas usando CDI para personalização de cópia zero. Esse recurso acessa informações específicas do usuário da sua solução de armazenamento de dados e as transmite para um Canvas de destino. As etapas do Canvas podem, opcionalmente, incluir campos de personalização que não são mantidos nos perfis de usuário do Braze.

Sincronização de acionadores do Canvas

Etapas de início rápido

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

• Somente identificadores externos de ID ou alias de usuário são compatíveis. E-mail e números de telefone não são identificadores compatíveis.
• Somente os usuários existentes do Braze podem ser sincronizados. Não é possível criar novos usuários.
• properties substitui a coluna payload. Essa é uma cadeia de caracteres JSON dos campos que você deseja usar como propriedades de entrada do Canvas para personalização.

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

Uso de acionadores do Canvas

Etapa 1: Configurar a fonte de dados para acionadores do 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 o Canvas de destino para os acionadores do Canvas. Crie um novo Canvas ou selecione um Canvas acionado por API existente. Consulte Tipos de programação de entrada para obter instruções sobre como criar uma tela com um tipo de programação de entrega acionado por API.
2. Depois de selecionar o tipo de programação de entrega acionada por API, continue com a configuração do Canvas e crie seu Canvas. As telas podem variar de simples envios de mensagem única a complexos fluxos de trabalho de clientes com várias etapas.
3. Nas etapas do Canvas, use as propriedades de entrada do Canvas para personalizar as mensagens com campos de propriedades que você planeja sincronizar da tabela de origem.
   • Por exemplo, se na Etapa 1 você instrumentou um campo de propriedades para account_balance, você usaria o seguinte modelo Liquid para personalizar sua mensagem: \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. Depois de criar seu Canvas, inicie-o e prossiga para a Etapa 3.

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

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

1. No Braze, vá para Data Settings > Cloud Data Ingestion.
2. Configure a conexão inserindo os detalhes da conexão (ou reutilize as credenciais existentes) e a tabela de origem da Etapa 1.
3. Forneça um nome para a integração.
4. Selecione o tipo de dados dos acionadores do Canvas.
5. Escolha seu Canvas de destino (na Etapa 2).
6. Escolha uma frequência de sincronização.
7. Configure as preferências de notificação.
8. Selecione Testar conexão para confirmar que tudo está funcionando como esperado. Se estiver se conectando ao Snowflake, primeiro adicione a chave pública exibida no painel ao usuário criado para o Braze para se conectar ao Snowflake. Para concluir essa etapa, você precisará de acesso SECURITYADMIN ou superior no Snowflake.
9. Salve a sincronização para começar a sincronizar os acionadores do Canvas.

Quando a sincronização for executada, os usuários da tabela de origem começarão a entrar no Canvas. Use a análise do Canvas e a página de registros de sincronização da ingestão de dados na nuvem para monitorar o desempenho.

Considerações

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

Embora os acionadores do CDI Canvas estejam em acesso antecipado, considere os detalhes a seguir:

• Até 5 sincronizações ativas do acionador do Canvas por espaço de trabalho
• Cada execução de sincronização inserirá os 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 mais longos de entrada da fonte para a tela quando:
    • Sincronização de mais de 3,75 milhões de usuários por execução de sincronização.
    • Usar os acionadores do CDI Canvas quando já estiver saturando o limite de taxa da API REST para /canvas/trigger/send.