Cordova SDK 연동 가이드

Adjust Cordova SDK를 사용하면 Cordova 앱에서의 어트리뷰션, 이벤트 등을 측정할 수 있습니다. 본 가이드의 단계를 수행하여 Adjust SDK와 연동되도록 앱을 설정하시기 바랍니다. 이에 대한 예시는 GitHub에서 확인하실 수 있습니다.

1. 프로젝트에 SDK 추가

Adjust Cordova SDK는 npm에서 플러그인으로 이용 가능합니다. 프로젝트에 추가하려면 다음을 수행하시기 바랍니다.

Cordova 플러그인

Cordova 플러그인에 Adjust Cordova SDK를 추가하려면 다음 명령을 실행합니다.

> cordova plugin add com.adjust.sdk
Fetching plugin "com.adjust.sdk" via npm
Installing "com.adjust.sdk" for android
Installing "com.adjust.sdk" for ios

Ionic

앱을 빌드할 때 Ionic을 사용하는 경우 다음 명령을 실행하여 awesome-cordova-plugins 리포지토리로부터 SDK를 추가합니다.

> npm install @awesome-cordova-plugins/adjust --save
> ionic cordova plugin add com.adjust.sdk

2. Android 기기 설정

권한 추가

Adjust SDK에는 com.google.android.gms.AD_ID 권한이 기본값으로 포함됩니다. 앱이 COPPA 준수 대상이거나 Google 플레이 스토어를 타겟으로 하지 않는 경우, android.permission.INTERNET를 추가하여 이 권한을 제거할 수 있습니다.

<config-file target="AndroidManifest.xml" parent="/manifest">
  <uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove" />
</config-file>

설치 리퍼러 설정

Adjust SDK는 기본 설정에 따라 Google Play Referrer API 에 대한 지원을 활성화합니다. Huawei 리퍼러 API와 Meta 설치 리퍼러는 Android용 플러그인으로 제공됩니다. 관련 문서를 참조하여 Android 앱에 대한 플러그인을 설정하시기 바랍니다.

Meta 리퍼러 연동

Meta 설치 리퍼러를 활성화하려면 AdjustConfig 인스턴스에서 Meta 앱 ID를 설정해야 합니다. 이를 위해 다음을 수행하시기 바랍니다.

앱 대시보드에서 Meta 앱 ID를 확인합니다. 자세한 내용은 Meta의 앱 대시보드 문서를 참조하시기 바랍니다.

앱 ID를 AdjustConfig 인스턴스의 setFbAppId 메서드에 전달합니다.

var adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
adjustConfig.setFbAppId("FB_APP_ID");
Adjust.initSdk(adjustConfig);

3. iOS 프레임워크 추가

Adjust SDK는 iOS 기기에서 아래의 프레임워크를 자동으로 연결합니다.

프레임워크	설명	참고 사항
`AdSupport.framework`	디바이스 IDFA에 대한 액세스와, iOS 14 이하 버전의 기기에서 LAT에 대한 액세스도 활성화합니다.	앱이 “아동” 카테고리를 타겟으로 하는 경우 이 프레임워크를 추가하지 않습니다.
`AdServices.framework`	Apple 검색 광고 어트리뷰션 처리
`StoreKit.framework`	SKAdNetwork 프레임워크에 대한 액세스 활성화	Adjust SDK가 iOS 14 이상 버전의 기기에서 SKAdNetwork와의 커뮤니케이션을 처리하도록 허용하기 위해 필요합니다.
`AppTrackingTransparency.framework`	Adjust SDK가 iOS 14 이상 버전의 기기에서 사용자 트래킹 동의 다이얼로그 및 액세스 동의 응답을 래핑하도록 허용하기 위해 필요합니다.	앱이 “아동” 카테고리를 타겟으로 하는 경우 이 프레임워크를 추가하지 않습니다.

4. SDK 서명 설정

SDK v5는 SDK Signature 라이브러리 를 포함합니다. iOS 와 Android 용 테스트 가이드를 참조하여 연동이 잘 되는지 확인하시기 바랍니다.

서명 보호는 기본 설정에 따라 비활성화되어 있습니다. 활성화하려면 다음이 필요합니다.

Signature 검증 시행.
테스트하기 전에 앱의 SHA-1 핑커프린트를 제공합니다.

5. Adjust SDK 초기화

Flutter 앱에서 최대한 빨리 Adjust SDK를 초기화하시기 바랍니다. 이를 위해 다음을 수행하시기 바랍니다.

다음 인수를 사용하여 AdjustConfig 객체를 인스턴스화합니다.
- appToken: Adjust 앱 토큰입니다.
- environment: 앱이 실행 중인 환경. 로컬에서 앱을 테스트하려면 이 값을 AdjustConfig.EnvironmentSandbox 로 설정하시기 바랍니다.
AdjustConfig 인스턴스를 Adjust.initSdk 메서드에 전달하여 SDK를 초기화합니다.

var adjustConfig = new AdjustConfig(
   "{YourAppToken}",
   AdjustConfig.EnvironmentSandbox,
);
Adjust.initSdk(adjustConfig);

6. 앱 빌드

잘하셨습니다! 이제 Cordova 앱을 빌드하고 실행할 수 있을 것입니다. 로깅을 실행하여 문제가 있는지 확인합니다. 로그를 검토하여 Install tracked 메시지를 확인합니다.

Adjust SDK를 통해 사용자 어트리뷰션을 시작할 수 있습니다.

7. 연동 테스트

Adjust SDK는 연동 테스트와 문제 해결 툴을 제공합니다. 다음과 같이 설정을 테스트하시기 바랍니다.

환경을 AdjustConfig.EnvironmentSandbox로 설정합니다.
Adjust 대시보드 결과에 샌드박스 필터를 추가합니다.
로그 수준을 AdjustConfig.LogLevelVerbose로 설정합니다.

문제 발생 시, 모든 상세 내용과 로그를 support@adjust.com에 보내시기 바랍니다.

Google Play Services 연동 테스트

Adjust SDK가 기기의 Google 광고 ID를 수신할 수 있는지 테스트하려면 로그 수준을 verbose 로 설정하고, 환경을 Sandbox(샌드박스) 로 설정합니다. 앱을 시작하고 세션이나 이벤트를 측정합니다. SDK가 광고 ID를 읽으면 gps_adid(Google 플레이 서비스 광고주 ID) 파라미터를 로깅합니다.

Google 광고 ID를 조회하는 데 문제가 있다면 SDK Github repository에 이슈를 제기하거나 support@adjust.com으로 문의해 주시기 바랍니다.