어떻게 도와드릴까요?

ROI360 스토어 수익 설정 프리미엄

  • 업데이트 시간

한눈에 보기: AppsFlyer ROI360 스토어 수익 솔루션을 설정합니다.

개요

참고

ROI360에 대한 자세한 정보는 ROI360 스토어 수익에 대한 정보를 참조하십시오. 어떻게 작동하는지 및 AppsFlyer에서 활성화하는 방법을 포함합니다.

ROI360 스토어 수익을 설정하려면 다음 단계를 순서대로 완료하십시오:

  1. 스토어 자격 증명 설정 (iOS 및 Android):
    • iOS: AppsFlyer에서 App Store Connect 키(인앱 구매 키, 키 ID 및 발급자 ID)를 구성합니다.
    • Android: Google Cloud 서비스 계정을 구성하고 Google Play Console에서 필요한 권한을 설정한 후, 서비스 계정 JSON 키를 AppsFlyer에 업로드합니다.
  2. 서버 알림 구성 (iOS 및 Android):
    • iOS: AppsFlyer에 직접 알림을 보내거나(권장) 자신의 엔드포인트에서 전달하여 App Store 서버 알림을 설정하고 통합을 검증합니다.
    • Android: Google Play 실시간 개발자 알림(RTDN)을 설정합니다. Google Play가 AppsFlyer에 직접 알림을 보내도록 허용하거나(권장) Pub/Sub를 통해 전달합니다.
  3. SDK 커넥터 구현: 개발자가 AppsFlyer 구매 SDK 커넥터를 통합할 수 있도록 준비합니다.
  4. SDK 구현 확인 두 플랫폼에서 샌드박스 인앱 구매 및 구독을 테스트하여 SDK 이벤트와 서버 알림이 AppsFlyer에 의해 올바르게 수신되고 처리되는지 확인합니다.
  5. 설정 확인 및 업데이트: 구매 검증, 환불 처리, 구독 측정 및 스토어 통합의 상태를 검토하고 확인하여 플랫폼 간 정확하고 지속적인 수익 귀속을 보장합니다.
  6. 앱 버전 출시: SDK 커넥터가 통합된 업데이트된 앱 버전을 출시하고, 샌드박스 플래그가 비활성화되고 검증 규칙이 필요한 수익 이벤트를 허용하는지 확인합니다.

1단계 (iOS): App Store Connect 키 설정

1단계에서 App Store Connect에서 다음 자격 증명을 얻고 AppsFlyer 플랫폼의 수익 설정 페이지에 입력합니다.

  • 인앱 구매 (IAP)
  • 키 ID
  • *발급자 ID

시작하기 전에:

자격 증명을 설정하는 것은 App Store Connect와 AppsFlyer 모두에서 수행되는 단계가 포함됩니다. 설정하는 동안 App Store Connect와 AppsFlyer 탭을 모두 열어 두십시오.

1.1 App Store Connect 키 생성하기

iOS 자격 증명을 설정하려면, 다음 단계를 따르십시오:

  1. App Store Connect에서 사용자 및 접근 권한으로 이동하십시오.

  2. 사용자 및 접근 권한으로 가서 통합을 선택한 후, 키 목록에서 인앱 구매를 선택하십시오.

  3. 새 인앱 구매 키를 생성하려면 +을 클릭하십시오.

  4. API 키의 이름을 입력하십시오.
  5. 생성을 클릭합니다.
  6. 방금 생성한 키 옆에 있는 인앱 구매 키 다운로드을 클릭하여 다운로드하십시오. 참고: 키는 한 번만 다운로드할 수 있습니다.
  7. 방금 생성한 키의 키 ID를 복사하여 AppsFlyer의 구매 및 구독 설정의 키 ID에 붙여넣으십시오.

  8. 발급자 ID를 복사하십시오. 참고: 페이지 상단에 발급자 ID가 표시되지 않으면, App Store Connect API 키를 생성하십시오(접근 수준은 상관없습니다). 그 후, 인앱 구매 키의 페이지 상단에 발급자 ID가 나타납니다.

