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에서 보안 관리자 이상의 액세스 권한이 필요합니다.
9. 동기화를 저장하여 캔버스 트리거 동기화를 시작합니다.

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

고려 사항

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

CDI 캔버스 트리거는 얼리 액세스 버전이지만 다음 세부 사항을 고려하세요:

• 작업 공간당 최대 5개의 활성 캔버스 트리거 동기화 가능
• 동기화를 실행할 때마다 시간당 최대 약 375만 명의 사용자가 각 대상 캔버스에 입력됩니다.
  • 소스를 캔버스에 입력하는 시간이 길어질 때를 대비하세요:
    • 동기화 실행당 375만 명 이상의 사용자를 동기화합니다.
    • CDI 캔버스를 사용하면 /canvas/trigger/send 에 대한 REST API의 속도 제한이 이미 포화 상태일 때 트리거됩니다.