앱에 대한 결제 검증 설정

결제 검증을 시작하려면 앱에 Adjust SDK가 올바르게 설정되었는지 확인하고, Adjust에 해당 스토어에서의 결제를 승인하는데 필요한 인증 정보를 제공해야 합니다.

시작에 앞서

성장 솔루션:

결제 검증은 Adjust Growth 솔루션의 일부로 이용하실 수 있습니다. 본 기능을 패키지에 추가하시려면 Adjust 담당자나 sales@adjust.com 으로 문의하시기 바랍니다.

요구 사항

  • Adjust에서 관리자, 편집자 또는 커스텀 편집자 권한
  • 앱 스토어 인증 정보 생성 및 관리
    • Google Cloud: 프로젝트 또는 서비스 계정에 대한 Service Account Key Admin 역할
    • App Store Connect: Admin 권리.

확인 사항

  • 결제 검증은 Google Play Store나 Apple App Store에서 이루어진 인앱 결제에 대해서만 사용됩니다. 그 외 물리적 아이템의 결제는 지원하지 않습니다.
  • iOS, Android, Unity 앱에서 사용하실 수 있습니다.

1. Adjust SDK 설정하기

Adjust 결제 검증을 앱에 연동하려면, 최소 필수 SDK 버전이 설치되어 있고 구매 매출 이벤트 전송에 필요한 연동 단계를 모두 완료해야 합니다.

2. 앱 스토어 인증 정보 찾기

Store와 구매를 확인하려면 계정 매칭에 사용될 수 있는 특정 인증 정보를 Adjust에 제공해야 합니다.

Android:

인증 파라미터정의예시
JSON KeyGoogle Cloud Console의 서비스 계정 페이지에서 다운로드된 JSON Key.example_key_file

iOS:

인증 파라미터정의예시
Issuer IDApp Store Connect의 API 키 페이지에 있는 Issuer ID.57246542-96fe-1a63-e053-0824d011072a
Key IDApp Store Connect의 API 키 페이지에 있는 private key ID.2X9R4HXF34
인앱 구매 API KeyApp Store Connect에서 다운로드한 P8 API Key App Store Server API로부터의 앱 데이터에 대한 액세스를 승인합니다. -----BEGIN PRIVATE KEY-----
MIGTAgEAMBMGByqGSM49AgEGCCqGSM49AwEHBHkwdwIBAQQgNxUqm0R2vt4IrLAQr9gfDPixwSxH9wJZ6NV3X0ax4eWgCgYIKoZIzj0DAQehasda2ANCAAQx53AlofI4Of54lbR04A6D2QMbe0mt8+JtRHkJJCEUesUfySoZsm2jeh3qodLE0pZ2Rayv26qFMKuKEwemB2Op
-----END PRIVATE KEY-----

필요한 인증 정보를 찾으려면 스토어 플랫폼별 설명을 참조하시기 바랍니다.

안드로이드

프로젝트 또는 서비스 계정에 대한 서비스 계정 키를 생성하려면 사용자 계정에 서비스 계정 키 관리자 권한이 있어야 합니다.

Google Play Android 개발자 API 활성화하기

  1. Google Play Console에서 API & Services 로 이동합니다.
  2. + Enable APIs and Services 를 선택합니다.
  3. Mobile 영역에서 Google Play Android Developer API 를 선택합니다.
  4. Enable 을 선택합니다.
  5. 필요한 API 인증 정보를 설정합니다.
    1. Enabled APIs & Services 영역에서 Google Play Android Developer API 를 선택합니다.
    2. Create Credentials 을 선택합니다.
    3. Select an API에서 Google Play Android Developer API 를 선택합니다.
    4. What data will you be accessing?에서 Application data 를 선택합니다.
    5. Next를 선택합니다.

서비스 계정 생성하기

  1. Google Cloud에서 Create service account로 이동합니다.

  2. Google Cloud 프로젝트를 선택합니다.

  3. 서비스 계정 이름을 입력합니다.

    • 서비스 계정 ID가 자동으로 생성됩니다.
  4. 선택 사항: 서비스 계정 설명을 입력합니다.

  5. Create and Continue 를 선택합니다.

  6. 프로젝트에 서비스 계정 액세스를 부여합니다.

    1. 서비스 계정에 Pub/Sub Admin 권한을 지정합니다.
    2. + Add another role 을 선택합니다.
    3. 서비스 계정에 Monitoring Viewer 권한을 지정합니다.
    4. 계속 을 선택합니다.
    5. 선택: 해당 서비스 계정에 대한 사용자 액세스를 부여합니다.
    6. 완료 를 선택합니다.

