시간 제한 알림 설정

Apigee Edge 문서입니다.
Go to the Apigee X 문서로 이동합니다. info

소개

Monetization Limits Check 정책을 사용하여 수익 창출 한도 적용에 설명된 대로 수익 창출 관련 한도를 설정할 수 있습니다. 한도에 근접하거나 한도에 도달하면 개발자 또는 조직의 사용자에게 알리는 자동 알림을 설정할 수도 있습니다.

커스텀 한도와 암시적 한도에 대해 자동 알림을 설정할 수 있습니다. 예를 들어 시스템은 선불 개발자를 위한 암시적 한도(선불 잔액)를 설정합니다. 개발자가 선불 잔액에 근접하거나 선불 잔액에 도달하면 알림을 받도록 자동 알림을 설정할 수 있습니다.

도구 상자

관리 UI 또는 수익 창출 API를 사용하여 한도에 대한 자동 알림을 설정할 수 있습니다. UI를 사용하는 경우 알림 페이지에서 자동 알림을 설정합니다.

API를 사용하는 경우 수익 창출에서 제공하는 알림 템플릿을 수정하여 한도에 대한 자동 알림을 설정합니다. 그런 다음 수정된 템플릿에서 제공하는 알림을 전송하는 조건을 지정합니다.

UI를 사용하여 한도 알림 설정

  1. 한도 추가 페이지의 알림 섹션에서 추가를 클릭합니다. 그러면 알림 섹션이 열립니다.

  2. 알림 수준을 선택합니다. 이는 한도 기준의 절대 수 또는 백분율을 기반으로 하는 임곗값입니다. 다음 중 하나를 선택합니다.
    • 드롭다운 메뉴에서 크거나 같음 기호 (?) 또는 작거나 같음 기호 (?)
    • 정수 (즉, 소수점 없음) 절대값(숫자 값 표시) 또는 백분율(백분율 값 표시) 백분율 한도의 경우 항상 한도를 >로 설정해야 합니다. 즉, 개발자가 해당 백분율 수준에 도달하거나 초과하면 알림이 전송됩니다.

    예를 들어 지출 한도를 $100로 설정하고 알림을 90% 이상으로 설정하면 한도의 90%($90)에 도달하거나 초과할 때 알림이 전송됩니다.

  3. 이메일 보내기 필드에서 하나 이상의 개발자를 선택하거나 조직의 하나 이상의 사용자를 선택합니다. 정책 변경으로 영향을 받는 개발자 또는 사용자에게 알림이 전송됩니다.

    이메일 수신자: '모든' 개발자 한도 조건을 설정하거나 특정 개발자로 개발자 한도 조건을 설정한 경우에만 개발자에게 알림을 보낼 수 있습니다. '모든'을 선택한 경우 이메일 주소 목록에 이메일 주소 목록에 '선택한 개발자 (모든)'가 표시됩니다. 즉, 수익 창출에서 정책 변경으로 영향을 받는 모든 개발자에게 알림을 전송합니다. 특정 개발자를 선택한 경우 이메일 주소 목록에 '선택한 개발자 ({developer_id})'가 표시됩니다 ({developer_id}는 선택한 개발자의 식별자임). 수익 창출 에서 해당 특정 개발자에게만 알림을 전송합니다.

    '모든' 개발자 한도 조건 또는 특정 개발자를 선택하지 않은 경우 이메일 보내기 필드에 '선택한 개발자 (모든)'가 표시되지 않습니다. 하지만 알림을 보낼 조직의 사용자를 선택할 수 있습니다.

    관리 탭에서 조직 사용자를 선택하여 조직 사용자의 이메일 주소를 추가할 수 있습니다.

    이메일 템플릿: 이메일 보내기 필드에서 '선택한 개발자 (모든)' 또는 조직 사용자의 이메일 주소 (또는 둘 다)를 선택하면 이메일 템플릿이 표시됩니다. 템플릿에 표시되는 내용은 다음에 따라 달라집니다.

    • 알림 수준
    • 한도가 실행 중지 한도인지 여부
    • 이메일이 조직 사용자, 개발자 또는 둘 다를 위한 것인지 여부

    예를 들어 다음이 모두 참인 경우

    • 실행 중지 체크박스가 선택되어 있습니다.
    • 알림 수준이 100% 이거나 한도와 동일한 금액입니다.
    • 이메일은 조직 사용자 전용입니다.

    템플릿은 다음과 같습니다.

    개발자의 회사 이름이 "XYZ 회사"이고, 거래량 한도가 'X 패키지'라는 API 패키지와 'Y 제품'이라는 API 제품에 대해 50으로 설정되어 있으며, 만료일이 2013년 9월 30일로 설정되어 있다고 가정해 보겠습니다. 전송되는 이메일 메시지는 다음과 같습니다. 

    Developer XYZ company has exceeded their transaction volume limit of 50 transactions for X package, Y product. Their API calls will be blocked till 2013-09-30

    이메일이 '선택한 개발자 (모든)'에게 전송되는 경우 템플릿은 다음과 같이 표시됩니다.

    두 템플릿 모두 개발자 이름 (해당하는 경우), 패키지 이름 (해당하는 경우), 제품 이름 (해당하는 경우)과 같은 관련 변수를 확인합니다. 템플릿 왼쪽에 있는 수정을 클릭하여 요구사항에 맞게 메시지를 수정할 수 있습니다.

    한도가 "모든" 또는 특정 애플리케이션과 "모든" 또는 특정 사용자를 위한 경우 애플리케이션 및 사용자의 변수를 템플릿에 추가해야 합니다. 다음과 같이 할 수 있습니다.

    • 템플릿 왼쪽에 있는 수정을 클릭합니다.
    • ${user.name} user, depending on whether the limit is for application and/or user. 추가

    '모든' 또는 특정 애플리케이션에 맞게 수정된 템플릿이 아래에 표시됩니다.

    실행 중지가 선택되어 있지 않거나 알림 수준이 100% 이상인 경우 선택한 개발자의 템플릿은 다음과 같습니다.

    다시 말하지만 한도가 "모든" (또는 특정) 애플리케이션 또는 "모든" (또는 특정) 사용자를 위한 경우 템플릿을 수정한 후 ${application.name} 애플리케이션 및/또는 ${user.name} 사용자를 추가해야 합니다. 한도가 애플리케이션, 사용자 또는 둘 다를 위한 것인지에 따라 달라집니다.

    템플릿 변수: 이메일 템플릿에서 메시지를 수정할 때 다음 변수를 포함할 수 있습니다.

    변수 설명
    ${developer.name}

    개발자의 이름입니다.
    ${developer.legalName}

    개발자 회사의 이름입니다.
    ${ratePlan.monetizationPackage.displayName}

    API 패키지의 이름입니다.
    ${application.name}

    앱의 이름입니다.
    ${USER}

    사용자의 이름입니다.
    ${USAGE}

    현재 사용량 (총 수익 또는 요금 또는 거래량)
    ${PERCENT}

    현재 사용량으로 도달한 한도의 백분율입니다.
    ${QUOTA_TYPE}

    한도 유형 (거래량, 지출 한도 또는 수수료 노출)
    ${QUOTA_UNIT}

    한도의 기본 단위: 통화 (지출 한도의 경우) 또는 호출 (거래 한도의 경우)
    ${QUOTA_LIMIT}

    한도 금액입니다.
    ${EXPIRY_DATE}

    한도가 만료되는 날짜 또는 시간 또는 재설정되는 날짜 또는 시간입니다.

    예를 들어 개발자가 애플리케이션의 패키지에 대한 거래량의 특정 백분율에 도달하면 알림을 받으려면 템플릿을 다음과 같이 수정하면 됩니다.

    ${developer.legalName} has reached a total volume of ${USAGE} on ${ratePlan.monetizationPackage.displayName}. This is ${PERCENT} of the daily/weekly/monthly (state period of limit as appropriate) transaction volume limit of ${QUOTA_LIMIT}.
  4. 필요에 따라 추가 수준에 대한 알림을 추가합니다. 각 추가 수준에 대해 추가를 클릭합니다. 그러면 페이지의 알림 섹션에 수준, 이메일 보내기, 이메일 템플릿 영역이 추가됩니다. 알림에 최대 6개의 수준을 추가할 수 있습니다. 예를 들어 알림을 70%, 80%, 90%, 100% 이상으로 설정하면 이러한 각 수준에 도달할 때 알림이 전송됩니다.
  5. 모든 알림을 추가한 후 저장 (나중에 알림을 저장하고 게시 ) 또는 저장 및 게시 (지금 게시) 또는 취소 (취소)를 클릭합니다.

API를 사용하여 한도 알림 설정

수익 창출에서는 한도 알림과 새 제품의 가용성에 대해 개발자에게 알리는 것과 같은 임시 알림을 비롯한 다양한 유형의 알림에 대한 텍스트를 제공하는 템플릿 집합을 제공합니다. 이러한 템플릿을 필요에 맞게 조정할 수 있습니다. 자동 한도 알림을 설정하려면 먼저 적절한 템플릿을 수정합니다. 그런 다음 수정된 템플릿에서 제공하는 알림을 전송하는 조건을 지정합니다. 자세한 내용은 알림 템플릿을 사용하여 알림 설정을 참고하세요.

다음 단계

새 제품, 새로운 버전의 서비스 약관 또는 새로운 요금제와 같은 이벤트에 대해 개발자에게 알릴 수 있도록 자동 알림을 설정하는 방법을 알아보세요. 알림 템플릿을 사용하여 알림 설정을 참고하세요.