Skip to content

Braze-to-Braze 웹훅 생성

Braze-to-Braze 웹훅을 사용하면 Campaign 또는 Canvas의 웹훅을 통해 Braze 내에서 Braze REST API를 호출할 수 있습니다. API 트리거 Canvas를 트리거하는 등의 오케스트레이션 작업에 활용할 수 있습니다. Canvas에서 사용자 속성, 커스텀 이벤트 또는 구매를 업데이트하려면 대신 사용자 업데이트를 사용하세요. 사용자 업데이트는 고객 프로필 변경에 최적화되어 있으며 업데이트를 더 효율적으로 처리합니다.

이 문서를 최대한 활용하려면 웹훅의 작동 방식과 Braze에서 웹훅을 생성하는 방법에 익숙해야 합니다.

다른 Canvas를 트리거하기 위해 목적지로 보내기 사용

Canvas 내에서 두 번째 Canvas를 트리거하려면 Braze-to-Braze 웹훅 대신 목적지로 보내기를 사용하세요. 이 캔버스 구성 요소는 Canvas 여정을 연결하기 위해 특별히 설계되었으며, 웹훅 구성이나 API 키 없이 사용자를 한 Canvas에서 다른 Canvas로 보내는 더 간단하고 효율적인 방법을 제공합니다.

목적지로 보내기는 사용자가 해당 단계에 도달했을 때 대상 Canvas의 진입 및 오디언스 기준에 따라 사용자를 평가하며, 웹훅 구성이나 API 키가 필요하지 않습니다. 기준을 충족하는 사용자는 대상 Canvas에 진입하며, 이후 추가 단계가 있는 경우 원래 Canvas에서 여정을 계속할 수 있습니다.

사용자 데이터 변경에는 사용자 업데이트를 사용하세요

Canvas 내에서 커스텀 속성 수정, 커스텀 이벤트 기록 또는 구매 기록 등 고객 프로필을 업데이트하려면 Braze 간 웹훅 대신 사용자 업데이트를 사용하세요.

사용자 업데이트는 여러 변경 사항을 하나로 묶어 일괄 전송하므로 웹훅보다 빠릅니다. 웹훅보다 설정이 간편하며 고급 JSON 작성기를 통해 복잡한 업데이트도 지원합니다. 예를 들어, 사용자가 메시지를 본 횟수를 기록하려면 Braze 간 웹훅 대신 사용자 업데이트의 증가 및 감소 기능을 사용하세요.

Braze 간 웹훅을 사용해야 하는 경우

사용자 업데이트는 사용자 프로필을 업데이트하는 데 있어 Braze 간 웹훅과 거의 동일한 작업을 처리할 수 있습니다. 단순한 커스텀 속성을 넘어서는 복잡한 업데이트의 경우 고급 JSON 작성기를 사용할 수 있습니다.

Send to Destination은 웹훅 구성 없이 Canvas 내에서 두 번째 Canvas를 트리거하는 더 간편한 방법을 제공합니다.

Braze 간 웹훅은 전용 캔버스 단계가 없는 시나리오에서 Braze 내부에서 Braze의 REST API를 호출해야 할 때 사용할 수 있습니다. 일반적인 예시는 다음과 같습니다:

Canvas 내에서 사용자를 업데이트하려면 사용자 업데이트를 사용하세요. 다른 Canvas를 트리거하려면 Send to Destination을 사용하세요.

사전 요구 사항

Braze-to-Braze 웹훅을 생성하려면 도달하려는 엔드포인트에 대한 권한이 있는 API 키가 필요합니다. 예를 들어, API 트리거 Canvas를 트리거하려면 canvas.trigger.send 권한이 있는 API 키가 필요합니다.

Braze-to-Braze 웹훅 설정하기

