어떻게 도와드릴까요?

검색

영수증 유효성 검사 설정

  • 업데이트 시간

한눈에 보기: 수수료 검증은 앱 내 구매 및 구독으로부터의 수익을 측정하고 앱 스토어와 확인하여 정확한 광고 지출 반환 (ROAS) 결과를 보장합니다.

개요

참고

수수료 검증에 대한 자세한 내용은, 어떻게 작동하고 AppsFlyer에서 활성화하는 방법을 포함하여, 수수수료 검증에 대해 참조하십시오.

Receipt validation을 설정하려면 다음 단계를 수행하십시오.

  1. 스토어 자격 증명을 설정합니다(iOS 및 Android)
    • iOS: AppsFlyer에서 App Store Connect 키(App 내 구매 키, 키 ID 및 발행자 ID)를 구성하여 Receipt 검증을 활성화합니다.
    • Android: Google Cloud 서비스 계정을 구성하고 Google Play 콘솔에서 필요한 권한을 설정하고 서비스 계정 JSON 키를 AppsFlyer에 업로드합니다.
  2. validateAndLog SDK API 구현: 개발자가 AppsFlyer validateAndLog SDK API를 통합하고 테스트를 위해 모래 상자 환경을 구성할 수 있도록 준비합니다.
  3. Test validateAndLog SDK API 구현: iOS 및 Android에서 샌드박스 테스트 구매 및 구독을 수행하여 Receipt 검증 이벤트가 AppsFlyer에서 생성되고 올바르게 기록되었는지 확인합니다.
  4. 설정 확인 및 업데이트: 제품 유형이 Receipt validation로 설정되어 있는지 확인하고 스토어 키 및 SDK 통합 상태를 검토하여 정확하고 지속적인 수익 측정을 보장합니다.
  5. validateAndLog SDK API를 사용하여 앱 버전을 출시합니다. validateAndLog SDK API가 통합되어 업데이트된 앱 버전을 출시하여 샌드박스 플래그가 비활성화되고 필요한 앱 내 이벤트가 검증 규칙에 의해 차단되지 않도록 합니다.

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

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

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

시작하기 전에:

  • 자격 증명을 설정하는 것은 App Store Connect 및 AppsFlyer에서 모두 수행되는 단계를 포함합니다. 설정 중에 App Store Connect 및 AppsFlyer 탭을 모두 열려 두십시오.
  • iOS 앱은 StoreKit v1 또는 v2를 필요로 하며, 이는 앱 내 구매 및 구독을 처리하는 프레임워크를 제공합니다.

1.1 App Store Connect 키 만들기

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

  1. App Store Connect에서 사용자 및 액세스로 이동합니다.

  2. 사용자 및 액세스 >> 통합으로 이동하고 키 목록에서 앱 내 구매을 선택합니다.

  3. + 를 클릭하여 새로운 앱 내 구매 키를 생성합니다.

  4. API 키의 이름을 입력합니다.
  5. 생성을 클릭합니다.
  6. 방금 생성한 키 옆에 있는 Download In-App Purchase Key 를 클릭하여 다운로드합니다. 참고: 키를 한 번만 다운로드할 수 있습니다.

  7. 방금 생성한 키의 키 ID를 복사하고 키 ID의 AppsFlyer 구매 및 구독 설정에 붙여넣습니다.

  8. 발행자 ID 복사 참고: 페이지 상단에 출판자 ID가 표시되지 않으면 App Store Connect API 키를 생성합니다(어떤 액세스 레벨이든). 그런 후, 앱 내 구매 키의 발행자 ID가 페이지 상단에 나타납니다.

1.2 App Store Connect 키 설정

  1. Receipt validation를 활성화합니다. #enable-receipt-validation
  2. App Store Connect keys 단계에서 App In-App Purchase 키 필드에서 Upload을 클릭하여 p8 파일을 업로드합니다.

  3. App Store Connect 키라는 섹션에서 App Store Connect에서 복사한 값을 붙여넣습니다.

    • 키 ID
    • *발급자 ID
  4. Validate keys 를 클릭하여 입력한 키가 정확한지 확인합니다. 참고: 앱이 App Store에 아직 게시되지 않은 경우 Validate keys 작업이 작동하지 않을 수 있습니다.
  5. 보관하고 다음을 클릭합니다.

단계 1 (Android). 서비스 계정 키 및 권한

단계 1에서 Google Play 및 Google Cloud에서 다음 자격 증명을 얻고 AppsFlyer 플랫폼의 수입 설정 페이지에 입력하십시오.

시작하기 전에:

  • 앱 내 구매 및 구독 수익 측정을 설정하는 것은 Google Cloud Platform, Google Play Console 및 AppsFlyer UI에서 수행되는 단계를 포함합니다. 우리는 세 곳의 모든 탭을 전체 설정 동안 열려있는 것을 권장합니다.
  • 앱스플라이어 UI를 설정하려면 관리자 권한이 필요합니다.

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

