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단계: 대상 Canvas를 구성합니다.

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. 동기화를 시작하려면 Canvas 트리거에 대한 동기화를 저장하십시오.

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

고려 사항

CDI Canvas 트리거는 /canvas/trigger/send에 대한 REST API 비율 제한을 활용합니다. 이 엔드포인트를 CDI Canvas 트리거 및 REST API 통합과 동시에 사용하는 경우, 결합된 사용량이 비율 제한에 포함될 것으로 예상하십시오.

CDI Canvas 트리거가 초기 액세스 중일 때 다음 세부 사항을 고려하십시오:

• 작업 공간당 최대 5개의 활성 Canvas 트리거 동기화
• 각 동기화 실행은 최대 약 375만 사용자의 속도로 해당 대상 Canvas에 사용자를 입력합니다.
  • 다음과 같은 경우 Canvas 진입 시간이 길어질 수 있습니다:
    • 동기화 실행당 375만 명 이상의 사용자를 동기화하는 경우.
    • REST API의 [비율 제한을 이미 초과하는 경우} CDI Canvas 트리거를 사용하는 경우.