1.2 AppsFlyer에 App Store Connect 키 설정하기

  1. ROI360 스토어 수익 활성화하십시오. 
  2. App Store Connect 키 단계에서 업로드를 클릭하여 인앱 구매 키 필드에 p8 파일을 업로드하십시오.
  3. App Store Connect 키 제목의 섹션에서 App Store Connect에서 복사한 값을 붙여넣으십시오.

    • 키 ID
    • *발급자 ID
  4. 입력한 키가 올바른지 확인하려면 키 검증을 클릭하십시오. 참고: 앱이 아직 App Store에 게시되지 않은 경우 검증 키가 작동하지 않을 수 있습니다.
  5. 클릭 저장 및 다음

1단계 (안드로이드): 서비스 계정 키 및 권한

1단계에서 App Store Connect에서 다음 자격 증명을 얻고 이를 AppsFlyer 플랫폼의 수익 설정 페이지에 입력할 수 있습니다.

시작하기 전에:

  • 인앱 구매 및 구독 수익 측정을 설정하는 것은 구글 클라우드 플랫폼, 구글 플레이 콘솔, 및 AppsFlyer UI에서 수행되는 단계가 포함됩니다. 설정하는 동안 세 곳 모두를 열어 두는 것을 권장합니다.
  • 앱스플라이어 UI를 설정하려면 관리자 권한이 필요합니다.

1.1. 1.1 Google Play 개발자 계정을 Google Cloud 프로젝트에 연결

선행 조건: 구글 플레이 콘솔 및 구글 클라우드 프로젝트에 대한 접근 권한.

구글 플레이 개발자 계정을 구글 클라우드 프로젝트에 연결하려면 다음 단계를 따르세요:

  1. Google Play 콘솔에서 Google Play 개발자 계정으로 이동합니다.
  2. 계정을 Google Cloud 프로젝트에 연결합니다. 이에 대한 시침은 이 Google 도움말 항목을 참조하십시오.
  3. Google Play Developer API를 활성화합니다. 이에 대한 시침은 이 Google 도움말 항목을 참조하십시오.

1.2. 구글 클라우드 플랫폼에서 서비스 계정을 구성하세요.

선행 조건: 구글 클라우드 플랫폼에 대한 접근 권한.

서비스 계정을 구성하려면 다음 단계를 따르세요:

  1. 서비스 계정을 생성하거나 찾으세요:
    1. 구글 클라우드 플랫폼의 서비스 계정 섹션으로 가서 서비스 계정 만들기를 클릭하세요.

    2. 서비스 계정 세부 정보를 입력하세요.

    3. 이메일 주소를 복사하세요.

    4. 생성 및 계속하기를 클릭합니다.

    5. 이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 단계에서  Pub/Sub 구독자 역할을 선택합니다.

    6. 계속하기 > 완료를 클릭합니다.

  2. 서비스 계정 개인 키를 다운로드하세요:
    1. 구글 클라우드 플랫폼에서 서비스 계정 섹션으로 가서 목록에서 원하는 계정(방금 생성한 계정)을 찾아 추가 작업 아이콘을 클릭하세요.
    2. 키 관리를 클릭하세요.

    3. 키 추가 > 새 키 만들기를 클릭하세요.

    4. 개인 키 만들기 팝업에서 키 유형 아래에 JSON을 선택하고 만들기를 클릭하세요.

    5. 생성을 클릭합니다. 개인 키 JSON 파일이 다운로드됩니다.

    6. JSON 키 파일을 저장하세요. 이 파일은 나중에 AppsFlyer에 업로드됩니다. 참고! 키를 저장해야 합니다. 나중에 복구할 수 없습니다. 저장하지 않으면 완전히 새로운 키를 만들어야 합니다.

1.3. Google Play Console에서 API 접근 권한을 설정하십시오.

선행 조건: Google Play Console에 접근합니다.

참고: 참고: 서비스 계정 사용자 인증 정보 및 권한을 설정한 후 사용가능할 때까지 시간이 걸릴 수 있습니다(경우에 따라 24시간까지). 이로 인해 이후 단계에서 오류가 발생할 수 있습니다.