선행 조건: Google Play 콘솔 및 Google Cloud 프로젝트에 액세스할 수 있습니다.

Google Play 개발자 계정을 Google Cloud 프로젝트에 연결하려면 다음 단계를 수행하십시오.

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

  3. Google Play Developer API를 활성화합니다. 이에 대한 시침은 이 Google 도움말 항목을 참조하십시오.

1.2 Google Cloud 플랫폼에서 서비스 계정을 구성합니다.

선행 조건: Google Cloud 플랫폼에 대한 액세스.

서비스 계정을 구성하려면 다음 단계를 따르십시오.:

  1. 서비스 계정을 만들거나 찾으십시오.

    1. Google Cloud 플랫폼의 서비스 계정 섹션으로 이동하고 서비스 계정 만들기를 클릭합니다.
    2. 서비스 계정 세부 정보를 작성합니다.
    3. 이메일 주소를 복사합니다.
    4. 만들기 및 계속을 클릭합니다.
    5. 이 서비스 계정에 프로젝트에 대한 액세스 권한 부여 단계에서  Pub/Sub 구독자 역할을 선택합니다.

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

  2. 서비스 계정 개인 키 다운로드:

    1. Google 클라우드 플랫폼에서 서비스 계정 섹션으로 이동하여 원하는 계정(지금 만든 계정)을 목록에서 찾고 다른 작업 아이콘을 클릭합니다.
    2. 키 관리를 클릭합니다.

    3. 키 추가 > 새 키 만들기를 클릭합니다.

    4. Create private key 팝업에서 Key type 아래에서 JSON을 선택하고 Create를 클릭합니다.

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

    6. JSON 키 파일을 저장하고 나중에 AppsFlyer에 업로드하십시오. 참고! 당신은 열쇠를 저장해야합니다. 그것은 나중에 검색 할 수 없습니다. 그것을 저장하지 않으면 완전히 새로운 키를 생성해야 합니다.

1.3 Google Play 콘솔에서 API 액세스 권한 설정

선행 조건: Google Play 콘솔에 액세스할 수 있습니다.

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

Google Play 콘솔에서 API 액세스 권한을 설정하려면

  1. Google Play 콘솔에서 사용자 및 권한으로 이동하고, 만든 서비스 계정을 찾고 새 사용자 초대를 클릭합니다.

  2. 1.2.1.3 단계에서 서비스 계정을 구성할 때 복사한 메일 주소를 입력합니다.

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

  4. App 권한 탭에서 App 추가를 클릭한 다음 앱을 선택합니다. 필요한 경우 여러 앱을 추가합니다.

  5. Invite user 를 클릭합니다.

  6. 확인 팝업에서 시청 보내기를 클릭합니다.

1.4 서비스 계정의 개인 키를 AppsFlyer에 업로드

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

선행 조건: 관리자가 AppsFlyer에 액세스합니다.

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

  1. 수신 확인을 활성화합니다.
  2. 서비스 계정 키 및 권한 단계에서 Google JSON 키 업로드 필드에서 Upload 를 클릭합니다.
  3. 단계 1.2에서 다운로드 한 JSON 파일을 업로드하십시오.

  4. 유효성 검증 키를 클릭하세요. 참고:

    • 서비스 계정 사용자 인증 정보 및 권한을 설정한 후 사용가능할 때까지 시간이 걸릴 수 있습니다(경우에 따라 24시간까지). 이로 인해 키를 검증하거나 검증 테스트를 수행하려고 할 때 오류가 발생할 수 있습니다.
    • 24시간 대기 시간 주변에서 작업하려면 Google Play 콘솔에서 어떠한 애플리케이션에도 이동한 다음 모네티즈하기 > 제품 > 계약/애플리케이션 내 제품로 이동하여 변경을 수행합니다. 예를 들어 제품 설명을 편집하고 저장합니다. 이것은 일반적으로 즉시 계정 인증 및 권한을 업데이트합니다. 그런 다음 변경 내용을 취소할 수 있습니다.
  5. 다음을 클릭합니다. SDK 구현 단계가 열립니다.

2단계: 2. SDK V6을 구현합니다.

이 단계에서 개발자가 SDK validateAndLog API를 통합하고 테스트를 위해 모래 상자 환경을 설정할 수 있도록 준비합니다. 최신 validateAndLog API를 지원하는 최소 SDK 버전은 Android용으로는 6.17.5, iOS용으로는 6.17.8입니다.

validateAndLog SDK API를 구현하려면 다음 단계를 따르십시오.

  1. SDK 구현 단계에서 대시보드에 표시된 전문 메시지을 복사합니다.

  2. 개발자에게 보내십시오. 그것은 다음을 포함합니다:

    • 앱 이름 및 앱 ID
    • SDK 통합 가이드 링크입니다.
    • 모래 상자 환경(sandbox = true)을 구성하는 지침.
    • 테스트 단계(TestFlight 사용).

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

  3. 다음을 클릭합니다. Verify SDK implementation 단계가 열립니다.

