수익 창출 문제 해결

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보

이 주제에서는 흔히 관찰되는 수익 창출 문제의 해결에 대한 정보와 안내를 제공합니다.

개발자 정지됨

증상

개발자가 정지되었으며 수익 창출 거래/API를 추가로 호출할 수 없습니다.

오류 메시지

<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>

진단

개발자가 정지된 이유를 확인하려면 다음 단계를 따르세요.

  1. 다음 API 호출을 실행하여 정지된 개발자와 관련된 오류 코드를 식별합니다.
    1. 퍼블릭 클라우드 사용자인 경우 아래 API를 사용하세요. 
      curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
    2. 프라이빗 클라우드 사용자인 경우 아래 API를 사용하세요. 
      curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password
  2. 오류 코드를 다음 이유 코드와 비교하여 개발자가 정지된 이유를 확인합니다.

참고: 정지된 개발자의 이유 코드 요약

이유 코드

원인

세부정보

INSUFFICIENT_FUNDS

개발자 계정 잔액이 소진됨

선불 개발자 계정 잔액이 추가 거래를 위한 충분한 금액이 없는 경우 개발자는 정지됩니다.

후불 개발자의 경우 신용 한도를 초과하거나 사용된 통화에 설정된 신용 한도가 소진되면 이 오류가 발생할 수 있습니다.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED

개발자가 더 이상 거래를 할 수 없음

모든 개발자는 구매한 요금제에 따라 고정된 횟수의 트랜잭션을 실행할 수 있습니다. 트랜잭션 수가 초과되면 개발자가 정지되고 추가 거래를 완료할 수 없습니다.

NO_CURRENT_PUBLISHABLE_ENTITY

개발자가 구매한 요금제가 없음

개발자는 거래를 완료하기 전에 요금제를 구매해야 합니다.

해상도

오류

해결 단계

INSUFFICIENT_FUNDS

개발자는 추가 거래를 완료하려면 계정 잔액이 충분한지 또는 사용 가능한 크레딧이 있는지 확인해야 합니다.

LIMIT_VIOLATED

RATE_PLAN_RATE_BAND_EXCEEDED
  1. 다음 API를 호출하여 각각 개발자 요금제 및 거래 세부정보를 가져옵니다.
    • 다음 API 호출을 실행하여 개발자가 구매한 요금제의 시작일과 종료일을 가져옵니다. 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/developers/%7Bdeveloper_id%7D/developer-accepted-rateplans
    • 다음 API 호출을 실행하여 개발자의 성공적인 트랜잭션 수를 가져옵니다. 
      http://docs.apigee.com/monetize/apis/get/organizations/%7Borg_name%7D/transactions/developers/%7Bdeveloper_email_or_id%7D

  2. Edge UI에서 다음을 선택하여 개발자가 허용할 수 있는 호출 수를 확인할 수도 있습니다.

    패키지 > 패키지 이름 > 요율표 이름 > 요율표

    예를 들어 패키지 이름이 Pro Package이고 무료 요금제인 경우 경로는 다음과 같습니다.

    패키지 > Pro 패키지 > 무료 요금제 > 요율표

NO_CURRENT_PUBLISHABLE_ENTITY

개발자가 API를 호출하려면 요금제를 구매해야 합니다.

수익 창출 설정 문제

증상

수익 창출 설정 문제는 다음과 같은 여러 증상으로 나타날 수 있습니다.

  • 웹훅 기능이 작동하지 않음
  • 웹훅을 만들 수 없습니다.
  • 웹훅 알림이 트리거되지 않음
  • 수익 창출 보고서에 거래가 표시되지 않습니다. 예를 들어 애널리틱스 데이터에는 개발자가 특정 기간에 많은 거래를 완료했음을 나타내지만 수익 창출 보고서에는 이러한 거래가 표시되지 않습니다.
  • 거래가 기록되지 않음

오류 메시지

오류 메시지가 표시되지 않을 수도 있지만 증상 섹션에 설명된 대로 문제가 표시됩니다.

가능한 원인

증상에 나타난 증상이 있다면 거래에서 수익이 창출되지 않고 있을 가능성이 매우 높습니다.

