Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

수익 창출 문제 해결

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

이 주제에서는 일반적으로 관찰되는 수익 창출 문제를 해결하는 방법에 관한 정보와 안내를 제공합니다.

개발자 정지됨

증상

개발자가 정지되어 추가 수익 창출 거래/API 호출을 할 수 없습니다.

오류 메시지

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

진단

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

다음 API 호출을 실행하여 정지된 개발자와 연결된 오류 코드를 식별합니다:

퍼블릭 클라우드 사용자인 경우 아래 API를 사용하세요.

curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

프라이빗 클라우드 사용자인 경우 아래 API를 사용하세요.

curl -X GET "http://<management-host>:<port#>/v1/mint/organizations/{org}/suspended-developers/{developer-email}" -u orgadminEmail:password

오류 코드를 다음 이유 코드와 비교하여 개발자가 정지된 이유를 확인합니다.

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

이유 코드	원인	세부정보
INSUFFICIENT_FUNDS	개발자 계정 잔액이 소진됨	선불 개발자 계정 잔액에 추가 거래를 할 수 있는 충분한 금액이 없는 경우 개발자가 정지됩니다. 후불 개발자의 경우 신용 한도를 초과하거나 사용된 통화에 설정된 신용 한도가 소진되면 이 오류가 발생할 수 있습니다.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	개발자가 추가 거래를 할 수 없음	모든 개발자는 구매한 요금제 를 기준으로 고정된 거래 수를 할 수 있습니다. 거래 수가 초과되면 개발자가 정지되고 추가 거래를 완료할 수 없습니다.
NO_CURRENT_PUBLISHABLE_ENTITY	개발자가 요금제를 구매하지 않음	개발자는 거래를 완료하기 전에 요금제를 구매해야 합니다.

해상도

오류	해결 단계
INSUFFICIENT_FUNDS	개발자는 추가 거래를 완료하기 위해 충분한 계정 잔액 또는 사용 가능한 신용 한도가 있는지 확인해야 합니다.
LIMIT_VIOLATED RATE_PLAN_RATE_BAND_EXCEEDED	다음 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 Edge UI에서 개발자가 할 수 있는 호출 수를 확인할 수도 있습니다. 패키지 > PackageName > RatePlanName > 요율표 예를 들어 패키지 이름이 Pro Package이고 무료 요금제인 경우 경로는 다음과 같습니다. 패키지 > Pro Package > 무료 요금제 > 요금 카드
NO_CURRENT_PUBLISHABLE_ENTITY	개발자는 API 호출을 할 수 있도록 요금제를 구매해야 합니다.

수익 창출 설정 문제

증상

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

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

오류 메시지

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

가능한 원인

증상에 나열된 증상이 표시되면 거래가 수익 창출되지 않을 가능성이 매우 높습니다.

원인 진단

다음 섹션에 설명된 Management API 호출을 사용하여 거래가 수익 창출되는지 확인합니다.

거래 상태 보기
지정된 기간 내에 성공 으로 나열된 거래가 표시되지 않으면 거래가 수익 창출되지 않은 것입니다.

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

수익 창출 한도 확인 정책이 API 프록시에 연결되지 않음
APIProduct가 수익 창출되지 않음
거래 기록 정책이 잘못 정의됨
개발자가 요금제를 구매하지 않음

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

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

진단

수익 창출 한도 확인 정책이 API 프록시에 연결되어 있는지 확인합니다.
정책이 연결되지 않은 경우 거래가 나열되는 이유일 수 있습니다. 실패

해상도

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

문제가 계속되면 API 제품이 수익 창출되지 않음을 확인하세요.

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

진단

API 제품이 수익 창출되는지 확인합니다 (수익 창출 API 제품만 평가되고 거래에 나열됨). 수익 창출 제품은 하나 이상의 활성 요금제 를 사용할 수 있는 제품입니다.
다음 Management 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
```
API 프록시와 연결된 API 제품이 수익 창출되지 않는 경우 거래가 수익 창출되지 않는 이유일 수 있습니다.

해상도

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

거래 기록 정책을 구성합니다.
API 제품에 활성 요금제가 있는지 확인합니다.

문제가 계속되면 거래 기록 정책이 잘못 정의됨을 확인하세요.

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

진단

수익 창출 한도 확인 정책이 연결된 API 프록시에 UI 추적을 사용 설정합니다.
UI 추적에서 특정 API 요청을 선택합니다.

애널리틱스 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.

다음은 민트 흐름 변수가 올바르게 설정되어 있음을 보여주는 샘플 UI 추적입니다.
mint.tx.status 변수에 오류가 관찰되면 거래 기록 정책이 잘못 정의된 것입니다.

해상도

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

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

진단

다음 Management API 호출을 사용하여 개발자가 구매한 요금제를 확인합니다.

퍼블릭 클라우드 사용자인 경우 아래 API를 사용하세요.

curl -v https://api.enterprise.apigee.com/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

프라이빗 클라우드 사용자인 경우 아래 API를 사용하세요.

curl -v http://<management-host>:<port#>/v1/mint/organizations/{org}/developers/{dev_email}/products/{prod}/developer-rateplans -u orgadminEmail:password

위 호출의 응답을 기반으로 개발자가 거래를 완료한 시점에 활성 상태였던 요금제를 찾습니다.

해상도

개발자는 요구사항에 따라 요금제를 구매한 후 거래/API를 실행해야 합니다.

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