iOS Signature 라이브러리 연동
Adjust 의 SDK 라이브러리는 Adjust SDK 를 위한 독립형 플러그인으로 설계되었습니다. 즉, 코드를 변경하거나 앱에서 Adjust SDK를 사용하는 방식을 변경할 필요가 없습니다. 플러그인을 설치하면 Adjust SDK의 모든 요청이 계속해서 정상적으로 작동할 것입니다.
시작하기 전에
Adjust Signature 라이브러리를 iOS 앱에 연동하려면 다음을 확인하시기 바랍니다.
- 사용 중인 Adjust SDK 버전이 4.35.2 이상입니다.
- 테스트를 진행하기 전에 앱이 샌드박스 모드 에서 작동하는지 확인하시기 바랍니다.
Signature v1 또는 v2 라이브러리에서 마이그레이션
이전에 Signature v1 또는 Signature v2를 사용한 경우, Signature 라이브러리를 연동하기 전에 이전 버전을 삭제해야 합니다. 다음을 수행하시기 바랍니다.
- 이전에 Signature v1을 연동한 경우, 프로젝트에서 Signature 함수를 호출하는 모든 코드를 삭제합니다.
- 이전에 Signature v2를 연동한 경우, 프로젝트에서 Signature v2 라이브러리를 삭제합니다.
연동 단계
iOS 프로젝트에 Signature 라이브러리를 연동하려면 다음의 단계를 수행하시기 바랍니다.
- GitHub에서
AdjustSigSdk-iOS-tvOS-Dynamic-3.13.0.xcframework.zip아카이브를 다운로드합니다. - 아카이브의 압축을 풀고
AdjustSigSdk.xcframework를 프로젝트 디렉토리에 복사합니다. - Xcode의 Project Navigator 에서 프로젝트를 선택합니다.
- 왼쪽에서 타겟을 선택합니다.
- General 탭을 선택하고, Frameworks, Libraries and Embedded Content 그룹을 확장합니다.
- 그룹 하단의 + 버튼을 선택합니다.
- 기타 추가 > 파일 추가 를 선택하고 프로젝트 디렉토리에서
AdjustSigSdk.xcframework파일을 선택합니다.
AdjustSigSdk.xcframework에 대해 Embed & Sign 옵션을 선택합니다.
이제 끝입니다! 이제 Signature 라이브러리가 프로젝트에 연동되었습니다.
앱 테스트
Adjust 테스팅 콘솔 을 사용하여 서명 라이브러리가 앱에 연동되었는지 확인할 수 있습니다.
Adjust SDK가 Sandbox 모드 에서 작동하는지 확인하시기 바랍니다.
Signature 라이브러리 연동 테스트 방법:
설치 정보가 전송될 수 있도록 테스트 기기에서 앱을 완전히 삭제하시기 바랍니다.
테스팅 콘솔을 사용하여 해당 기기의 정보를 삭제하시기 바랍니다. 앱 토큰과 Adjust InSights 앱( iOS 및 Android 에서 이용 가능)에서 얻은 광고 ID를 전달하여 forget_device 엔드포인트를 사용할 수도 있습니다. 다음의 광고 ID 또한 사용이 가능합니다:
adid,android_id,gps_adid,idfa,idfv,imei,oaid.콜은 다음과 같습니다.
curl -X POST 'https://app.adjust.com/forget_device?app_token={yourAppToken}&id={adid}'테이스팅 콘솔에서 기기를 삭제한 뒤 테스트 기기에 앱을 설치하고 실행하여 설치 정보를 Adjust 에 전송합니다.
설치 이벤트 정보를 가져오기 위해 테스팅 콘솔에 테스트 기기의 광고 ID를 입력합니다. 다음을 확인하시기 바랍니다.
SignatureVerificationResult필드는Valid Signature의 값을 보여야 합니다.SignatureVersion필드는3의 값을 보여야 합니다.
이러한 필드가 있고 올바른 정보를 포함하고 있다면 서명 라이브러리가 성공적으로 연동된 것입니다. 필드에 다른 값이 표시되는 경우, 연동 단계를 다시 검토하거나 support@adjust.com에 연락하시기 바랍니다.
이제 끝입니다! 서명 라이브러리가 앱에 성공적으로 연동되었습니다. 2개의 어트리뷰션 윈도우가 지난 후에는 SDK 서명 검증을 적용 하여 Adjust가 서명된 요청만 수락하도록 할 수 있습니다.