브레이즈 투 브레이즈 웹훅

웹훅을 사용하여 Braze와 통신할 수 있습니다[REST API]2, 기본적으로 API가 허용하는 모든 작업을 수행할 수 있습니다. 우리는 이를 Braze에서 Braze로 통신하는 웹훅인 Braze-to-Braze 웹훅이라고 부릅니다.

전제 조건

Braze-to-Braze 웹훅을 만들려면 도달하려는 엔드포인트에 대한 권한이 있는 [API 키]3 ]가 필요합니다.

사용 사례

브레이즈 투 브레이즈 웹훅으로 할 수 있는 일은 많지만, 시작하기 위한 몇 가지 일반적인 사용 사례는 다음과 같습니다:

• 사용자가 메시지를 수신할 때 카운터에 대한 정수 사용자 지정 속성을 증가시킵니다.
• 초기 캔버스에서 두 번째 캔버스를 트리거합니다.

이 페이지의 사용 사례는 [웹훅의 작동 방식]4 ]과 [Braze에서 웹훅(]5 )을 만드는 방법]에 이미 익숙하다고 가정합니다.

Braze-to-Braze 웹훅을 만드는 단계

웹훅 요청의 세부 사항은 사용 사례마다 다르지만, Braze-to-Braze 웹훅을 만드는 일반적인 워크플로우는 동일하게 유지됩니다.

1. [캠페인 또는 캔버스 컴포넌트로 웹훅]5 을 만듭니다.
2. 빈 템플릿을 선택합니다.
3. 작성 탭에서 사용 사례에 명시된 대로 웹훅 URL과 요청 본문을 지정합니다.
4. 설정 탭에서 사용 사례에 명시된 대로 HTTP 메서드 및 요청 헤더를 지정합니다.
5. 필요에 따라 나머지 웹훅을 계속 구축하세요. 일부 사용 사례에는 사용자 지정 이벤트에서 캠페인 또는 캔버스를 트리거하는 것과 같은 특정 전달 설정이 필요합니다.

사용 사례: 카운터의 정수 사용자 지정 속성을 증가시킵니다.

이 사용 사례는 사용자 지정 속성을 생성하고 Liquid를 사용하여 특정 작업이 발생한 횟수를 계산하는 것입니다.

예를 들어, 사용자가 활성 인앱 메시지 캠페인을 본 횟수를 계산하여 세 번 본 후에는 다시는 캠페인을 수신하지 못하도록 할 수 있습니다. Braze에서 Liquid 로직으로 수행할 수 있는 작업에 대한 더 많은 아이디어는 Liquid 사용 사례 라이브러리에서 확인하세요.

Braze-to-Braze 웹훅을 만드는 일반적인 단계를 따르고, 웹훅을 구성할 때 다음을 참조하세요:

• 웹훅 URL: REST 엔드포인트 URL]7 다음에 /users/track. 예를 들어 US-06 인스턴스의 경우 URL은 https://rest.iad-06.braze.com/users/track 입니다.
• 요청 본문: 원시 텍스트

요청 헤더 및 방법

Braze는 인증을 위해 API 키가 포함된 HTTP 헤더와 content-type 을 선언하는 헤더가 필요합니다.

• 요청 헤더:
  • 권한 부여: 무기명 {YOUR_API_KEY}
  • 콘텐츠 유형: 애플리케이션/json
• HTTP 메서드: POST

YOUR_API_KEY 을 users.track 권한이 있는 Braze API 키로 바꿉니다. Braze 대시보드의 설정 > API 키에서 API 키를 생성할 수 있습니다.

요청 본문

요청 본문에 사용자 추적 요청을 추가하고 Liquid에 카운터 변수를 할당합니다. 자세한 내용은 [사용자 트랙]8 을 참조하세요.

다음은 이 엔드포인트에 필요한 Liquid와 요청 본문의 예시이며, 여기서 your_attribute_count 은 사용자가 메시지를 본 횟수를 계산하는 데 사용하는 속성입니다:

1
2
3
4
5
6
7
8
9
{% assign new_number = {{custom_attribute.${your_attribute_count}}} | plus: 1 %}
{
    "attributes": [
        {
        "external_id": "{{${user_id}}}",
        "your_attribute_count": "{{new_number}}"
        }
    ]
}

사용 사례: 초기 캔버스에서 두 번째 캔버스 트리거하기

이 사용 사례에서는 두 개의 캔버스를 만들고 웹훅을 사용하여 첫 번째 캔버스에서 두 번째 캔버스를 트리거합니다. 이는 사용자가 다른 캔버스에서 특정 지점에 도달할 때 항목 트리거처럼 작동합니다.

1. 첫 번째 캔버스에 의해 트리거되어야 하는 두 번째 캔버스를 만드는 것으로 시작하세요.
2. 캔버스 입력 일정의 경우 API 트리거됨을 선택합니다.
3. Canvas ID를 기록해 두세요. 나중 단계에서 이 정보가 필요합니다.
4. 두 번째 캔버스의 단계를 계속 구축한 다음 캔버스를 저장합니다.
5. 마지막으로 첫 번째 캔버스를 만듭니다. 두 번째 캔버스를 트리거할 단계를 찾아 웹훅을 사용하여 새 단계를 만듭니다.

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

• 웹훅 URL: REST 엔드포인트 URL]7 다음에 canvas/trigger/send. 예를 들어 US-06 인스턴스의 경우 URL은 https://rest.iad-06.braze.com/canvas/trigger/send 입니다.
• 요청 본문: 원시 텍스트

요청 헤더 및 방법

Braze는 인증을 위해 API 키가 포함된 HTTP 헤더와 content-type 을 선언하는 헤더가 필요합니다.

• 요청 헤더:
  • 권한 부여: 무기명 YOUR_API_KEY
  • 콘텐츠 유형: 애플리케이션/json
• HTTP 메서드: POST

YOUR_API_KEY 을 canvas.trigger.send 권한이 있는 Braze API 키로 바꿉니다. Braze 대시보드의 설정 > API 키에서 API 키를 생성할 수 있습니다.

요청 본문

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

1
2
3
4
5
6
7
8
{
      "canvas_id": "your_canvas_id",
      "recipients": [
        {
          "external_user_id": "{{${user_id}}}"
         }
      ]
}

알아두어야 할 사항

• Braze-to-Braze 웹훅에는 엔드포인트 속도 제한이 적용됩니다.
• 사용자 프로필을 업데이트하면 추가 데이터 포인트가 발생하지만 메시징 엔드포인트를 통해 다른 메시지를 트리거하는 것은 그렇지 않습니다.
• 익명 사용자를 타겟팅하려면 웹훅의 요청 본문에 external_id 대신 braze_id 을 사용하면 됩니다.
• Braze-to-Braze 웹훅을 템플릿으로 저장하여 다시 사용할 수 있습니다.
• 메시지 활동 로그를 확인하여 웹훅 오류를 확인하고 문제를 해결할 수 있습니다.