이 페이지는 AI로 자동 번역되었으며 부정확한 내용이 포함될 수 있습니다. 번역 오류를 신고하려면 페이지 오른쪽 목차 아래에 있는 피드백 기능을 사용하세요.
이메일 구독 상태 변경
이 엔드포인트를 사용하여 사용자의 글로벌 이메일 구독 상태를 설정할 수 있습니다.
사용자는 opted_in, unsubscribed 또는 subscribed(명시적으로 옵트인 또는 옵트아웃하지 않은 상태)일 수 있습니다.
참고
이 엔드포인트는 사용자의 글로벌 이메일 구독 상태를 업데이트하며, 이는 구독 그룹 상태와 다릅니다. 글로벌 구독 상태는 모든 이메일에 적용되는 반면, 구독 그룹을 사용하면 특정 유형의 이메일을 더 세밀하게 제어할 수 있습니다. 사용자가 글로벌 탈퇴 상태인 경우, 구독 그룹 상태와 관계없이 이메일을 수신하지 않습니다. 구독 그룹 상태를 쿼리하려면 사용자의 구독 그룹 상태 목록 엔드포인트를 사용하세요.
Braze 내에서 아직 사용자와 연결되지 않은 이메일 주소의 이메일 구독 상태를 설정할 수 있습니다. 나중에 해당 이메일 주소가 사용자와 연결되면 업로드한 이메일 구독 상태가 자동으로 설정됩니다.
필수 조건
이 엔드포인트를 사용하려면 email.status 권한이 있는 API 키가 필요합니다.
사용량 제한
이 엔드포인트에는 API 사용량 제한에 명시된 대로 기본 Braze 사용량 제한인 시간당 250,000건의 요청이 적용됩니다.
요청 본문
1
2
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
1
2
3
4
{
"email": "[email protected]",
"subscription_state": "subscribed"
}
요청 매개변수
| 매개변수 | 필수 | 데이터 유형 | 설명 |
|---|---|---|---|
email |
필수 | 문자열 또는 배열 | 수정할 이메일 주소를 문자열로 입력하거나, 수정할 이메일 주소를 최대 50개까지 배열로 입력할 수 있습니다. |
subscription_state |
필수 | 문자열 | “subscribed”, “unsubscribed” 또는 “opted_in” 중 하나입니다. |
SendGrid 이메일 차단 문제 해결
SendGrid가 수신자를 차단하는 경우, 이 엔드포인트를 사용하여 구독 상태를 업데이트하고 세그먼트 필터로 인게이지먼트를 검토하세요. 전달 가능성 모니터링을 위해 Currents 소프트 반송 이벤트를 활용하고, 재발송 전에 구독 상태를 확인하세요.
요청 예시
1
2
3
4
5
6
7
curl --location --request POST 'https://rest.iad-01.braze.com/email/status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-API-KEY-HERE' \
--data-raw '{
"email": "[email protected]",
"subscription_state": "subscribed"
}'
New Stuff!