요약: 인앱 구매 및 자동 갱신 구독으로 인한 수익을 자동으로 검증하고 측정하여 고객의 수명 주기에 대한 전체 이해와 정확한 ROAS 측정을 얻을 수 있습니다.
개요
광고주는 검증된 인앱 구매(IAP) 및 정기 결제 수익을 사용하여 다음을 측정할 수 있습니다.
- App Store Connect(iOS) 또는 Google Play Console(Android)을 통해 관리되는 제품 및 구독의 인앱 구매에서 발생하는 모든 수익.
- 환불.
- 대기 중 및 지연된 거래 수익(안드로이드).
- 앱 내부 또는 외부에서 발생하는 구독 관련 이벤트.
IAP 및 구독 수익 솔루션은 또한 다음을 수행합니다.
- 중복 거래가 기록되지 않도록 합니다. iOS의 경우 가족 공유를 위해 중복이 기록되지 않도록 할 수도 있습니다.
- 앱스플라이어가 Apple App Store 트랜잭션을 귀하(광고주)에게 전달할 수 있도록 허용합니다.
- 매장 수수료 및 세금을 고려한 순수익 데이터를 의미하는 실지 수익 데이터를 제공합니다.
구매 및 구독 데이터는 다음에서 얻을 수 있습니다.
- Android 및 iOS용 앱스플라이어 구매 SDK 커넥터(Unity wrapper 포함).
- 앱스플라이어로 전송된 App Store 및 Google Play(RTDN) 서버 알림.
구매 및 구독 수익 데이터는 앱스플라이어 대시보드 및 리포트를 통해 확인할 수 있습니다. 포스트백을 통해 파트너와 공유할 수도 있습니다.
고려 사항:
- 이 IAP 및 정기 결제 수익 측정 솔루션을 사용하는 경우 인앱구매 이벤트를 전송 하거나 validateAndLogInAppPurchase 를 실행하면 중복 수익이 보고 되므로 실행 해서는 안 됩니다.
- 구독 수익은 기존 구독자가 구매 SDK 커넥터가 포함된 앱 버전을 출시하는 즉시 구독자 수명 주기 변경 사항을 기록할 수 있습니다.
흐름:
- 사용자가 인앱 구매 또는 자동 갱신 구독을 합니다.
- 앱은 앱 스토어에서 트랜잭션을 진행합니다.
- 앱스플라이어 구매 SDK 커넥터 는 구매를 자동으로 감지하고 페이로드를 앱스플라이어로 전송하여 검증 및 로깅을 수행합니다.
-
앱스플라이어는 관련 매장에서 구매의 유효성을 평가하여 사기가 아닌지 확인합니다.
- 유효성 검사에 성공하면 앱스플라이어는 구매 또는 구독을 기록합니다.
- 영수증 검증에 실패하면 차단된 인앱 이벤트 로데이터 리포트(Protect360 가입자가 사용할 수 있음)에 이벤트가 표시됩니다.
- 앱스플라이어는 응답을 SDK 커넥터로 전송하고, SDK 커넥터는 수신 확인 응답(성공 또는 실패)을 앱으로 전송합니다.
-
수신되는 모든 서버 알림은 앱스플라이어 구매 및 구독 수익 비즈니스 로직에 의해서도 처리됩니다.
- SDK 커넥터를 통해 이전에 리포트된 트랜잭션에 대한 알림은 검증 및 처리되며, 그 결과 구매 또는 수명 주기 이벤트가 내부적으로 생성됩니다.
- 알 수 없는 트랜잭션에 대한 알림은 삭제됩니다.
- iOS의 경우 모든 서버 알림을 자체 서버로 다시 라우팅할 수 있습니다.
IAP 및 구독 수익 연동 워크플로
아래 표에 나열된 설정 지침의 순서를 정확하게 따르 면 IAP 및 자동 갱신 구독 수익과 수명 주기 이벤트를 최적으로 정확하게 보고하고 완벽하게 보고할 수 있습니다. 그렇게 하지 않으면 리포트의 영구적 부정확성이 발생할 수 있습니다. 각 단계에 대한 자세한 내용은 표 다음에 나오는 탭에 포함되어 있습니다.
단계 | 작업 |
---|---|
1 |
Google Play의 IAP 및 정기 결제 수익에 대한 알림을 설정합니다. |
2 |
iOS App Store의 IAP 및 정기 결제 수익에 대한 알림을 설정합니다. |
3 |
|
4 |
True Revenue tax API를 통합합니다. 기본 세율을 편집하려는 경우에만 필요한 작업입니다. 그렇지 않으면 ROI360으로 측정된 모든 거래에 대해 세금이 신고됩니다. |
5 |
통합을 테스트 하여 다음을 확인합니다.
|
6 |
구매 SDK 커넥터를 사용하여Android 및 iOS 앱 버전을 출시합니다. |
1단계: Google Play에서 알림 설정하기
시작하기 전에:
- IAP 및 구독 수익 설정은 Google Cloud Platform 및 앱스플라이어 UI에서 수행되는 단계로 구성됩니다. 설정 전반에 걸쳐 Google Cloud Platform 및 앱스플라이어에 대한 탭을 열어 두는 것이 좋습니다.
- 앱스플라이어 UI를 설정하려면 관리자 권한이 필요합니다.
아래 탭의 안내에 따라 Google Play의 알림을 설정하세요.
1.1 Google Play 개발자 계정을 Google Cloud 프로젝트에 연결
- Google Play 콘솔에서 Google Play 개발자 계정으로 이동합니다.
- 계정을 Google Cloud 프로젝트에 연결합니다. 이에 대한 시침은 이 Google 도움말 항목을 참조하십시오.
- Google Play Developer API를 활성화합니다. 이에 대한 시침은 이 Google 도움말 항목을 참조하십시오.
1.2 서비스 계정 만들기
1.3 계정 개인 키를 다운로드합니다.
1.4 API 액세스 권한 설정
- Google Play Console에서 사용자 및 권한으로 이동합니다.
- 사용자 및 권한 목록에서 1.2에서 만든 서비스 계정을 찾고 관리를 클릭합니다.
-
권한 섹션에서 계정 권한 탭으로 이동하여 다음 두 가지를 모두 선택합니다.
- 재무 데이터 표시.
- 주문 및 구독 관리.
- 사용자 초대를 클릭한 다음 초대 전송을 클릭합니다.
둘 중 하나 1.5 앱스플라이어에 직접 Google Play 알림 전송
Google Play에서 IAP 및 정기 결제 수익 데이터를 수신하는 데 사용되는 두 가지 방법 중 하나를 선택합니다.
다음 중 하나:
- 앱스플라이어가 Google Play에서 RTDN 알림을 직접 수신하는 주제를 생성합니다(이 단계에서 계속).
혹은
- 앱스플라이어를 기존 PUB/SUB 주제의 구독자로 설정합니다(다음 단계로 건너뛰기).
앱스플라이어가 RTDN 알림을 직접 수신하는 주제를 생성하려면 다음 단계를 수행하십시오.
- 앱스플라이어에서 ROI360 > 수익 설정 > 구매 및 구독으로 이동하여 앱스플라이어에서 구글에서 RTDN 메시지를 직접 받을 수 있도록 허용을 선택합니다.
- 앱스플라이어 주제를 클립보드에 복사합니다.
- Google Play 콘솔 > 모든 앱에서 사용자 앱을 선택합니다. 대시보드가 열립니다.
- 수익화 설정으로 이동하여 Google Play 청구 섹션의 주제 이름 필드에서 복사한 앱스플라이어 주제 주소를 하위 단계 2에 붙여넣습니다.
- 변경 사항 저장을 클릭합니다.
또는 1.6 Google Play 알림을 앱스플라이어에 전달
IAP 및 구독 알림을 수신하는 다른 방법은 Google Play에서 알림을 받는 기존 주제가 이미 있는 경우에 적용할 수 있습니다. 이 경우 앱스플라이어는 (이전 단계에서와 같이) 새 주제를 생성하는 대신 기존 PUB/SUB 주제의 구독자입니다.
앱스플라이어를 기존 PUB/SUB 항목의 구독자로 설정하려면
- 앱스플라이어에서 ROI360 > 수익 설정 > 구매 및 구독으로 이동하여 RTDN 주제 메시지를 앱스플라이어로 전달을 선택합니다.
- 엔드포인트 URL을 클립보드에 복사합니다.
- Google Cloud 플랫폼에 있는 사용자 프로젝트에서 Pub/Sub를 검색합니다.
- Pub/Sub 에서 주제 섹션으로 이동하여 구독하려는 Pub/Sub 주제가 있는지 확인합니다.
- 구독 섹션으로 이동하여 구독 생성을 클릭합니다.
- 구독 ID를 입력합니다.
- 드롭다운에서 관련 구독 pub/sub 주제를 선택합니다.
- 전달 유형에서 푸시를 선택합니다.
- 하위 2단계에서 기록한 엔드포인트 URL을 입력합니다.
- 만료 기간에서 만료 없음을 선택합니다.
- 저장을 클릭합니다.
- 구독 섹션으로 이동하여 주제 이름을 클립보드에 복사합니다.
- Google Play 콘솔에서 수익화 설정으로 이동하여 Google Play 청구 섹선의 주제 이름 필드에 이전 단계에서 복사한 주제 이름을 붙여 넣습니다.
- 저장을 클릭합니다.
1.7 자동 서비스 구성
-
앱스플라이어에서 ROI360 > 수익 설정 > 구매 및 구독으로 이동하여 다음 중 하나 또는 둘 모두를 설정합니다.
- 구글 플레이로 구매 검증.
- 자동 갱신 가능한 구독 어트리뷰션 및 기록.
- [선택사항] 앱스플라이어가 이미 리포트된 트랜잭션을 중복 제거하도록 허용을 선택합니다. 이렇게 하면 중복 트랜잭션이 기록되지 않습니다.
- 저장을 클릭합니다.
2단계: iOS App Store에서 알림 설정하기
시작하기 전에:
-
IAP 및 구독 수익 설정은 AppStore Connect 및 앱스플라이어 UI에서 수행되는 단계로 구성됩니다. 설치하는 동안 앱스토어 연결 및 앱플라이어 탭을 모두 열어 두십시오.
- 앱스플라이어 UI를 설정하려면 관리자 권한이 필요합니다.
IAP 및 구독 수익을 설정하려면:
-
App Store Connect에서 기능 > 구독으로 이동하고 관리를 클릭하여 App Store Connect 공유 비밀 키를 가져옵니다.
-
앱스플라이어에서 ROI360 > 수익 설정 > 구매 및 구독으로 이동합니다.
수익 구성 페이지가 열립니다.
- App Store Connect 공유 비밀 키를 입력합니다.
- 앱스플라이어 엔드포인트를 복사하여 App Store Connect 구성에 입력합니다.
- [선택사항] 엔드포인트에 서버 알림을 보내려면 선택하고 엔드포인트를 입력합니다.
-
앱스플라이어 IAP 및 구독 수익 설정 페이지에서 다음 중 하나 또는 둘 다를 설정합니다.
- 자동 갱신 가능한 구독 어트리뷰션 및 리포트.
- Apple App Store로 구매 검증
-
[선택사항] 앱스플라이어가 이미 리포트된 트랜잭션을 중복 제거하도록 허용을 선택합니다.
이렇게 하면 중복 트랜잭션이 기록되지 않습니다. -
[선택사항] 가족 공유 구입 항목의 중복 수익 제거를 선택합니다.
이렇게 하면 가족 공유 구매에 대한 중복 수익이 기록되지 않습니다. 다른 가족 구성원에 대한 수익 이벤트에는 파라미터 purchase_ownership_type=FAMILY_SHARED가 포함되며 수익이 0으로 표시됩니다.
일러두기:
- Apple은 하나의 엔드포인트에만 서버 알림을 보낼 수 있습니다.
- 고객은 백엔드에서 알림 엔드포인트 URL로 직접 Apple 서버 알림을 보낼 수 있지만 요청은 App Store에서받은 것과 정확히 일치해야 합니다.
3단계: 구매 SDK 커넥터 통합
구매 SDK 커넥터를 연동하면 앱에서 인앱 구매 및 자동 갱신 구독을 모두 기록할 수 있습니다. Android 및 iOS용 앱스플라이어의 수익 설정 > 구매 및 구독 페이지에서 수익 유형 중 하나 또는 둘 다를 기록하도록 선택할 수 있습니다.
SDK 커넥터를 연동하려면:
- 안드로이드 개발자에게 앱스플라이어 안드로이드 구매 SDK 커넥터를 연동하라고 안내해 주십시오..
- 안드로이드용 앱스플라이어 구매 커넥터 V1은 구Google Billing Library 4를 지원합니다.
- 안드로이드용 앱스플라이어 구매 커넥터 V2는 Google Billing Library 5를 지원합니다.
- iOS 개발자에게 앱스플라이어 iOS 구매 SDK 커넥터를 연동하라고 알리십시오.
참고: Unity 프레임워크를 사용하여 빌드된 앱의 경우 Unity 커넥터 설명서를참조하세요
4단계: 실제 수익세 API 통합
True Revenue는 앱스플라이어 인앱 구매 및 구독 매출 솔루션을 제공하기 위해 구축된 비즈니스 로직 계층입니다. 들어오는 각 트랜잭션의 순수익 가치를 실시간으로 자동 계산하여 리포트에 포함합니다. 세금은 기본 세율 구성을 사용하여 ROI360으로 측정된 모든 거래에 대해 기본적으로 신고됩니다. 전용 세금 API를 사용하여 구성을 편집할 수 있습니다.
tax API를 사용하여 세금 구성을 편집하려면 다음 단계를 따르세요.
-
개발자에게 다음 항목을 제공합니다.
- 권한 부여 키로 사용할 API V2 토큰.
- 다음 표에 설명된 대로 계산할 세금에 대한 정보를 포함하는 파라미터 및 값.
- 개발자에게 세금 API 안내에 따라 세율 규칙을 만들도록 알려주십시오.참고: API는 게시 요청의 본문에 JSON 파일을 허용합니다.이 JSON 파일에는 지원되는 모든 국가 및 세율이 포함되어 있습니다. 개발자는 API에서 편집하거나 그대로 사용할 수 있습니다.
API에서 사용할 파라미터 및 값
파라미터 | 필수적 | 설명 | 값 기록(개발자가 사용할 수 있음) |
---|---|---|---|
tax_name | 예 |
|
|
tax_rate | 예 |
|
|
tax_exclusive | 아니오 |
|
|
국가 | 아니오 |
|
|
하위 분할 | 아니오 |
|
|
postal_code | 아니오 |
|
|
deduction_order | 아니오 |
|
5단계: IAP 및 정기 결제 수익 테스트
샌드박스 환경에서 IAP 및 구독 수익 연동을 검증하여 SDK 커넥터가 제대로 연동되고 서버 알림이 올바르게 구성되고 앱스플라이어가 수신하는지 확인하는 것이 가장 좋습니다.
테스트하기 전에 개발자가 SDK 커넥터에서 샌드박스 환경을 구성하는지 확인합니다(Sandbox
를 true
로 설정). 이를 통해 ROI360은 테스트 수익이 0인 샌드박스 인앱이벤트만 생성할 수 있습니다. 따라서 프로덕션 데이터는 영향을 받지 않습니다.
샌드박스 환경 고려 사항
샌드박스 환경에서:
- 초기 구매 이벤트만 SDK 커넥터가 앱스플라이어에 의해 기록되는 이벤트를 생성하도록 합니다. IAP 이벤트를 af_purchase_sandbox_sdk라고 합니다. 구독 이벤트를 af_ars_sandbox_sdk라고 합니다.
-
다른 모든 구매 이벤트는 삭제되며, 이는 SDK 커넥터가 이벤트를 생성하지 않음을 의미합니다.
- 수신 서버 알림은 SDK 커넥터가 원래 트랜잭션을 먼저 기록하는 경우에만 처리됩니다. 이 경우 af_purchase_sandbox_s2s라는 IAP 이벤트가 생성됩니다. af_ars_sandbox_s2s라는 구독 이벤트가 생성됩니다 .
- SDK 커넥터가 원래 트랜잭션을 먼저 기록하지 않은 서버 알림에 대해서는 이벤트가 생성되지 않습니다.
-
iOS의 경우, App Store Connect의 앱 스토어 서버 알림에서 앱스플라이어 엔드포인트가 샌드박스 서버 URL로 구성되어 있는지 확인합니다.
- Android의 경우 SDK의 샌드박스 환경이 구성되지 않은 경우에도 License Tester가 테스트를 수행하면 샌드박스 이벤트가 발생합니다.
IAP 및 구독 수익 테스트하기
IAP 및 구독 수익을 테스트하려면:
- 개발자에게 Android , iOS 및 Unity 지침에 따라 SDK 커넥터에서 샌드박스 환경을 구성하도록 지시합니다.
- 테스트 구매를 합니다. Google Play의 License Tester 및 iOS의 TestFlight에서 수행한 트랜잭션도 지원됩니다.
참고: 구독 제품은 각 테스트 디바이스에서 한 번만 테스트할 수 있습니다. 즉, 동일한 구독을 여러 번 테스트 구매하는 것이 기록되지 않으므로 동일한 디바이스에서 등록할 수 없습니다. -
앱스플라이어 활동 대시보드에 이벤트가 표시되는지 확인합니다. IAP 이벤트를 af_purchase_sandbox_sdk라고 합니다. 구독 이벤트를 af_ars_sandbox_sdk라고 합니다. 이러한 이벤트는 다음과 같습니다.
- 수익 값 0(실제 앱스플라이어 리포트를 왜곡하지 않기 위해 필요).
- 올바른 수익이 리포트되도록 하기 위해 구매한 제품의 수익 가치를 포함하는 af_sandbox_revenue 파라미터.
- 구독 제품을 테스트하는 경우 앱스플라이어가 서버 알림을 받을 때까지 잠시 기다려주십시오. 일반적으로 이것은 초기 구매 후 몇 분 이내에 발생합니다.
-
앱스플라이어 활동 대시보드에 이벤트가 표시되는지 확인합니다. 자동 갱신 구독 구매를 af_ars_sandbox_s2s라고 합니다. 이벤트에는 다음이 포함됩니다.
- 수익 값 0(실제 앱스플라이어 리포트를 왜곡하지 않기 위해 필요).
- 올바른 수익이 리포트되도록 하기 위해 구매한 제품의 수익 가치를 포함하는 af_sandbox_revenue 파라미터.
참고
IAP 관련 이벤트 및 파라미터
다음 섹션에는 앱스플라이어가 측정하는 IAP 관련 이벤트와 각 이벤트에 대해 기록되는 파라미터가 표시됩니다. 포함된 파라미터에 대한 설명은 이벤트 파라미터 사전을 참조하십시오.
생성된 모든 이벤트는:
- S2S 이벤트로 간주됩니다.
- 로데이터 리포트(오가닉 또는 논오가닉 인앱이벤트)에서 액세스할 수 있습니다.
- 포스트백을 통해 파트너에게 보낼 수 있습니다.
- SKAN Conversion Studio에서 사용할 수 있습니다.
참고: 사용자 장치 플랫폼에 따라 인앱이벤트에 대해 일부 파라미터가 항상 채워지는 것은 아닙니다.
구매(af_purchase)
설명
사용자가 구매할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_net_revenue
- af_net_revenue_tax_name
- af_net_revenue_tax_rate
- af_net_revenue_tax_exclusive
- af_net_revenue_country
- af_net_revenue_subdivision
- af_net_revenue_postal_code
- af_net_revenue_factors
구매 취소됨(af_purchase_canceled)
설명
사용자가 구매를 취소할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
구매 보류 중(af_purchase_pending)
설명
사용자가 구매했지만 결제가 아직 처리되지 않은 경우 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
환불 (af_purchase_refund)
설명
구매가 환불될 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_discount_type
- event_revenue_usd
- event_revenue(수익이 0을 초과하는 경우 이벤트에 포함)
- store_commission
- af_net_revenue
- af_net_revenue_factors
- af_net_revenue_tax_name
- af_net_revenue_tax_rate
- af_net_revenue_tax_exclusive
- af_net_revenue_country
- af_net_revenue_subdivision
- af_net_revenue_postal_code
테스트 구매(af_purchase_sandbox_sdk)
설명
샌드박스 환경에서 SDK를 통해 기록된 구매를 테스트할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_purchase_state
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
테스트 구매(af_purchase_sandbox_s2s)
설명
샌드박스 환경에서 S2S를 통해 리포트된 구매를 테스트할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_purchase_state
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
구독 관련 이벤트 및 파라미터
다음 섹션에는 앱스플라이어가 측정하는 구독 관련 이벤트와 각 이벤트에 대해 기록되는 파라미터가 표시됩니다. 포함된 파라미터에 대한 설명은 이벤트 파라미터 사전을 참조하십시오.
생성된 모든 이벤트는:
- S2S 이벤트로 간주됩니다.
- 로데이터 리포트(오가닉 또는 논오가닉 인앱이벤트)에서 액세스할 수 있습니다.
- 포스트백을 통해 파트너에게 보낼 수 있습니다.
- SKAN Conversion Studio에서 사용할 수 있습니다.
참고: 사용자 장치 플랫폼에 따라 인앱이벤트에 대해 일부 파라미터가 항상 채워지는 것은 아닙니다.
평가판 시작(af_ars_trial_started)
설명
구독자가 평가판 기간을 시작할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- Af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
평가판 취소(af_ars_trial_canceled)
설명
구독자가 평가판 기간 동안 구독의 자동 갱신을 취소할 때 기록됩니다. 사용자가 평가판 기간 내에 자동 갱신을 복원하지 않으면 이탈 이벤트가 발생합니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- Af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
평가판 이탈 (af_ars_trial_churned)
설명
평가판 기간 후 구독자가 이탈할 때 기록됩니다. 이는 자동 갱신 취소 및 평가판 기간 만료 후에 발생합니다. 또한 갱신과 관련된 청구 또는 기술 문제로 인해 이탈이 발생할 수도 있습니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- Af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_reason
평가판 변환 (af_ars_trial_converted)
설명
평가판 기간 후 전체 가격 갱신이 시작될 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- Af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_discount_id
- af_discount_type
- event_revenue_usd
- af_revenue (수익이 0을 초과하는 경우에만 이벤트에 포함됨)
- store_commission
- af_net_revenue
- af_net_revenue_factors
- af_net_revenue_tax_name
- af_net_revenue_tax_rate
- af_net_revenue_tax_exclusive
- af_net_revenue_country
- af_net_revenue_subdivision
- af_net_revenue_postal_code
구독 시작됨(af_ars_subscription_started)
설명
할인된 구독 또는 정액이 책정된 구독이 시작될 때 기록됩니다.
일러두기:
- 새 구독은 SDK 커넥터를 통해서만 기록할 수 있습니다.
- iOS의 경우, 구독자가 이미 소유한 구독을 재구매하면 SDK 커넥터가 성공적인 영수증 검증을 앱에 다시 리포트하지만 앱스플라이어에 새 트랜잭션을 기록하지는 않습니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_discount_id
- af_discount_type
- event_revenue_usd
- event_revenue(수익이 0을 초과하는 경우 이벤트에 포함)
- store_commission
- af_net_revenue
- af_net_revenue_factors
- af_net_revenue_tax_name
- af_net_revenue_tax_rate
- af_net_revenue_tax_exclusive
- af_net_revenue_country
- af_net_revenue_subdivision
- af_net_revenue_postal_code
구독 취소(af_ars_subscription_canceled)
설명
청구 기간 중간에 자동 갱신 구독이 취소될 때 기록됩니다. 사용자가 동일한 결제 기간 내에 자동 갱신을 복원하지 않으면 이탈 이벤트가 발생합니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
구독 일시 중지됨(af_ars_subscription_paused) - 안드로이드만 해당
설명
사용자가 활성 구독을 일시 중지할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
구독 재개 (af_ars_subscription_resumed)
설명
이탈 또는 환불된 구독 후 전체 가격의 구독이 다시 시작될 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_discount_id
- af_discount_type
- af_reason
- event_revenue(이벤트 수익이 0을 초과하는 경우 이벤트에 포함)
- store_commission
- af_net_revenue
- af_net_revenue_factors
구독 이탈(af_ars_subscription_churned)
설명
구독자가 이탈할 때 기록됩니다. 이는 일반적으로 자동 갱신 취소 또는 청구 기간 만료 후에 발생합니다. 또한 청구 또는 기술 문제가 발생할 수 있으며 갱신으로 인해 이탈이 발생할 수 있습니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- Af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_reason
구독료 환불됨(af_ars_subscription_refunded)
설명
구독자가 환불을 받을 때 기록됩니다.
일러두기:
- 이 이벤트는 일반적으로 음수 값과 함께 생성됩니다. 환불된 거래를 감지할 수 없거나 환불 세부 정보가 알림에 포함되지 않은 경우 환불 이벤트에 값이 표시되지 않습니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_reason
- af_subscription_ownership_type
- af_discount_id
- af_discount_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_refunded_transaction_ids
- event_revenue_usd
- event_revenue(수익이 0을 초과하는 경우 이벤트에 포함)
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_store
- af_environment
- af_period_type
- store_commission
- af_net_revenue
- af_net_revenue_factors
- af_net_revenue_tax_name
- af_net_revenue_tax_rate
- af_net_revenue_tax_exclusive
- af_net_revenue_country
- af_net_revenue_subdivision
- af_net_revenue_postal_code
구독 청구 유예(af_ars_subscription_billing_grace)
설명
청구 문제로 인해 구독 갱신이 실패하고 구독자가 청구 유예 기간에 들어갈 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- Af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- Af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
구독 갱신 (af_ars_subscription_renewed)
설명
자동 갱신 구독이 발생할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_discount_id
- af_discount_type
- event_revenue_usd
- event_revenue(수익이 0을 초과하는 경우 이벤트에 포함)
- store_commission
- af_net_revenue
- af_net_revenue_factors
구독이 변경(af_ars_subscription_xgraded)
설명
구독자가 다른 제품으로 업그레이드, 다운그레이드 또는 교차 등급을 지정할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_discount_id
- af_discount_type
- event_revenue_usd
- event_revenue(수익이 0을 초과하는 경우 이벤트에 포함)
- store_commission
- af_net_revenue
- af_net_revenue_factors
기존 구독자(af_ars_existing_subscriber)
설명
SDK 커넥터가 청구 주기 중간에 구독자에 대한 알림을 받을 때 기록되며, 구독자를 다른 관련 수명 주기 단계로 전환하는 후속 서버 알림을 받기 전에 기록됩니다. 이 이벤트는 일반적으로 온보딩 및 SDK 커넥터 채택 기간 동안 생성됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- 국가
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_cuids
- af_validated
테스트 구매(af_ars_sandbox_sdk)
설명
샌드박스 환경에서 SDK를 통해 기록된 구매를 테스트할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- 국가
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_discount_id
- af_discount_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_cuids
- af_validated
테스트 구매(af_ars_sandbox_s2s)
설명
샌드박스 환경에서 S2S를 통해 리포트된 구매를 테스트할 때 기록됩니다.
파라미터
- app_id
- CUSTOMER_USER_ID
- 국가
- af_currency
- af_expires_date_ms
- af_subscription_ownership_type
- af_discount_id
- af_discount_type
- af_original_transaction_id
- af_order_id
- af_purchase_token
- af_transaction_id
- af_product_id
- android_id
- IDFA
- ip
- appsflyer_id
- af_purchase_date_ms
- af_store
- af_environment
- af_period_type
- af_cuids
- af_validated
파라미터 사전
IAP 및 정기 결제 이벤트의 파라미터는 로데이터 리포트에 자체 열로 표시되거나 이벤트 값의일부로 채워집니다.
자체 열이 있는 파라미터는 다음과 같습니다.
- app_id
- CUSTOMER_USER_ID
- country_code
- af_currency
- event_revenue_usd
- af_revenue
- android_id
- ip
- IDFA
- appsflyer_id
이러한 파라미터에 대한 자세한 정보는 데이터 필드 사전 을 참조하십시오.
다음 표에서는 ARS 및 VIAP 이벤트에서 사용할 수 있는 로데이터 파라미터에 대해 설명합니다.
파라미터 | 설명 | 제품 |
---|---|---|
af_cancelation_date_ms | 취소 날짜 | IAP |
af_reason |
|
|
af_expires_date_ms |
현재 구독 청구 주기의 만료 날짜 |
구독 |
af_subscription_ownership_type |
FAMILY_SHARED는 사용자가 가족 공유를 통해 액세스할 수 있음을 의미합니다. PURCHASED는 유료 사용자가 구매했음을 의미합니다. |
구독 |
af_discount_id |
초기 구매 중에 사용자에게 제공되는 제안 ID입니다. ID는 할인 코드가 있는 경우에만 채워집니다. |
|
af_discount_type |
사용자가 사용하는 할인 유형입니다. 가능한 값은 다음과 같습니다.
|
구독 |
af_original_transaction_id |
|
|
af_order_id |
|
|
af_purchase_token |
|
|
af_transaction_id |
|
|
af_purchase_state |
가능한 값은 다음과 같습니다.
|
IAP |
af_original_transaction_id |
|
|
af_refunded_transaction_ids |
|
|
af_product_id |
구독 제품 ID |
|
af_purchase_date_ms |
리포트된 제품 ID 인앱이벤트의 구매 날짜 |
|
af_store |
구독 제품을 구매한 앱 스토어 |
|
af_environment |
데이터가 수신되는 환경(프로덕션 또는 샌드박스). |
|
af_period_type |
|
구독 |
store_commission |
|
|
af_net_revenue |
모든 요인을 기준으로 계산한 순수익입니다.af_net_revenue_factors를 참조하십시오. |
|
af_net_revenue_factors |
|
|
af_net_revenue_tax_name |
|
|
af_net_revenue_tax_rate |
|
|
af_net_revenue_tax_exclusive |
|
|
af_net_revenue_country |
|
|
af_net_revenue_subdivision |
|
|
af_net_revenue_postal_code |
|
|
af_cuids |
|
구독 |
실제 수익
실제 수익은 앱스플라이어 인앱 구매 및 구독 수익 솔루션을 제공하기 위해 구축된 비즈니스 로직 계층입니다. 들어오는 각 트랜잭션의 순수익 가치를 실시간으로 자동 계산하여 리포트에 포함합니다. 실제 수익은 총 수익 계산에서 다음 요소를 고려합니다.
-
매장 수수료:
- 자동으로 계산되어 리포트됩니다. 사용자의 조치가 필요하지 않습니다.
- 구매 시 매점 수수료는 30%입니다.
- 구독시 수수료는 구독자의 수명을 고려하여 구독자별로 자동 계산됩니다(App Store: 30% 커미션에서 시작하여 1년 후 15%로 감소, Play Store: 15% 수수료).
- 관련 순수익 파라미터는 로데이터 리포트에서 사용할 수 있습니다.
- 세금: 세금은 기본 세율 구성을 사용하여 ROI360으로 측정된 모든 거래에 대해 기본적으로 신고됩니다. 전용 tax API를 사용하여 구성을 편집할 수 있습니다.
보고서에서 실제 수익을 볼 때 다음 매개변수에는 순수익 데이터가 포함됩니다. 자세한 내용은 파라미터 사전을 참조하십시오.
파라미터 | 순수익 계수 |
---|---|
store_commission |
매장 수수료 |
af_net_revenue_tax_name |
세금 |
af_net_revenue_tax_rate |
세금 |
af_net_revenue_tax_exclusive |
세금 |
af_net_revenue_postal_code |
세금 |
af_net_revenue_country |
세금 |
af_net_revenue_subdivision |
세금 |
af_net_revenue |
|
af_net_revenue_factors |
|
사양 및 제한 사항
사양 | 제품 | 설명 |
---|---|---|
설치 기록 및 익명화 |
|
지원 안됨. |
Google 결제 라이브러리 V6 |
|
지원 안됨. |
새 구독 |
구독 수익 |
앱스플라이어 구매 SDK를 통해서만 기록됩니다. |
가격 변동 |
구독 수익 |
구독 수익이 새 제품 가격과 함께 SDK에서 발생한 알림을 받지 못한 경우 구독 수익은 계속 이전 제품 가격을 수익으로 리포트합니다. 구매 SDK에서 새 제품 가격이 수신되면 새 가격이 기록됩니다. |
총 수익 |
|
지원됨. |
순수익 |
|
로데이터에서만 지원됨 |
세금 |
구독 수익 |
지원됨. |
순수익 매점 수수료 |
|
|
환불 | IAP | 최초 구매 후 180일까지 신고할 수 있습니다. |
중복 |
|
이벤트 날짜로부터 최대 180일까지 보고된 거래에 대해 지원됩니다. |
SDK 엄격 모드 |
|
ROI360 구독 및 VIAP는 SDK 엄격 모드에서 지원됩니다. |
통화 |
|
수익은 원래 통화(event_revenue 파라미터 사용)와 USD(event_revenue_usd 파라미터 사용)로 리포트됩니다. |