새 API Key 생성하기

  1. Google Cloud에서 IAM & Admin 으로 이동합니다.
  2. Service Accounts 를 선택하여 프로젝트의 서비스 계정을 확인합니다.
  3. 생성한 서비스 계정에서 Actions (점 3개 아이콘)을 선택합니다.
  4. Manage keys 를 선택합니다.
  5. Add Key > Create new key 를 선택합니다.
  6. Key 유형에서 JSON 을 선택합니다.
  7. Private Key가 자동으로 다운로드됩니다.

for ios

API Key를 생성 및 관리하려면 App Store Connect에서 Admin 권한이 필요합니다.

Issuer ID 찾기

  1. App Store Connect에서 Users and Access 아이콘을 선택합니다.
  2. 연동 탭을 선택합니다.
  3. 왼쪽의 Key Type 메뉴에서 In-App Purchase 를 선택합니다.
  4. 페이지 상단의 Issuer ID 옆에 있는 Copy를 선택합니다.

새 API Key 생성하기

Adjust는 Adjust 인앱 매출 검증 전용 API Key를 생성하는 것을 권장합니다.

+ Generate API Key를 선택합니다.

1/4
  1. Generate API Key 또는 + 아이콘을 선택하여 새 Key를 생성합니다.

    • App Store Connect 계정에서 API 액세스를 아직 요청하지 않았다면 요청을 완료합니다.
  2. Name 필드에 Key의 이름을 입력합니다.

  3. Generate 을 선택합니다.

  4. 새 API Key가 Key ID와 함께 활성 Key 목록에 나타납니다.

  5. 생성한 키에서 키 ID 열의 값 위에 마우스를 가져갑니다. Copy Key ID 링크를 선택합니다.

  6. Download In-App Purchase Key 를 선택합니다.

  7. 계속하려면 Download 를 선택합니다.

  8. 다운로드한 파일에서 전체 API Key를 복사합니다.

3. iOS: Adjust와 App Store Connect 연결하기

다음의 단계를 수행하여 Adjust 대시보드에서 App Store Connect 인증 정보를 추가하시기 바랍니다.

  1. Adjust에서 DataWorks > 연결 로 이동합니다.
  2. + 새 연결 을 선택합니다.
  3. 목록에서 App Store Connect(In-App Purchase) 를 선택합니다.
  4. 서비스에서 결제 검증 을 선택합니다.
  5. Issuer ID 를 입력합니다.
  6. Key ID 를 입력합니다.
  7. .p8을 문서 편집기에서 열고, Private key 전체를 복사합니다. 이를 Private key 영역에 붙여넣기 합니다.

4. 앱에 결제 검증 추가하기

이제 앱에 결제 검증을 적용합니다.

  1. Adjust에서 AppView 로 이동하여 앱을 선택합니다.

  2. 보호 탭으로 이동합니다.

  3. 결제 검증 에서 편집 ()을 선택합니다.

  4. 결제 검증 토글을 ON 으로 설정합니다.

  5. 플랫폼별 정보를 제공합니다.

    • iOS 앱: iOS 앱의 경우, 사용할 App Store Connect 계정을 선택해야 합니다.
    • Android 앱: 이전에 다운로드한 JSON Key 파일을 업로드합니다.
  6. 저장 을 선택합니다.

모든 설정이 완료되었습니다!

검증된 매출 데이터를 파트너와 공유

Adjust의 구매 검증 솔루션을 사용하면 검증된 매출 데이터만 파트너와 공유되도록 할 수 있습니다. 즉, 공유되는 데이터와 캠페인 최적화에 사용되는 데이터에 대해 확신을 가질 수 있습니다.

Adjust 대시보드에서 파트너와의 인앱 매출 공유를 이미 설정한 경우, 별도의 변경이 필요하지 않습니다. Adjust는 verified passed 상태의 매출 데이터만을 자동으로 전송합니다.

새 파트너를 설정하고 검증된 인앱 매출 공유를 활성화하려면, Campaign Lab의 광고 네트워크 설정 가이드를 참조하시기 바랍니다. 데이터 공유 옵션을 선택 하는 단계에서 인앱 매출 을 선택하시기 바랍니다.

참고:

올바르지 않은 인증 정보 입력, 이중 암호화 또는 기타 구성 문제로 인해 이벤트가 검증을 통과하지 못할 수 있으므로 설정이 올바른지 확인하는 것이 중요합니다.