Google Play Console에서 API 접근 권한을 설정하려면:

  1. Google Play Console에서 사용자 및 권한으로 이동하여 생성한 서비스 계정을 찾고 새 사용자 초대를 클릭하십시오.

  2. 1.2.1.3단계에서 서비스 계정을 구성할 때 복사한 이메일 주소을 입력하십시오.

  3. 권한 섹션에서 계정 권한 탭으로 이동하여 다음 두 가지를 모두 선택합니다.

    • 재무 데이터, 주문 및 취소 설문 응답을 확인하십시오.
    • 주문 및 구독 관리.
  4. 앱 권한 탭에서 앱 추가를 클릭한 다음 귀하의 앱을 선택하십시오. 필요한 경우 여러 앱을 추가하십시오.

  5. 사용자 초대를 클릭하십시오.

  6. 확인 팝업에서 초대 전송을 클릭하십시오.

1.4. 서비스 계정 개인 키를 AppsFlyer에 업로드하십시오.

1.2단계에서 다운로드한 Google JSON 키를 업로드하고 검증하십시오.

선행 조건: AppsFlyer에 대한 관리자 접근 권한.

서비스 계정 개인 키를 AppsFlyer에 업로드하려면 다음 단계를 따르십시오:

  1. ROI360 스토어 수익 활성화하십시오. 
  2. 서비스 계정 키 및 권한 단계에서 Google JSON 키 업로드 필드에 (업로드 아이콘).을 클릭하십시오.
  3. 1.2단계에서 다운로드한 JSON 파일을 업로드하십시오.
  4. 키 검증 참고:
    • 서비스 계정 자격 증명 및 권한을 설정한 후, 이를 사용할 수 있게 되기까지 최대 24시간이 소요될 수 있습니다. 이로 인해 키를 검증하거나 검증 테스트를 수행할 때 오류가 발생할 수 있습니다.
    • 24시간 대기 시간을 우회하기 위해 Google Play Console에서 임의의 애플리케이션으로 이동한 후, 수익화 > 제품 > 구독/인앱 제품으로 가서 변경을 합니다. 예를 들어, 제품의 설명을 수정하고 저장합니다. 이렇게 하면 계정 자격 증명 및 권한이 즉시 업데이트됩니다. 그런 다음 변경 사항을 취소할 수 있습니다.
  5. 저장 및 다음을 클릭합니다.

2단계 (iOS): 앱 스토어 서버 알림 활성화

AppsFlyer에서 App Store 알림 수신 방법을 설정합니다.

  • App Store Connect에 App Store 서버 알림 엔드포인트가 이미 구성되어 있는 경우(예: 자체 백엔드 또는 다른 서비스), 옵션 1 (권장) 또는 옵션 2 중에서 선택합니다.
  • 아직 App Store Connect에 엔드포인트를 구성하지 않은 경우 옵션 1을 선택합니다.

옵션 1 (권장) - AppsFlyer를 기본 엔드포인트로 설정

기존 App Store Connect 알림 URL을 AppsFlyer 엔드포인트로 교체하고, AppsFlyer에서 이전 엔드포인트를 전달 목적지로 추가합니다. 현재의 구독 논리와 워크플로우는 변경되지 않으며 예상대로 계속 작동합니다.

이 옵션의 알림 흐름은 다음과 같습니다:

  1. App Store Connect가 AppsFlyer에 알림을 보냅니다.
  2. AppsFlyer가 ROI360을 위해 이를 처리합니다.
  3. AppsFlyer가 모든 알림을 기존 엔드포인트 실시간으로 전달합니다.

이 옵션을 사용하려면 2.1, 2.2, 및 2.4 단계를 완료합니다.

옵션 2 - 귀하의 엔드포인트를 기본 엔드포인트로 설정

기존 엔드포인트를 기본 목적지로 유지하려면 서버를 구성하여 App Store 서버 알림을 AppsFlyer로 전달하십시오.

이 옵션을 사용하려면 2.1단계와 2.2단계를 건너뛰고 2.3단계와 2.4단계를 완료하십시오.

앱스플라이어 서버 알림 엔드포인트

AppsFlyer 서버 알림 엔드포인트를 복사하려면 다음 단계를 따르십시오:

  1. AppsFlyer에서 의  App Store 서버 알림 단계에서 AppsFlyer 서버 알림 엔드포인트를 복사하십시오.
  2. 이전에 다른 App Store 서버 알림 엔드포인트가 있었고 AppsFlyer가 알림을 해당 엔드포인트로 전달하기를 원한다면 알림을 귀하의 서버로 전달하기 (옵션 1에만 해당).를 선택하십시오.
  3. 표시된 텍스트 상자에 알림 전달 엔드포인트를 입력하십시오.