3단계: SDK 구현 확인

샌드박스 환경에서 IAP 및 구독 수익 연동을 검증하여 SDK 커넥터가 제대로 연동되고 서버 알림이 올바르게 구성되고 AppsFlyer가 수신하는지 확인하는 것이 가장 좋습니다.

테스트 SDK 구현

AppsFlyer가 지난 7일 동안 앱에서 유효한 validateAndLog 페이로드를 받았는지 확인하려면 다음 단계를 수행하십시오.

  1. Verify SDK implementation 단계에서 Test SDK implementation 를 클릭합니다.
  2. AppsFlyer에서 수신한 최신 유용로드의 타임스탬프를 포함하여 결과를 검토합니다. 이 검사는 요청이 AppsFlyer에 도착하는지 확인할 뿐이며 데이터의 완전성이나 정확성을 확인하지 않습니다.
  3. 구현을 완전히 검증하려면 아래의 테스트 단계를 계속하십시오.

샌드박스 환경 고려 사항

샌드박스 환경에서:

  • 처음 구매 이벤트만 validateAndLog SDK API가 AppsFlyer에 의해 기록되는 이벤트를 생성합니다. 앱 내 구매 이벤트는 af_purchase_sandbox_sdk라고 합니다. 구독 이벤트는 af_ars_sandbox_sdk라고 불립니다.
  • Sandbox 이벤트는 0.
  • Android의 경우 SDK의 샌드박스 환경이 구성되지 않은 경우에도 License Tester가 테스트를 수행하면 샌드박스 이벤트가 발생합니다.

인앱 구매 및 구독 수익 측정

인앱 구매 및 구독 수익 측정

  1. 개발자에게 validateAndLog SDK API의 샌드박스 환경을 구성하도록 지시하십시오.
  2. Google Play의 라이센스 테스터 및 iOS의 TestFlight에서 테스트 구매 또는 구독을 수행합니다. 

  3. 테스트 이벤트가 다음 방법 중 하나로 표시되는 것을 확인합니다.

  4. 다음 테스트 이벤트를 찾으십시오.

    • 구매 이벤트의 af_purchase_sandbox_sdk.
    • 구독 이벤트의 af_ars_sandbox_sdk.

  5. 테스트 이벤트에는 다음 사항이 포함되어 있는지 확인하십시오.

    • 수익 값 0(실제 앱스플라이어 리포트를 왜곡하지 않기 위해 필요).
    • 구입한 제품의 수익 가치를 포함하는 af_sandbox_revenue 매개 변수로, 올바른 수익을 보고할 수 있습니다.
    • af_validated 매개 변수는 true입니다. af_validated가 false인 경우 - 위의 단계 2로 돌아가서 상점에서 제공한 키를 검증하십시오.
    • af_validation_type 매개 변수는 receipt_validation입니다.

4단계: 설정 확인 및 업데이트

위의 설정 구성을 완료하고 위의 단계를 저장한 후 활성 구성 보기로 리디렉션됩니다. 여기에서 다음 설정을 확인하거나 업데이트할 수 있습니다.

  1. 제품 유형이 전지 확인인지 확인합니다.
  2. App Store에서 구매 확인이 켜져 있는지 확인하십시오.

  3. 다음 설정을 확인하거나 업데이트합니다.

    • App Store 키 설정
    • SDK 통합 설정

5단계: validateAndLog SDK API를 사용하여 앱 버전을 출시합니다.

이전 단계의 모든 것을 구성하고 AppsFlyer validateAndLog SDK API가 앱에 통합되면, 개발자에게 validateAndLog SDK API가 통합되어 앱 버전을 출시하도록 알려줍니다.

개발자가 새로운 앱 버전을 출시하기 전에 다음을 확인하십시오.

  • IAP 또는 구독으로 캡처하려는 인앱이벤트는 앱스플라이어에서 구성한 유효성 검사 규칙 중 하나에 의해 차단되지 않습니다.
  • 개발자는 모든 샌드박스 플래그를 false로 설정했습니다.

validateAndLog SDK API가 포함된 앱이 출시되면 모든 AppsFlyer 대시보드 및 집계 및 원자 데이터 보고서에서 APP 내 구매 및 구독 이벤트 가 생성되고 사용할 수 있습니다.

이벤트는 validateAndLog SDK API가 포함된 앱 버전으로 업데이트한 사용자에게만 생성됩니다. 따라서 업데이트된 앱 버전이 완전히 적용될 때까지 앱의 수익 데이터와 스토어 데이터 간에 차이가 발생할 것으로 예상됩니다.

Tags