DOTS.ECO

DOTS.ECO를 사용하면 추적 가능한 디지털 인증서를 통해 실제 환경에 미치는 영향에 대해 사용자에게 보상할 수 있습니다. 각 인증서에는 공유 가능한 인증서 URL 및 이미지 URL과 같은 메타데이터를 포함할 수 있으므로, 사용자는 자신의 영향력 증명을 확인하고 다시 방문할 수 있습니다.

이 통합은 DOTS.ECO에서 유지 관리합니다.

이 통합 정보

Braze와 DOTS.ECO는 고객 참여 여정을 실제 임팩트 보상으로 연결합니다. Braze Canvas 또는 Campaign 단계에서 연결된 콘텐츠를 사용하여 DOTS.ECO 인증서 생성 요청을 트리거할 수 있습니다. DOTS.ECO는 인증서 메타데이터(예: certificate_url 및 certificate_image_url)를 반환하며, 이를 고객 프로필에 커스텀 속성으로 저장하고 인앱 메시지, Content Cards, 푸시 알림과 같은 채널에서 재사용할 수 있습니다.

활용 사례

• 사용자가 주요 이벤트(구매, 레벨 완료, 구독, 추천)를 완료하면 임팩트 인증서를 트리거합니다.
• 연결된 콘텐츠 단계가 성공한 후 인앱 메시지에 개인화된 인증서 이미지를 표시합니다.
• 나중에 액세스할 수 있도록 인증서 URL이 포함된 “인증서 보기” Content Cards를 추가합니다.
• 인증서 메타데이터(예: certificate_url, certificate_image_url, certificate_header, greeting)를 커스텀 속성으로 저장하여 향후 메시징에서 재사용할 수 있도록 합니다.
• 원격 사용자 ID를 사용하여 인증서를 할당하면 사용자가 나중에 자신의 영향력을 확인하고 조회할 수 있습니다.
• 동일한 DOTS.ECO 사용자 업데이트 흐름을 유지하면서 임팩트 메시징(다른 카피/이미지)에 대해 A/B 테스트를 실행합니다.

필수 조건

시작하기 전에 다음이 필요합니다:

DOTS.ECO 통합하기

1단계: Canvas를 생성하고 사용자 업데이트 단계 추가하기

Braze 대시보드에서 사용자가 주요 이벤트(예: 구매, 구독 또는 마일스톤)를 완료할 때 트리거되는 새 Canvas를 만듭니다.

진입 단계 바로 뒤에 사용자 업데이트 단계를 추가합니다. 이 단계는 연결된 콘텐츠를 통해 DOTS.ECO API를 호출하고 반환된 인증서 데이터를 고객 프로필에 저장하는 데 사용됩니다.

이 단계를 사용하여 연결된 콘텐츠를 통해 DOTS.ECO API를 호출하고 반환된 인증서 데이터를 고객 프로필에 저장합니다.

2단계: 고급 JSON 작성 - 연결된 콘텐츠를 사용하여 DOTS.ECO에 POST 요청하기

사용자 업데이트 단계에서 고급 JSON 편집기로 전환하고 연결된 콘텐츠를 사용하여 DOTS.ECO 인증서 API에 POST 요청을 합니다.

capture 태그와 연결된 콘텐츠 요청을 사용하여 DOTS.ECO의 인증서 엔드포인트를 호출합니다. 그런 다음 응답을 고객 프로필에 커스텀 속성으로 저장합니다.

연결된 콘텐츠 및 사용자 업데이트 예제

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
{% capture post_body %}
{
  "remote_user_email": "{{${email_address} | default: '[email protected]'}}",
  "app_token": "YOUR_DOTS.ECO_APP_TOKEN",
  "impact_qty": 1,
  "remote_user_id": "{{${user_id} | default: ${braze_id}}}",
  "allocation_id": "YOUR_DOTS.ECO_ALLOCATION_ID"
}
{% endcapture %}

{% connected_content https://impact.dots.eco/api/v1/certificate/add?format=sdk
  :method post
  :headers { "auth-token": "YOUR_DOTS.ECO_AUTH_TOKEN" }
  :body {{post_body}}
  :content_type application/json
  :save result
%}

{
  "attributes": [
    {
      "certificate_image_url": "{{result.certificate_image_url}}",
      "certificate_url": "{{result.certificate_url}}",
      "certificate_id": "{{result.certificate_id}}"
    }
  ]
}

https://impact.dots.eco/api/v1/certificate/add?format=sdk로 요청을 보냅니다.

중요

이 통합은 Canvas 사용자 업데이트 단계 내에서 연결된 콘텐츠를 사용하여 DOTS.ECO API를 호출합니다. 먼저 API 클라이언트(예: Postman)로 요청을 테스트하여 토큰과 페이로드의 유효성을 검사하세요.

3단계: 메시지에 인증서 표시하기

인증서 속성이 고객 프로필에 저장되면 다운스트림 Canvas 메시지 단계에서 참조할 수 있습니다.

예를 들어:

• {{custom_attribute.${certificate_image_url}}}를 사용하여 인앱 메시지에 인증서 이미지를 표시합니다.
• {{custom_attribute.${certificate_url}}}를 사용하여 호스팅된 인증서에 연결합니다.

이를 통해 인앱 메시지, Content Cards 또는 푸시 알림에 임팩트 확인 정보를 개인화할 수 있습니다.

문제 해결

Braze 대시보드의 설정 > 메시지 활동 로그에서 연결된 콘텐츠 오류를 검토합니다.

• 연결된 콘텐츠가 빈 값을 반환하는 경우: :save result가 설정되어 있고 예상 응답 필드를 올바르게 참조하고 있는지 확인합니다.
• 속성이 메시지 단계에 표시되지 않는 경우:
  • Braze의 커스텀 속성 이름이 사용자 업데이트 단계에서 설정한 속성과 정확히 일치하는지 확인합니다.
  • 사용자 업데이트 단계에서 미리보기 및 테스트 탭을 사용하여 속성이 채워지는지 확인합니다. 그런 다음 사용자에게 테스트를 전송하고 속성이 고객 프로필에 저장되었는지 확인합니다.
• 422 오류(처리할 수 없는 엔터티): 앱 토큰과 임팩트 수량이 유효한지 확인합니다.
• 401 오류: 인증 토큰이 존재하고 올바른지 확인합니다.
• 메시지 단계에 이미지 미리보기가 표시되지 않는 경우: 사용자 업데이트 단계에서 사용자에게 테스트 보내기를 선택한 다음 동일한 사용자를 사용하여 메시지를 미리 봅니다.