2.2 알림을 AppsFlyer로 직접 전송하십시오.

알림을 AppsFlyer로 직접 전송하려면 AppsFlyer를 기본 App Store 서버 알림 엔드포인트로 설정하십시오.

  1. App Store Connect의 앱 정보 섹션에서 App Store 서버 알림으로 스크롤하고, 생산 서버 URL 옆에 있는 편집을 클릭하십시오.

  2. AppsFlyer에서 복사한 AppsFlyer 서버 알림 엔드포인트를 붙여넣고, 버전 2 알림을 선택한 후 저장을 클릭하십시오. 참고: 버전 1 알림은 더 이상 지원되지 않습니다. 알림 버전 선택기가 Apple Store Connect에 나타나지 않으면 이미 버전 2를 사용하고 있다는 의미입니다.

  3. 앱 정보 섹션에서 App Store 서버 알림으로 스크롤하고, 샌드박스 서버 URL 옆에 있는 편집을 클릭하십시오.

  4. AppsFlyer에서 복사한 AppsFlyer 서버 알림 엔드포인트를 붙여넣고, 버전 2 알림을 선택한 후 저장을 클릭하십시오. 참고: 버전 1 알림은 더 이상 지원되지 않습니다. 알림 버전 선택기가 Apple Store Connect에 나타나지 않으면 이미 버전 2를 사용하고 있다는 의미입니다.

2.3 [선택 사항] 귀하의 엔드포인트에서 AppsFlyer로 알림을 전달하십시오.

이 단계는 AppsFlyer로 알림을 직접 전송하는 대신 귀하의 엔드포인트를 App Store 서버 알림의 기본 목적지로 유지하려는 경우에만 사용하십시오.

이 옵션은 권장 설정이 아니며 백엔드 구현이 필요합니다. 위의 2.2 단계에서 이미 AppsFlyer를 기본 엔드포인트로 구성한 경우 이 단계를 건너뛰십시오.

귀하의 엔드포인트에서 AppsFlyer로 서버 알림을 전달하려면 다음 단계를 따르십시오:

  1. App Store Connect의 앱 정보 섹션에서 App Store 서버 알림으로 스크롤하고, 생산 서버 URL 옆에 있는 편집을 클릭하십시오.

  2. 귀하의 서버 엔드포인트 URL을 붙여넣으십시오.

  3. 버전 2 알림을 선택하십시오. 참고: 버전 1 알림은 더 이상 지원되지 않습니다. 알림 버전 선택기가 Apple Store Connect에 나타나지 않으면 이미 버전 2를 사용하고 있다는 의미입니다.
  4. 저장을 클릭하세요.
  5. 앱 스토어 연결의 앱 정보 섹션에서 앱 스토어 서버 알림으로 스크롤한 다음, 샌드박스 서버 URL 옆에 있는 편집을 클릭하십시오.

  6. 귀하의 서버 엔드포인트 URL을 붙여넣으십시오.

  7. 버전 2 알림을 선택하십시오. 참고: 버전 1 알림은 더 이상 지원되지 않습니다.
  8. 저장을 클릭하세요.
  9. 백엔드를 구성하여 Apple 서버 알림을 AppsFlyer 알림 엔드포인트 URL로 전달하십시오. 요청은 Apple로부터 수신한 앱 스토어 페이로드와 정확히 일치해야 하며, Apple 형식 요구 사항을 참조하십시오.

2.4 서버 알림 통합 테스트

AppsFlyer가 앱 스토어 서버 알림을 올바르게 수신하고 있는지 확인하거나, 최근에 엔드포인트를 구성했지만 아직 서버 알림이 도착하지 않은 경우:

  1. AppsFlyer에서 앱 스토어 서버 알림 단계로 이동하십시오.
  2. 통합 테스트을 클릭하십시오. AppsFlyer는 Apple에 테스트 알림 요청을 보내고, 지난 7일 동안 Apple로부터 유효한 알림이 수신되었는지 확인하며, 다음 중 하나를 표시합니다:

    • 유효한 알림이 수신되었는지에 대한 확인입니다.
    • 알림이 발견되지 않았다는 상태 메시지입니다.

    참고

    Apple이 테스트 메시지를 보내는 데 몇 초가 걸릴 수 있습니다.

    • 상태가 여전히 유효하지 않으면 잠시 기다렸다가 다시 시도하십시오.
    • 테스트가 성공한 후, 또는 계속할 준비가 되었을 때 저장 및 다음을 클릭하십시오.