원인 진단

  1. 다음 섹션에 설명된 관리 API 호출을 사용하여 거래에서 수익이 창출되고 있는지 확인합니다.

    거래 상태 보기

  2. 지정된 기간 내에 거래가 SUCCESS로 표시되지 않으면 거래로 수익이 창출되지 않는 것입니다.

거래에서 수익이 창출되지 않는 일반적인 원인은 다음과 같습니다.

다음 섹션에서는 각 문제를 진단하고 해결하는 방법을 설명합니다.

수익 창출 한도 확인 정책이 API 프록시에 사용되지 않음

진단

  1. 수익 창출 한도 확인 정책이 API 프록시에 연결되어 있는지 확인합니다.
  2. 정책이 연결되어 있지 않으면 트랜잭션이 FAILED로 표시되는 이유일 수 있습니다.

해상도

API 프록시에 수익 창출 한도 적용에 설명된 대로 수익 창출 한도 확인 정책을 필수 API 프록시에 연결합니다.

문제가 지속되면 API 제품으로 수익을 창출하지 않음을 선택합니다.

API 제품으로 수익이 창출되지 않음

진단

  1. API 제품으로 수익을 창출하고 있는지 확인합니다. 수익 창출이 설정된 API 제품만 평가되며 거래 아래에 표시됩니다. 수익 창출 제품은 하나 이상의 활성 요금제가 있는 제품입니다.
  2. 다음 관리 API 호출을 사용하여 수익 창출 API 제품 목록을 가져옵니다.
    1. 퍼블릭 클라우드 사용자인 경우 아래 API를 사용하세요. 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
    2. 프라이빗 클라우드 사용자인 경우 아래 API를 사용하세요. 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org_id}/products?monetized=true -u orgadminEmail:password
  3. API 프록시와 연결된 API 제품으로 수익이 창출되지 않는 경우 거래에서 수익이 창출되지 않기 때문일 수 있습니다.

해상도

API 제품으로 수익을 창출하려면 다음 단계를 따르세요.

  1. 트랜잭션 기록 정책 구성

  2. API 제품에 활성 요금제가 있는지 확인하세요.

문제가 지속되면 트랜잭션 기록 정책이 잘못 정의됨을 확인하세요.

거래 기록 정책이 잘못 정의됨

진단

  1. 수익 창출 한도 확인 정책이 연결된 API 프록시의 UI 트레이스를 사용 설정합니다.
  2. UI 트레이스에서 특정 API 요청을 선택합니다.
  3. 애널리틱스 AX 흐름을 선택하고 다음 수익 창출 (민트) 흐름 변수에 적절한 값이 있는지 확인합니다.
    mint.tx.status - Should match the value set up for "success criteria" in the transaction recording policy for the API product being used. When tracing, the txProviderStatus in the transaction recording policy is stored in the variable 'mint.tx.status'.
mint.tx.app_id - Application id of API product.
mint.tx.prod_id - API product id.

  4. 다음은 Mint 흐름 변수가 올바르게 설정되었음을 보여주는 샘플 UI 트레이스입니다.

  5. mint.tx.status 변수에 오류가 표시되면 거래 기록 정책이 잘못 정의되었음을 나타냅니다.

해상도

  1. 트랜잭션 기록 정책을 만드는 동안 트랜잭션 기록 정책 만들기에 설명된 모든 단계를 올바르게 따랐는지 확인합니다.
  2. 키 값은 거래 기록 정책에 설정된 '거래 성공 기준'입니다. 거래 기록 정책에서 거래 성공 기준을 설정하는 예를 참고하세요.

개발자가 요금제를 구매하지 않음

진단

  1. 다음 관리 API 호출을 사용하여 개발자가 구매한 요금제를 확인합니다.
    1. 퍼블릭 클라우드 사용자인 경우 아래 API를 사용하세요. 
      curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
    2. Private Cloud 사용자인 경우 아래 API를 사용하세요. 
      curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password
  2. 위 호출의 응답에 따라 개발자가 거래를 완료했을 때 활성 상태였던 요금제를 찾습니다.

해상도

개발자는 요구사항에 따라 요금제를 구매한 다음 트랜잭션/API를 실행해야 합니다.

문제가 계속되면 Apigee Edge 지원팀에 문의하세요.