Movable Ink 고객 데이터 API에 연결하기
Braze와 Movable Ink의 고객 데이터 API 통합을 통해 마케터는 Braze에 저장된 고객 이벤트 데이터를 활성화하여 Movable Ink 내에서 개인화된 콘텐츠를 생성할 수 있습니다.
Movable Ink는 고객 데이터 API를 통해 Braze에서 행동 이벤트를 수집할 수 있습니다. 이벤트는 Movable Ink에 전달되는 고유 사용자 ID(UUID)를 기반으로 고객 프로필에 저장됩니다.
Stories, Movable Ink 고객 데이터 API, 그리고 Movable Ink가 행동 데이터를 활용하는 방법에 대한 자세한 내용은 다음 고객지원 센터 문서를 참조하세요:
필수 조건
| 요구 사항 | 설명 |
|---|---|
| Movable Ink 계정 | 이 파트너십을 활용하려면 Movable Ink 계정이 필요합니다. |
| Movable Ink API 자격 증명 | Movable Ink의 솔루션 팀이 API 자격 증명을 생성해 드립니다. API 자격 증명은 다음으로 구성됩니다:
|
| 행동 이벤트 페이로드 | 이벤트 페이로드를 Movable Ink 클라이언트 경험 팀과 공유해야 합니다. 자세한 내용은 Movable Ink와 이벤트 페이로드 공유하기를 참조하세요. |
| 크리에이티브 자산 및 비즈니스 로직 | Movable Ink에 블록을 구축하는 방법을 안내하는 Adobe Photoshop(PSD) 파일과 대체 이미지를 포함한 크리에이티브 자산을 공유해야 합니다. 또한 파트너 활성화 콘텐츠 블록을 표시하는 방법과 시기에 대한 비즈니스 로직을 제공해야 합니다. |
통합
1단계: Braze에서 웹훅 Campaign 생성하기
1a단계: 새 Campaign 생성하기
- Braze에서 웹훅 Campaign을 생성합니다.
- Campaign에 이름과 선택적 설명을 입력합니다.
- 템플릿으로 Blank Template을 선택합니다.
1b단계: 고객 데이터 API 자격 증명 추가하기
- Webhook URL 필드에 Movable Ink 엔드포인트 URL을 입력합니다.
- Settings 탭을 선택합니다.
- 다음 요청 헤더를 키-값 페어로 추가합니다:
| 키 | 값 |
|---|---|
| Content-Type | application/json |
| Authorization | Movable Ink에서 받은 기본 인증을 입력합니다. |
1c단계: 페이로드 구성하기
- Compose 탭으로 돌아갑니다.
- Request Body에 JSON 키-값 페어로 직접 요청 본문을 생성하거나 이벤트 페이로드를 원시 텍스트로 입력합니다. 표준 이커머스 이벤트 예시는 샘플 페이로드를 참조하세요.
1d단계: 웹훅 테스트하기
샘플 페이로드를 Movable Ink 클라이언트 경험 팀과 공유해야 합니다. 구성한 페이로드를 기반으로 Test 탭에서 이 페이로드를 생성할 수 있습니다.
Movable Ink는 Movable Ink 클라이언트 경험 팀이 매핑을 완료하고 테스트를 받을 준비가 되었음을 확인할 때까지 Braze에서 웹훅 테스트를 기다리는 것을 권장합니다. 이 매핑이 완료되지 않으면 테스트 시 오류가 발생할 가능성이 높습니다.
웹훅을 테스트하려면 다음을 수행합니다:
- Test 탭을 선택합니다.
- 사용자로 메시지를 미리보기하여 해당 사용자의 샘플 이벤트 페이로드를 확인합니다. 랜덤 사용자, 특정 사용자 또는 커스텀 사용자로 미리보기를 선택할 수 있습니다.
- 모든 것이 정상이면 Send test를 클릭하여 테스트 요청을 보냅니다.
2단계: Campaign 설정 마무리하기
2a단계: Campaign 스케줄 설정하기
웹훅 작성 및 테스트가 완료되면 Campaign을 스케줄합니다.
Braze는 스케줄, 실행 기반, API 트리거 전달을 지원합니다. 실행 기반 전달은 대부분의 행동 이벤트 사용 사례에 가장 적합합니다. 사용 사례에 적합한 방법에 대한 질문이 있으면 Braze 및 Movable Ink 고객 성공 매니저에게 문의하세요.
실행 기반 전달의 경우:
- 트리거 동작을 지정합니다. 이것은 Movable Ink로 웹훅을 트리거하는 이벤트입니다.
- Schedule Delay가 Immediately로 설정되어 있는지 확인합니다. 이벤트 데이터는 이벤트 발생 직후 지연 없이 Movable Ink로 전송되어야 합니다.
- 시작 시간을 지정하여 Campaign 기간을 설정합니다. 종료 시간은 일반적으로 적용되지 않지만, 사용 사례에 필요한 경우 설정할 수 있습니다.
데이터가 실시간으로 Movable Ink에 스트리밍되도록 하려면 Send campaign to users in their local time zone을 선택하지 마세요.
2b단계: 오디언스 지정하기
다음으로, 이 Campaign의 타겟 사용자를 결정합니다. 자세한 내용은 사용자 타겟팅을 참조하세요.
Control Group 체크박스를 해제하여 Campaign에서 A/B 테스트를 사용하지 않도록 합니다. 대조군이 포함되면 일정 비율의 사용자 데이터가 Movable Ink로 전송되지 않습니다. 모든 오디언스는 대조군이 아닌 배리언트로 이동해야 합니다.
2c단계: 전환 이벤트 선택하기(선택 사항)
필요한 경우 Braze 내에서 이 Campaign에 전환 이벤트를 할당할 수 있습니다.
그러나 웹훅은 데이터 스트리밍만을 목적으로 하므로, 이 수준의 기여도는 Braze의 행동 데이터가 콘텐츠 개인화에 사용된 후 Campaign 수준에서 기여도를 확인하는 것보다 유용하지 않을 수 있습니다.
3단계: Campaign 시작하기
웹훅 설정을 검토하고 Campaign을 시작합니다.
고려 사항
고유 사용자 식별자 정렬하기
mi_u로 사용하는 고유 사용자 식별자(UUID) 값이 Braze 내에서 사용 가능하고 Movable Ink로 전송되는 이벤트 페이로드에 포함될 수 있는지 확인하세요.
이렇게 하면 Movable Ink가 이미지를 생성할 때 참조하는 행동 이벤트가 해당 행동 이벤트를 수신한 동일한 고객과 연결됩니다. UUID 값이 Braze external_id와 동일하지 않은 경우, 이 식별자를 활용하려면 UUID를 캡처하여 Braze에 속성으로 전달하거나 Braze 이벤트의 이벤트 등록정보에 포함해야 합니다.
Braze는 여러 플랫폼(예: 웹 및 모바일 앱)에서 사용자 행동을 추적하므로, 단일 사용자가 여러 개의 고유한 익명 ID를 가질 수 있습니다. 이러한 ID는 identify 이벤트가 Movable Ink로 전송될 때 단일 알려진 Stories 고객 프로필로 병합될 수 있으며, identify 이벤트에 익명 식별자와 단일 알려진 식별자가 모두 포함되어야 합니다.
Movable Ink가 단일 사용자에 대한 user_id를 수신하면, 해당 사용자의 모든 향후 이벤트에 동일한 user_id가 포함되어야 합니다.
Movable Ink와 이벤트 페이로드 공유하기
Movable Ink의 고객 데이터 API에 대한 커넥터를 설정하기 전에 이벤트 페이로드를 Movable Ink 클라이언트 경험 팀과 공유해야 합니다. 이를 통해 Movable Ink가 이벤트를 이벤트 스키마에 매핑할 수 있으며, 거부되거나 실패한 API 호출을 방지할 수 있습니다.
이벤트 등록정보를 사용하여 Braze 내에서 이벤트 페이로드를 생성할 수 있습니다. 랜덤 사용자에 대한 샘플 페이로드를 생성하거나 특정 사용자 ID를 검색하여 생성합니다. 자세한 내용은 위의 1d단계를 참조하세요.
이 샘플 페이로드를 Movable Ink 클라이언트 경험 팀과 공유합니다. 샘플 페이로드에 민감한 개인 식별 정보(예: 이메일 주소, 전화번호 또는 전체 생년월일)가 포함되지 않도록 합니다.
커스텀 이벤트 등록정보 및 등록정보에 포함된 데이터의 예상 형식에 대해 자세히 알아보려면 커스텀 이벤트 등록정보를 참조하세요.
알려진 사용자 대 익명 사용자
Braze에서 이벤트는 익명 사용자 프로필에 기록될 수 있습니다. 이벤트 로깅 중 고객 프로필에 연결되는 식별자는 사용자가 생성된 방법(Braze SDK 또는 API를 통해)과 사용자 라이프사이클의 현재 단계에 따라 달라집니다.
알려진 사용자에 대해서만 Braze 이벤트 전달하기
웹훅 Campaign에서 External User ID 필터를 사용하여 external_id가 있는 사용자만 타겟팅합니다. 필터 External User ID is not blank를 사용합니다.
익명 및 알려진 사용자에 대해 Braze 이벤트 전달하기
익명 사용자(프로필에 external_id가 할당되기 전의 사용자)의 Braze 이벤트를 전달하려면, external_id를 사용할 수 있게 될 때까지 Movable Ink의 anonymous_id로 사용할 식별자를 결정해야 합니다. Braze 고객 프로필에서 일정하게 유지되는 anonymous_id를 선택합니다. 웹훅 본문에서 Liquid 로직을 사용하여 anonymous_id 또는 user_id를 전달할지 결정할 수 있습니다.
자세한 내용은 샘플 페이로드의 예시 웹훅을 참조하세요.
예시 페이로드
제품 조회 이벤트
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
"events": [
{
"email": "[email protected]",
"name": "Product Viewed",
"time": "2023-12-06T19:20:45+01:00",
"properties": {
"categories": [
{
"id": "Bathroom",
"url": "https://example.com/cat/bathroom"
}
],
"meta": {
"color": "green"
},
"title": "All-Purpose Cleaning Wipes",
"price": 1.99,
"id": "56544",
"url": "https://www.example.com/variants_id/5f08cb918dcc595aa74b0fbc"
}
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"anonymous_id": "123-abc-678",
"event": "product_viewed",
"properties": {
"categories": [
{
"id": "Bathroom",
"url": "https://example.com/cat/bathroom"
}
],
"meta": {
"color": "green"
},
"title": "All-Purpose Cleaning Wipes",
"price": 1.99,
"id": "56544",
"url": "https://www.example.com/variants_id/5f08cb918dcc595aa74b0fbc"
},
"timestamp": 1257894000000,
"timezone": "America/New_York",
"type": "track",
"user_id": "5c3aa83113dd490100d3d8d7"
}'
이 예시에서는 external_id가 없는 사용자에 대해 해시된 이메일 주소를 anonymous_id로 사용합니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}
// Example of md5 hashing the email address to use as the anonymous_id
{% assign anon_id = {{${email_address}}} | md5 %}
// Condition logic to determine which identifier to use. If an external_id is available use that, otherwise use the anonymous_id
{% if {{${user_id}}} %}
{% capture user_identifier %}"user_id": "{{${user_id}}}"{% endcapture %}
{% else %}
{% capture user_identifier %}"anonymous_id": "{{anon_id}}"{% endcapture %}
{% endif %}
{
{{user_identifier}}
"event": "product_viewed",
"properties": {
"categories": [
{
"id": "{{event_properties.${categories}[0].id}}",
"url": "{{event_properties.${categories}[0].url}}"
}
],
"meta": {
"color": "{{event_properties.${meta}.color}}"
},
"title": "{{event_properties.${title}}}",
"price": "{{event_properties.${price}}}",
"id": "{{event_properties.${id}}}",
"url": "{{event_properties.${url}}}"
},
"timestamp": "{{timestamp}}",
"timezone": "{{${time_zone}}}",
"type": "track",
}
카테고리 조회 이벤트
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"events": [
{
"external_id": "123456789",
"name": "Category Viewed",
"time": "2023-12-06T19:20:45+01:00",
"properties": {
"id": "bathroom-1",
"title": "Bathroom Stuff",
"url": "https://www.example.com/categories/bathroom"
}
}
]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"anonymous_id": "123-abc-678",
"event": "category_viewed",
"properties": {
"id": "bathroom-1",
"title": "Bathroom Stuff",
"url": "https://www.example.com/categories/bathroom"
},
"timestamp": 1257894000000,
"timezone": "America/New_York",
"type": "track",
"user_id": "5c3aa83113dd490100d3d8d7"
}'
이 예시는 알려진 사용자(external_id가 있는 사용자)에 대해서만 이벤트를 추적하는 웹훅을 보여줍니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}
{
"event": "category_viewed",
"properties": {
"id": "{{event_properties.${id}}}",
"title": "{{event_properties.${title}}}",
"url": "{{event_properties.${url}}}"
},
"timestamp": "{{timestamp}}",
"timezone": "{{${time_zone}}}",
"type": "track",
"user_id": "{{${user_id}}}"
}
식별 이벤트
1
2
3
4
5
6
7
8
9
{
"events": [
{
"external_id": "123456789",
"name": "Account Created",
"time": "2023-12-06T19:20:45+01:00"
}
]
}
1
2
3
4
5
6
7
8
9
10
curl --location --request POST 'https://collector.movableink-dmz.com/behavioral/{{key}}' \
--header 'Authorization: Basic {{authorization}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"anonymous_id": "jg0iq5gd30dqpwn8zmx05p06mzjmjir4r8",
"timestamp": 1257894000000,
"timezone": "America/New_York",
"type": "identify",
"user_id": "mycustomerid123"
}'
이 예시에서는 external_id가 없는 사용자에 대해 해시된 이메일 주소를 anonymous_id로 사용합니다.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Converts the timestamp of "now" to seconds since 1970 and assigns it to a local variable "timestamp"
{% assign timestamp = "now" | date: "%s" %}
// Example of md5 hashing the email address to use as the anonymous_id
{% assign anon_id = {{${email_address}}} | md5 %}
{
"anonymous_id": "{{anon_id}}",
"timestamp": "{{timestamp}}",
"timezone": "{{${time_zone}}}",
"type": "identify",
"user_id": "{{${user_id}}}"
}