단계 2 (안드로이드): 구글 플레이 서버 알림

Google Play에서 인앱 구매 및 구독 수익 데이터를 수신하려면 다음 옵션 중에서 선택하십시오:

선행 조건: Google Play Console 및 AppsFlyer UI에 대한 접근 권한입니다.

둘 중 하나 1.5 앱스플라이어에 직접 Google Play 알림 전송

  1. AppsFlyer에서 2단계 , Google Play 서버 알림 설정에서 AppsFlyer 주제가 Google으로부터 RTDN 메시지를 직접 받을 수 있도록 허용을 선택합니다.
  2. 앱스플라이어 주제를 클립보드에 복사합니다.
  3. Google Play Console > 홈에서 귀하의 앱을 보려면 선택하십시오. 대시보드가 열립니다.

  4. Play로 수익화 > 수익화 설정으로 이동하고, Google Play 청구 섹션에서 실시간 알림 활성화가 체크되어 있는지 확인하십시오.

  5. 주제 이름 필드에 복사한 AppsFlyer 주제 주소를 붙여넣습니다.

  6. 알림 내용에 대해 구독, 무효화된 구매 및 모든 일회성 제품을 선택합니다.

  7. 변경 사항 저장을 클릭합니다. 이 효과가 나타나기까지 시간이 걸릴 수 있습니다(때로는 24시간까지도). 따라서 테스트하기 전에 기다리십시오.

또는 1.6 Google Play 알림을 앱스플라이어에 전달

참고: 이 단계는 Google Play에서 AppsFlyer로 직접 알림을 보내어 인앱 구매 및 구독 수익 데이터를 받는 권장 방법을 선택하지 않은 경우에만 해당됩니다. Google Play에서 AppsFlyer가 RTDN 알림을 직접 받는 주제를 생성하기 위한 권장 방법의 단계를 완료했다면 이 단계를 건너뛰십시오.

기존 PUB/SUB 주제에 AppsFlyer를 구독자로 설정하려면 아래 지침을 계속 진행하십시오.

선행 조건: Google Cloud Platform 및 AppsFlyer UI에 대한 접근 권한입니다.

또는 1.6 Google Play 알림을 앱스플라이어에 전달

  1. AppsFlyer에서 사이드 메뉴에서 설정 > 수익 설정으로 이동합니다.
  2. 앱을 선택합니다.
  3. 구매 및 구독 탭에서 RTDN 주제 메시지를 AppsFlyer로 전달을 선택합니다.
  4. 엔드포인트 URL을 클립보드에 복사합니다.
  5. Google Cloud 플랫폼에 있는 사용자 프로젝트에서 Pub/Sub를 검색합니다.

  6. Pub/Sub 에서 주제 섹션으로 이동하여 구독하려는 Pub/Sub 주제가 있는지 확인합니다.

  7. 구독 섹션으로 이동하여 구독 생성을 클릭합니다.

  8. 구독 ID를 입력합니다.

  9. 드롭다운에서 관련 구독 pub/sub 주제를 선택합니다.

  10. 전달 유형에서 푸시를 선택합니다.

  11. AppsFlyer에서 복사한 엔드포인트 URL을 붙여넣습니다.

  12. 만료 기간 아래에서 절대 만료되지 않음을 선택합니다.

  13. 생성을 클릭합니다.

  14. 구독 섹션으로 이동하여 원하는 주제 이름을 클릭합니다.

  15. 주제 이름을 클립보드에 복사합니다.

  16. Google Play 콘솔에서 수익화 설정으로 이동하여 Google Play 청구 섹선의 주제 이름 필드에 이전 단계에서 복사한 주제 이름을 붙여 넣습니다.

  17. 알림 내용에 대해 구독, 무효화된 구매 및 모든 일회성 제품을 선택합니다.

  18. 변경 사항 저장(Save changes)을 클릭합니다. 이 효과가 나타나기까지 시간이 걸릴 수 있습니다(때로는 24시간까지도). 따라서 테스트하기 전에 기다리십시오.