Braze-to-Braze 웹훅을 생성하는 일반적인 워크플로는 다음 단계를 따릅니다:

  1. Campaign 또는 캔버스 구성 요소로 웹훅을 생성합니다.
  2. 빈 템플릿을 선택합니다.
  3. 작성 탭에서 API 사용 사례에 맞게 웹훅 URL과 요청 본문을 지정합니다.
  4. 설정 탭에서 엔드포인트에서 요구하는 HTTP 메서드와 요청 헤더를 지정합니다.
  5. 추가 전달 설정(예: 커스텀 이벤트로 트리거)을 구성하고, 나머지 Campaign 또는 Canvas를 완성합니다.

초기 Canvas에서 두 번째 Canvas 트리거하기

이 사용 사례에서는 두 개의 Canvas를 생성하고 Braze-to-Braze 웹훅을 사용하여 첫 번째 Canvas에서 두 번째 Canvas를 트리거합니다. 이는 사용자가 다른 Canvas의 특정 지점에 도달했을 때 진입 트리거 역할을 합니다.

  1. 먼저 두 번째 Canvas, 즉 초기 Canvas에 의해 트리거될 Canvas를 생성합니다.
  2. Canvas 진입 스케줄에서 API 트리거를 선택합니다.
  3. Canvas ID를 기록해 둡니다. 이후 단계에서 필요합니다.
  4. 두 번째 Canvas의 단계를 계속 구성한 다음 Canvas를 저장합니다.
  5. 마지막으로, 첫 번째 Canvas를 생성합니다. 두 번째 Canvas를 트리거하려는 단계를 찾아 웹훅이 포함된 새 단계를 만듭니다.

웹훅을 구성할 때 다음을 참고하세요:

  • 웹훅 URL: REST 엔드포인트 URL 뒤에 /canvas/trigger/send를 추가합니다. 예를 들어, US-06 인스턴스의 경우 URL은 https://rest.iad-06.braze.com/canvas/trigger/send입니다.
  • 요청 본문: Raw Text

요청 헤더 및 메서드

Braze에서는 API 키를 포함하는 인증 HTTP 헤더와 콘텐츠-유형을 선언하는 헤더가 필요합니다.

  • 요청 헤더:
    • Authorization: Bearer YOUR_API_KEY
    • Content-Type: application/json
  • HTTP 메서드: POST

YOUR_API_KEY를 canvas.trigger.send 권한이 있는 Braze API 키로 교체하세요. Braze 대시보드에서 설정 > API 키로 이동하여 API 키를 생성할 수 있습니다.

Braze 대시보드에서 Authorization 및 Content-Type 필드를 보여주는 웹훅 요청 헤더.

요청 본문

텍스트 필드에 /canvas/trigger/send 요청을 추가합니다. 자세한 내용은 API 트리거 전달을 통한 Canvas 메시지 보내기를 참고하세요. 다음은 이 엔드포인트에 대한 요청 본문의 예시이며, your_canvas_id는 두 번째 Canvas의 Canvas ID입니다:

1
2
3
4
5
6
7
8

{
  "canvas_id": "your_canvas_id",
  "recipients": [
    {
      "external_user_id": "{{${user_id}}}"
    }
  ]
}

사용자가 첫 번째 Canvas에서 이 웹훅 단계에 도달하면, Braze는 API를 통해 해당 사용자에 대해 두 번째 Canvas를 트리거합니다.

고려 사항

  • 사용자 업데이트: Canvas에서 사용자 프로필을 업데이트(속성, 이벤트, 구매)하려면 Braze 간 웹훅 대신 사용자 업데이트를 사용하면 효율성과 비용 효과가 더 좋습니다.
  • Braze 간 웹훅에는 엔드포인트 사용량 제한이 적용됩니다.
  • 고객 프로필 업데이트 시 전체 소비량에 포함되는 데이터 포인트가 발생하지만, 메시징 엔드포인트를 통해 다른 메시지를 트리거하는 경우에는 발생하지 않습니다.
  • 익명 사용자를 타겟팅하려면 웹훅 요청 본문에서 external_id 대신 braze_id를 사용하세요.
  • Braze 간 웹훅을 웹훅 템플릿으로 저장하여 재사용할 수 있습니다.
  • 메시지 활동 로그에서 웹훅 실패를 확인하고 문제를 해결할 수 있습니다.
New Stuff!