adjust-icon

SDK Signature(SDK 서명) 라이브러리 연동

Adjust의 SDK Signature(SDK 서명) 라이브러리는 Adjust SDK의 독립형 플러그인으로 설계되었습니다. 따라서 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방법을 변경할 필요가 없습니다. 플러그인 설치 후에는 Adjust SDK에서 생성된 모든 요청이 계속 정상적으로 작동합니다.

Before you begin

Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다.

  • 사용 중인 Adjust SDK 버전이 4.35.2 이상 이어야 합니다. 이 요건은 Adjust SDK가 간접적으로 사용되는 경우에도 적용됩니다.
  • iOS 또는 tvOS 버전 12 이상 이 지원됩니다.

Migrating from Signature v1 or v2 library

이전에 Signature v1 또는 Signature v2를 사용한 적이 있다면 Signature 라이브러리를 연동하기 전에 이전 버전을 제거해야 합니다. 다음 조치를 수행하시기 바랍니다.

  • 이전에 Signature v1을 연동한 경우 프로젝트에서 서명 함수를 호출하는 모든 코드를 제거합니다.
  • 이전에 Signature v2를 연동한 경우 프로젝트에서 Signature v2 라이브러리를 제거합니다.

Updating the Signature Library

Adjust Signature 라이브러리를 업데이트하려면 기존의 Signature 라이브러리를 새 버전으로 교체하고 테스트를 다시 실행하시기 바랍니다. Adjust에서 앱 로직이나 설정을 즉시 변경할 필요는 없습니다. 시크릿 ID가 다음 기준에 부합하는 경우 반드시 비활성화하시기 바랍니다.

  • 더 이상 설치 리포트에 필요하지 않는 경우.
  • 모든 앱 플랫폼 및 스토어에서 새로운 앱 버전을 출시

Integrate the signature library (SDK v4 only)

다음 단계에 따라 iOS 프로젝트에서 서명 라이브러리를 연동하십시오.

  1. GitHub에서AdjustSigSdk-iOS-tvOS-Dynamic.xcframework.zip 아카이브를 다운로드합니다.
  2. 아카이브를 압축 해제하고 AdjustSigSdk.xcframework를 프로젝트의 디렉터리에 복사합니다.
  3. Xcode의 Project Navigator 에서 프로젝트를 선택합니다.
  4. 왼쪽에서 타겟을 선택합니다.
  5. General(일반) 탭을 선택하고 Frameworks, Libraries(프레임워크, 라이브러리) 및 Embedded Content(삽입 콘텐츠) 그룹을 확장합니다.
  6. 그룹 아래쪽의 + 버튼을 선택합니다.

Xcode의 프레임워크 페이지 스크린샷

  1. Add Other(기타 추가) —> Add Files(파일 추가) 를 선택한 다음 프로젝트 디렉터리에서 AdjustSigSdk.xcframework 파일을 선택합니다.

Xcode의 프레임워크 셀렉터 스크린샷

  1. AdjustSigSdk.xcframework에 대해 Embed & Sign(삽입 및 서명) 옵션을 선택합니다.

Xcode의 Embed & Sign(삽입 및 서명) 옵션 스크린샷

이제 끝입니다! Signature 라이브러리가 프로젝트에 연동되었습니다.

Test your app

Adjust 테스팅 콘솔을 사용하여 Signature 라이브러리가 앱에 연동되었는지 확인할 수 있습니다.

다음과 같이 서명 라이브러리 연동을 테스트합니다.

  1. 설치 정보가 전송되도록 테스트 기기에서 앱을 완전히 삭제합니다.

  2. 테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다. adid, idfa, idfv, imei, oaid

    호출은 다음과 같습니다.

    Terminal window
    $ curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}'

  3. 테스팅 콘솔에서 기기를 삭제한 후에 테스트 기기에 앱을 설치한 다음 실행하여 Adjust로 설치 정보를 전송합니다.

  4. 테스팅 콘솔에 테스트 기기의 광고 ID를 입력하여 설치 이벤트 정보를 불러옵니다. 다음 내용을 확인하시기 바랍니다.

    1. SignatureVerificationResult 필드에 다음 값이 표시되어야 합니다. Valid Signature
    2. SignatureVersion 필드에 다음 값이 표시되어야 합니다. 3

이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 support@adjust.com에 연락하시기 바랍니다.

이제 끝입니다! 서명 라이브러리가 앱에 성공적으로 연동되었습니다. 어트리뷰션 윈도우 2개가 완료되면 SDK Signature(SDK 서명) 검증을 시행하여 서명된 요청만 Adjust에서 수락하도록 할 수 있습니다.