2.3 Google Play Console에서 테스트 알림을 보냅니다.

Google Play 실시간 개발자 알림(RTDN)이 AppsFlyer에 올바르게 수신되는지 확인하려면 Google Play Console에서 테스트 알림을 보내십시오:

  1. 테스트 알림 보내기를 클릭하십시오. 이것은 AppsFlyer에 구성된 Pub/Sub 주제로 테스트 RTDN 메시지를 전송합니다.

    image (16).png
  2. Google Play 결제 아래에서 주제 이름 섹션을 찾으십시오.
  3. 왼쪽 메뉴에서 Play로 수익 창출 → 수익 창출 설정로 이동하십시오.
  4. Google Play Console로 이동하십시오.

2.4 AppsFlyer에서 알림 전달 확인

  1. 테스트가 성공하거나 진행할 준비가 되면 저장 및 다음을 클릭하십시오.
  2. 결과: AppsFlyer는 지난 7일 동안 수신된 알림이 있는지 표시합니다.
    • 성공하면 인터페이스에 가장 최근 알림의 날짜와 시간이 표시됩니다.
    • 수신된 알림이 없으면 인터페이스에 지난 7일 동안 알림이 발견되지 않았다고 표시됩니다.
    • 상태가 나타나지 않으면 Pub/Sub 구성을 검토하고 테스트 알림을 다시 전송하십시오.
  3. Google Play 서버 알림 단계에서 통합 테스트를 클릭하십시오.

3단계: SDK 커넥터 구현

이 단계에서는 개발자가 AppsFlyer 구매 SDK 커넥터를 통합하고 테스트를 위한 샌드박스 환경을 구성하도록 준비시킵니다.

SDK 커넥터를 구현하려면 다음 단계를 따르십시오:

  1. SDK 커넥터 구현 단계에서 대시보드에 표시된 미리 작성된 메시지를 복사하십시오.
  2. 이를 개발자에게 전송하십시오. 여기에는 다음이 포함됩니다:
    • 앱 이름 및 앱 ID
    • SDK 통합 가이드에 대한 링크.
    • 샌드박스 환경을 구성하는 지침 (sandbox = true)
    • 테스트 단계 (사용 중 TestFlight)

이 메시지는 개발자가 통합을 완료하고 테스트를 시작하는 데 필요한 모든 정보를 제공합니다.

참고

커넥터는 자동 거래 감지를 사용합니다. 대안으로, 각 거래를 수동으로 기록하기 위해 validateAndLog SDK 메서드를 구현할 수 있습니다. 이 방법은 커넥터에서 사용할 수 있는 모든 기능을 지원하지 않습니다. 두 SDK 통합 옵션에 대한 자세한 내용은 DevHub 문서를 참조하십시오.

4단계: SDK 구현 확인

샌드박스 환경에서 인앱 구매 및 구독 수익 통합을 테스트하여 SDK 커넥터가 올바르게 통합되었는지 확인하고 서버 알림이 적절하게 구성되어 AppsFlyer에 의해 수신되는지 확인하십시오.

테스트 SDK 구현

지난 7일 동안 귀하의 앱에서 AppsFlyer가 유효한 구매 및 구독 이벤트 페이로드를 수신했는지 확인하려면 다음 단계를 수행하십시오:

  1. SDK 구현 확인 단계에서 SDK 구현 테스트를 클릭하십시오.
  2. 결과를 검토하고, AppsFlyer가 수신한 가장 최근 페이로드의 타임스탬프를 포함합니다.

    참고

    이 테스트는 요청이 AppsFlyer에 도달하고 있음을 확인할 뿐이며 데이터의 완전성이나 정확성을 검증하지 않습니다.

  3. 구현을 완전히 검증하려면 아래의 테스트 단계를 계속 진행하십시오.

