CDI를 사용한 제로 복사 개인화

CDI를 사용하여 제로 복사 개인화를 위한 캔버스 트리거를 동기화하는 방법을 알아보세요. 이 기능은 데이터 저장 솔루션에서 사용자별 정보에 액세스하여 대상 캔버스로 전달합니다. 캔버스 단계에는 Braze 고객 프로필에 유지되지 않는 개인화 필드를 선택적으로 포함할 수 있습니다.

캔버스 트리거 동기화

빠른 시작 단계

이미 Braze CDI에 익숙하다면, 캔버스 트리거 동기화 설정은 사용자 데이터 CDI 통합 프로세스와 거의 동일하며, 다음과 같은 주의 사항이 있습니다:

• 외부 ID 또는 사용자 별칭 식별자만 지원됩니다. 이메일 및 전화번호는 지원되지 않는 식별자입니다.
• 기존 Braze 사용자만 동기화할 수 있습니다. 새 사용자는 생성할 수 없습니다.
• properties가 payload 열을 대체합니다. 이것은 개인화를 위한 캔버스 진입 등록정보로 사용하려는 필드의 JSON 문자열입니다.

시작하려면 새 동기화를 생성할 때 캔버스 트리거 데이터 유형을 선택하세요.

캔버스 트리거 사용

1단계: 캔버스 트리거를 위한 데이터 소스 설정

• 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

2단계: 대상 캔버스 구성

1. 캔버스 트리거를 위한 대상 캔버스를 설정하세요. 새로운 API 트리거 캔버스를 생성하거나 기존 캔버스를 선택하세요. API 트리거 전달 스케줄 유형으로 캔버스를 만드는 방법에 대한 지침은 진입 스케줄 유형을 참조하세요.
2. API 트리거 전달 스케줄 유형을 선택한 후, 캔버스 설정을 계속하고 캔버스를 구축하세요. 캔버스는 단순한 단일 메시지 전송부터 여러 단계가 포함된 복잡한 고객 워크플로우까지 다양할 수 있습니다.
3. 캔버스 단계 내에서 캔버스 진입 등록정보를 사용하여 소스 테이블에서 동기화할 등록정보 필드로 메시지를 개인화하세요.
   • 예를 들어, 1단계에서 account_balance에 대한 등록정보 필드를 설정했다면, 메시지를 개인화하기 위해 다음의 Liquid 템플릿을 사용할 수 있습니다: \{\{canvas_entry_properties.\$\{account_balance\}\}\}.
4. 캔버스를 구축한 후 시작하고 3단계로 진행하세요.

3단계: 제로 복사 동기화 생성

소스 설정이 완료되고 대상 캔버스가 시작되면, 새로운 데이터 동기화를 생성하세요:

1. Braze에서 데이터 설정 > 클라우드 데이터 수집으로 이동하세요.
2. 연결 세부정보(또는 기존 자격 증명 재사용)를 입력하고 1단계의 소스 테이블을 설정하세요.
3. 통합 이름을 지정하세요.
4. 캔버스 트리거 데이터 유형을 선택하세요.
5. 대상 캔버스를 선택하세요(2단계에서 설정한 캔버스).
6. 동기화 빈도를 선택하세요.
7. 알림 기본 설정을 구성하세요.
8. 연결 테스트를 선택하여 모든 것이 예상대로 작동하는지 확인하세요. Snowflake에 연결하는 경우, 먼저 대시보드에 표시된 공개 키를 Braze가 Snowflake에 연결하기 위해 생성한 사용자에게 추가하세요. 이 단계를 완료하려면 Snowflake에서 SECURITYADMIN 이상의 액세스 권한이 필요합니다.
9. 동기화를 저장하여 캔버스 트리거 동기화를 시작하세요.

동기화가 실행되면 소스 테이블의 사용자가 캔버스에 진입하기 시작합니다. 캔버스 분석 및 클라우드 데이터 수집 동기화 로그 페이지를 사용하여 성과를 모니터링하세요.

고려 사항

CDI 캔버스 트리거는 /canvas/trigger/send에 대한 REST API 사용량 제한을 활용합니다. 이 엔드포인트를 CDI 캔버스 트리거와 REST API 통합에서 동시에 사용하는 경우, 결합된 사용량이 사용량 제한에 포함될 것으로 예상하세요.

CDI 캔버스 트리거가 얼리 액세스 중인 동안 다음 세부 사항을 고려하세요:

• 워크스페이스당 최대 5개의 활성 캔버스 트리거 동기화
• 각 동기화 실행은 최대 약 375만 사용자/시간의 속도로 해당 대상 캔버스에 사용자를 진입시킵니다.
  • 다음과 같은 경우 소스에서 캔버스 진입까지의 시간이 길어질 수 있습니다:
    • 동기화 실행당 375만 명 이상의 사용자를 동기화하는 경우.
    • REST API의 /canvas/trigger/send에 대한 사용량 제한을 이미 포화 상태로 사용하면서 CDI 캔버스 트리거를 사용하는 경우.