API 트리거 전달
API 트리거 캠페인 또는 서버 트리거 캠페인은 보다 고급 트랜잭션 사용 사례에 적합합니다. Braze API 트리거 캠페인을 사용하면 마케터가 Braze 대시보드 내에서 캠페인 문구, 다변량 테스트 및 재자격 규칙을 관리하면서 자체 서버와 시스템에서 해당 콘텐츠의 전달을 트리거할 수 있습니다. 메시지를 트리거하는 API 요청에는 실시간으로 메시지에 템플릿화할 추가 데이터도 포함할 수 있습니다.
API 트리거 Campaign 설정하기
API 트리거 Campaign을 설정하려면 몇 가지 단계가 필요합니다. 먼저 다변량 테스트를 포함하는 멀티채널 또는 단일 채널 Campaign을 새로 만듭니다.
다음으로, 예약된 알림과 동일한 방식으로 문구 및 알림을 구성하고 API-Triggered Delivery를 선택합니다. 서버에서 이러한 Campaign을 트리거하는 방법에 대한 자세한 내용은 API 트리거 Campaign 전송 문서를 참조하세요.
API 트리거와 발송 사이의 지연 줄이기
트리거 엔드포인트를 호출한 후 메시지 발송이 예상보다 오래 걸리는 경우, 트리거 시점에 고객 프로필이 준비되어 있는지 확인하세요.
기본적으로 /campaigns/trigger/send에서 send_to_existing_only는 true로 설정되어 있습니다. Braze는 기존 사용자에게만 발송하며, 해당 호출에서 신규 프로필을 생성하지 않습니다. 사용자를 생성하거나 업데이트하면서 동일한 요청으로 발송하려면, send_to_existing_only를 false로 설정하고 각 수신자에 attributes 객체를 포함하세요.
이메일 Campaigns의 경우, attributes 내에 email(및 기타 필수 전달 필드)도 포함하세요. 발송을 트리거할 때 프로필에 이메일 주소가 없으면, Braze는 프로필 데이터가 도착할 때까지 최대 약 2시간 동안 재시도합니다. 동일한 호출에 email을 포함하면 이러한 지연을 방지할 수 있습니다.
전체 요청 파라미터, 예시 및 재시도 동작에 대한 자세한 내용은 API 트리거 Campaigns 발송 및 수신자 객체를 참조하세요.
이 안내는 API 트리거 Campaigns(/campaigns/trigger/send)에 적용됩니다. 트랜잭션 이메일 엔드포인트는 다른 요청 형식(recipient, 단수)을 사용하며 send_to_existing_only를 지원하지 않습니다. 트랜잭션 발송과 함께 사용자를 인라인으로 생성하려면, recipient 객체에 attributes를 전달하세요.
API 요청에 포함된 템플릿 콘텐츠 사용
메시지를 트리거하는 것 외에도, API 요청에 콘텐츠를 포함하여 trigger_properties 객체 내에서 메시지에 템플릿으로 적용할 수 있습니다. 이 콘텐츠는 메시지 본문에서 참조할 수 있습니다.
trigger_properties 및 메시지 카피에서 Liquid 태그당 정확히 두 개의 중괄호를 사용하세요. 예를 들면 다음과 같습니다: {{api_trigger_properties.${your_property}}}. 추가 { 또는 }는 API 트리거 개인화 실패의 일반적인 원인입니다.
추가 맥락은 다음 소셜 알림 예시를 참조하세요.
API 트리거 Campaigns의 재자격
사용자가 API 트리거 Campaign을 수신하는 횟수는 재자격 설정을 통해 제한할 수 있습니다. 즉, API 트리거가 몇 번 실행되든 관계없이 사용자는 해당 Campaign을 한 번만 또는 지정된 기간 내에 한 번만 수신합니다.
예를 들어, API 트리거 Campaign을 사용하여 사용자가 최근에 본 상품에 대한 Campaign을 보내고 있다고 가정해 보겠습니다. 이 경우, 각 상품에 대해 API 트리거를 실행하더라도 조회한 상품 수에 관계없이 하루에 최대 하나의 메시지만 보내도록 Campaign을 제한할 수 있습니다. API 트리거 Campaign이 트랜잭션 성격인 경우, 지연 시간을 0분으로 설정하여 사용자가 트랜잭션을 수행할 때마다 Campaign을 수신하도록 해야 합니다.