샌드박스 이벤트 및 매개변수

  • SDK 커넥터는 초기 샌드박스 거래에 대해서만 이벤트를 생성합니다:
    • 인앱 구매
    • 구독
  • AppsFlyer는 원래 거래에 대한 SDK 이벤트가 기록된 경우에만 서버 알림을 처리합니다.
    • 인앱 구매 (IAP)
    • 구독 S2S: af_ars_sandbox_s2s
  • SDK가 원래 거래를 기록하지 않으면 S2S 이벤트가 생성되지 않습니다.

iOS 고려 사항

  • af_purchase_sandbox_sdk이 af_sandbox_revenue를 포함하는 경우, 이는 프로덕션 af_purchase에 매핑됩니다.
  • 수익이 없으면, 생산 af_purchase_free에 매핑됩니다.

안드로이드 고려사항

  • 라이센스 테스터의 구매는 항상 샌드박스 이벤트를 생성합니다. 샌드박스 모드가 SDK에 구성되어 있지 않더라도 말입니다.

테스트 이벤트를 위한 필수 매개변수

모든 샌드박스 구매 이벤트에 다음이 포함되도록 하십시오:

  • 수익 = 0 (실제 보고서에 영향을 주지 않도록).
  • af_sandbox_revenue = 실제 제품 가격 (정확한 수익이 귀속되도록).
  • af_validated = true. false가 돌아가서 스토어 키를 확인하십시오.
  • af_validation_type = receipt_validation.

인앱 구매 및 구독 수익 측정

선행 조건:

  • iOS의 경우, App Store Connect의 앱 스토어 서버 알림에서 앱스플라이어 엔드포인트가 샌드박스 서버 URL로 구성되어 있는지 확인합니다.

인앱 구매 및 구독 수익 측정

  1. 개발자에게 Android , iOS  및 Unity 지침에 따라 SDK 커넥터에서 샌드박스 환경을 구성하도록 지시합니다.
  2. 테스트 구매를 하거나 구글 플레이의 라이센스 테스터를 사용하여 구독을 시작하십시오. iOS의 경우, 테스트플라이트를 사용하십시오. 참고: 구독 제품은 장치당 한 번만 테스트할 수 있습니다. 실제로, 장치는 동일한 구독의 여러 테스트 구매를 등록할 수 없습니다. 추가 시도는 기록되지 않습니다.
  3. 구글 플레이의 라이센스 테스터와 iOS의 테스트플라이트를 사용하여 테스트 환불, 구독 갱신 또는 구독 취소 이벤트를 만드십시오. 참고: 구독 제품을 테스트하는 경우, AppsFlyer가 스토어로부터 서버 알림을 수신할 시간을 허용하십시오. 이는 일반적으로 최초 구매 후 몇 분 이내에 발생합니다.
  4. SDK 커넥터 구현 확인 단계에서 SDK 구현 테스트.를 클릭하십시오. 지난 7일 동안 Purchase Connector로부터 성공적으로 수신된 SDK 페이로드가 있는지를 나타냅니다.
  5. 테스트 이벤트가 다음 방법 중 하나로 표시되는지 확인하십시오:

  6. 이벤트가 AppsFlyer 활동 대시보드에 나타나는지 확인하십시오. AppsFlyer에서 분석 > 활동으로 이동하고, 활동 추세 차트에서 인앱 이벤트 탭을 열고 테스트할 이벤트를 선택하십시오. 자동 갱신 구독 구매는 af_ars_s2s_sandbox이라고 합니다. 이벤트에는 다음이 포함됩니다:
    • 수익 값 0(실제 앱스플라이어 리포트를 왜곡하지 않기 위해 필요).
    • 구매한 제품의 수익 가치를 포함하는 af_sandbox_revenue 매개변수로, 올바른 수익이 보고되도록 합니다.
       

5단계: 설정을 확인하고 업데이트하십시오.

