이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.

API 캠페인

이 참조 문서에서는 API 호출에 포함할 campaign_id를 생성하는 방법과 해당 캠페인을 구성하는 방법에 대해 설명합니다.

API 캠페인은 일반적으로 트랜잭션 메시징에 사용됩니다. API 캠페인(API 트리거 캠페인이 아닌)을 생성할 때, Braze 대시보드는 캠페인 보고를 위한 분석을 추적할 수 있는 campaign_id를 생성하는 데만 사용됩니다. 캠페인의 각 배리언트마다 다른 메시지 배리언트 ID를 생성할 수도 있습니다.

그런 다음 해당 정보를 개발팀에 전달하여 API 요청에 사용할 수 있도록 합니다. 전달할 정보는 다음과 같습니다.

캠페인 카피
오디언스 멤버십
자산

캠페인이 시작되면 대시보드에서 결과를 확인할 수 있습니다. API 캠페인은 대시보드를 통해 완전히 생성된 캠페인과 동일한 세부 보고 및 리타겟팅 옵션이 있는 Braze 메시징 API를 사용합니다.

API 캠페인에는 항상 campaign_id가 포함되므로 해당 발송은 대시보드 통계에 반영됩니다. campaign_id 없이 /messages/send를 호출하면 Braze는 해당 측정기준을 증가시키지 않습니다. 발송은 여전히 메시지 활동 로그에 표시되지만, 대시보드의 이메일 성능 측정기준에는 표시되지 않습니다.

경고

API 캠페인은 일반적으로 트랜잭션이므로 글로벌 컨트롤 그룹에 속한 사용자를 포함하여 모든 사용자가 API 캠페인을 수신할 수 있습니다. 이러한 발송에는 기본적으로 원클릭 목록 수신 거부 헤더가 추가되지 않습니다. API 캠페인에 원클릭 목록 수신 거부 헤더를 추가하려면 API 캠페인에 원클릭 목록 수신 거부 추가를 참조하세요. 모든 API 캠페인에 원클릭 목록 수신 거부 헤더를 추가하려면 고객 성공 매니저에게 문의하세요.

새 Campaign 만들기

메시징 > Campaigns로 이동하여 Campaign 만들기를 선택한 다음 API Campaigns를 선택합니다. 이제 API Campaign 구성을 진행할 수 있습니다.

API 트리거 Campaign은 API Campaign과 다릅니다.

Campaign 구성하기

Campaign을 구성하려면 다음 단계를 수행합니다:

메시지를 보낸 후 Campaigns 페이지에서 결과를 찾을 수 있도록 설명이 포함된 제목을 추가합니다.
Add Message를 선택하고 API Campaign에 포함할 메시지 유형을 추가합니다. 이렇게 하면 campaign_id와 메시지 배리언트 ID가 생성되며, 이 ID는 포함하는 각 채널마다 다릅니다.
선택 사항으로, 특정 액션이나 Campaign 목표에 대한 사용자 전환을 추적하기 위해 전환 이벤트를 추가할 수 있습니다.
Save Campaign을 선택하여 API Campaign을 시작합니다.

API 호출

API Campaign을 저장한 후, API 요청에 다음을 포함하세요:

메시지 전송 엔드포인트에 명시된 대로 API 요청에 생성된 campaign_id 필드를 포함합니다.
Campaign에 포함된 각 플랫폼에 대한 메시지 오브젝트를 포함합니다. 메시지 오브젝트에서 메시지 배리언트 ID를 제공하세요. 이렇게 하면 해당 배리언트 아래에 통계가 수집되고 표시됩니다. 지원되는 메시지 오브젝트는 Android, Content Cards, 이메일, iOS, Kindle, SMS/MMS, 웹 푸시, 웹훅입니다.

API Campaigns에 원클릭 목록 수신 거부 추가

기본적으로 Braze는 API Campaigns에 원클릭 목록 수신 거부 헤더를 추가하지 않습니다. API Campaign 발송 시 이메일 헤더 필드에 {{${set_user_to_one_click_list_unsubscribe}}} Liquid 태그를 포함하면 개별 API Campaign 발송에 이 헤더를 추가할 수 있습니다.

원클릭 목록 수신 거부에 대한 RFC 8058 규정을 준수하려면 API 요청에 List-Unsubscribe 및 List-Unsubscribe-Post 헤더를 모두 포함하세요:

{
  "external_user_ids": ["user_id"],
  "messages": {
    "email": {
      "app_id": "your_app_id",
      "subject": "Your Subject",
      "from": "Sender Name <[email protected]>",
      "body": "<p>Email body content</p>",
      "headers": {
        "List-Unsubscribe": "<{{${set_user_to_one_click_list_unsubscribe}}}>",
        "List-Unsubscribe-Post": "List-Unsubscribe=One-Click"
      }
    }
  }
}

참고

이러한 헤더를 포함한다고 해서 이메일 클라이언트에 수신 거부 버튼이 반드시 표시되는 것은 아닙니다. 이메일 클라이언트는 발송자 평판 및 메시지 콘텐츠와 같은 요소를 기반으로 수신 거부 옵션 표시 여부를 결정합니다.

이메일 첨부 파일 추가

API Campaign 이메일에 첨부 파일을 추가하려면 이메일 오브젝트에 attachments 배열을 포함하세요. 이메일 오브젝트에 email_template_id를 제공하여 드래그 앤 드롭 또는 HTML 에디터에서 생성한 이메일 템플릿을 참조한 다음, API 호출을 통해 첨부 파일을 추가할 수 있습니다.

첨부 파일 세부 정보, 크기 제한 및 모범 사례에 대해서는 첨부 파일이 포함된 이메일 오브젝트 예시를 참조하세요.

New Stuff!