위의 설정 구성을 완료하고 마지막 단계를 저장한 후, 활성 구성 보기로 리디렉션되며, 다음 설정을 확인하거나 업데이트할 수 있습니다:

  1. 앱 스토어로 구매 확인 토글이 켜져 있는지 확인하십시오.
  2. 구매 아래의 다음 옵션을 확인하십시오:
    • 깨끗한 데이터를 위해 중복 구매를 방지하십시오. 이미 보고된 거래를 기록하지 않습니다.
    • 환불, 취소 및 부정 수익을 자동으로 측정합니다. 환불 관련 이벤트를 측정하고 이를 부정적인 수익으로 기록합니다.
    • 가족 공유로 인한 수익 중복 계산을 피하십시오. 가족 공유로 인한 중복 수익을 방지합니다. 이 이벤트는 purchase_ownership_type=FAMILY_SHARED로 표시되며 수익이 0으로 보고됩니다.
  3. 자동 갱신 구독에 대한 수익 측정 및 귀속 토글이 켜져 있는지 확인하십시오:
  4. 다음 설정의 상태:
    • 앱 스토어 키 설정
    • 서버 알림 엔드포인트 설정
    • SDK 커넥터 구현 및 테스트

5단계: SDK 커넥터를 사용한 앱 버전 출시

이전 단계에서 모든 것이 구성되고 AppsFlyer 구매 SDK 커넥터가 앱에 통합된 상태에서, 개발자에게 SDK 커넥터가 통합된 앱 버전을 출시하도록 지시하십시오.

그러나 개발자가 새로운 앱 버전을 출시하기 전에 다음 사항을 확인하십시오:

  • IAP 또는 구독으로 캡처하려는 인앱이벤트는 앱스플라이어에서 구성한 유효성 검사 규칙 중 하나에 의해 차단되지 않습니다.
  • 개발자는 거짓으로 표시된 샌드박스 플래그를 가지고 있어야 합니다.

SDK 커넥터가 포함된 앱이 출시되면, 앱 내 구매 및 구독 이벤트가 생성되어 모든 AppsFlyer 대시보드에서 사용할 수 있으며, 수익 ETL을 포함한 집계 및 원시 데이터 보고서에서도 제공됩니다.

참고: 이벤트는 SDK 커넥터가 포함된 앱 버전으로 업데이트한 사용자에게만 생성됩니다. 그 결과, 업데이트된 앱 버전이 완전히 채택될 때까지 앱의 수익 데이터와 스토어 데이터 간에 불일치가 예상됩니다.

ROI360 스토어 수익으로 전환(영수증 검증에서)

영수증 검증을 위한 온보딩을 완료했지만 ROI360 스토어 수익 제품을 활성화하려면 다음을 수행하십시오:

  1. AppsFlyer에서 사이드 메뉴에서 설정을 열고 ROI360 아래에서 수익 설정을 선택합니다.
  2. 구매 및 구독 탭을 엽니다. ROI360이 사용 가능하지만 활성화되지 않았다는 배너가 나타납니다.
  3. 제품 비교 보기를 클릭하여 환불 귀속, 순수익 보고 및 전체 구독 생애 주기 측정을 포함한 이점을 이해합니다.
  4. ROI360 활성화.를 클릭합니다.
  5. 앱 스토어 서버 알림 활성화 단계를 수행합니다. 자세한 내용은 앱 스토어 서버 알림 설정 또는 구글 플레이 서버 알림 설정을 참조하십시오.
  6. 구매 및 구독 섹션에서 제품 유형이 이제 ROI360으로 설정되었는지 확인합니다.
  7. 필요한 ROI360 스토어 수익 기능을 지원할 수 있도록 현재 SDK 설정을 검토하십시오.

참고

ROI360 스토어 수익은 두 가지 통합 방법을 지원합니다: 구매 SDK 커넥터 및 검증 및 기록. 두 가지 중에서 구매 SDK 커넥터를 사용하는 것이 좋습니다.

  • 자동 거래 감지
  • 기존 구독자(통합 이전에 구독한 사용자)로부터의 수익 측정
  • 구독 가격 변경 지원, 가격 업데이트가 발생할 때 정확한 수익 보고를 보장합니다.

이 기능이 필요하지 않다면, 대신 검증 및 기록 통합을 계속 사용할 수 있습니다.

SDK 통합 방법 확인하기

앱이 Purchase SDK 커넥터 또는 검증 및 기록을 사용하는지 확인하려면:

  1. SDK 커넥터 통합 단계로 이동하세요.
  2. SDK 통합 테스트를 클릭하세요. 최근 7일 이내에 AppsFlyer가 수신한 최신 SDK 페이로드와 그것이 Purchase SDK 커넥터 또는 검증 및 기록에서 유래했는지를 확인할 수 있습니다.