Cordova SDK 연동 가이드

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

1. 프로젝트에 SDK 추가

Adjust Cordova SDK는 npm에서 플러그인으로 이용 가능합니다. 프로젝트에 추가하려면

Cordova 플러그인

Adjust Cordova SDK를 Cordova 플러그인에 추가하려면 다음의 명령어를 실행하시기 바랍니다.

> 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 기기 설정

Google Play Services 추가

Google Play Store를 타겟팅하는 앱은 기기를 식별하기 위해 반드시 Google Advertising ID (gps_adid)를 사용해야 합니다. 이를 위해 다음을 plugin.xml 파일에 추가합니다.

<framework src="com.google.android.gms:play-services-ads-identifier:18.0.1" id="sl-md0000000" />

권한 추가

Adjust SDK는 다음의 권한을 필요로합니다. plugin.xml 파일이 아직 존재하지 않는다면 추가하시기 바랍니다.

<config-file target="AndroidManifest.xml" parent="/manifest/application" id="sl-md0000000">
    <receiver         android:name="com.adjust.sdk.AdjustReferrerReceiver"         android:exported="true" id="sl-md0000000">
        <intent-filter id="sl-md0000000">
            <action android:name="com.android.vending.INSTALL_REFERRER" id="sl-md0000000" />
        </intent-filter>
    </receiver>
</config-file>

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

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

Proguard 설정

Proguard를 사용하는 경우 다음의 규칙을 Proguard 파일에 추가하시기 바랍니다.

-keep public class com.adjust.sdk.** { *; }
-keep class com.google.android.gms.common.ConnectionResult {
   int SUCCESS;
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
   com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
   java.lang.String getId();
   boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.** { *; }

Google 플레이 스토어에 앱을 게시하지 않는 경우, 다음의 규칙을 Proguard 파일에 추가합니다.

-keep public class com.adjust.sdk.** { *; }

설치 리퍼러 설정

설치 리퍼러는 소스에 앱 설치를 어트리뷰션할 수 있는 고유 식별자입니다. Adjust SDK는 어트리뷰션 수행을 위해 이 정보를 필요로 합니다. 3가지 방법을 통해 설치 리퍼러 정보를 수집할 수 있습니다:

• Google Play Referrer API 사용.
• Huawei Referrer API 사용(Huawei 기기에만 해당).

Google Play Referrer API

Google Play Referrer API를 지원하려면 다음을 수행하시기 바랍니다.

1. build.gradle 파일에서 Google Maven 리포지토리를 구성합니다.

   allprojects {
      repositories {
         jcenter()
         maven {
               url "https://maven.google.com"
         }
      }
   }

2. 다음을 plugin.xml 파일에 추가합니다.

   <framework src="com.android.installreferrer:installreferrer:2.2" id="sl-md0000000" />

3. Proguard를 사용하는 경우 Proguard 파일에 다음의 세팅을 추가합니다:

   -keep public class com.android.installreferrer.** { *; }

Huawei 리퍼러 API

Adjust SDK는 v4.21.1부터 Huawei App Gallery v10.4 이상을 사용하는 Huawei 기기에서의 설치 트래킹을 지원합니다. Huawei Referrer API를 사용하기 위해 추가적인 변경을 수행하지 않아도 됩니다.

Meta 리퍼러 연동

Adjust SDK는 v4.36.0 이상 버전에서 Meta 설치 리퍼러 를 지원합니다. 이 기능을 활성화하려면 다음을 수행하시기 바랍니다.

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

2. 앱 ID를 AdjustConfig 인스턴스의 fbAppId 속성에 할당합니다.

   var adjustConfig = new AdjustConfig(
      "{YourAppToken}",
      AdjustConfig.EnvironmentSandbox,
   );
   adjustConfig.fbAppId = "<fb_app_id_string id="sl-md0000000">";
   Adjust.create(adjustConfig);

3. iOS 프레임워크 추가

Adjust SDK는 특정 iOS 프레임워크가 앱에 포함된 경우 추가적인 정보를 얻을 수 있습니다. 이러한 프레임워크는 특정 SDK 기능을 활성화하지만, SDK가 일반적으로 작동하기 위해 반드시 필요한 것은 아닙니다.

원하는 프레임워크를 plugin.xml 파일에 추가하여 활성화합니다.

<framework src="AdSupport.framework" weak="true" id="sl-md0000000" />
<framework src="StoreKit.framework" weak="true" id="sl-md0000000" />
<framework src="AdServices.framework" weak="true" id="sl-md0000000" />
<framework src="AppTrackingTransparency.framework" weak="true" id="sl-md0000000" />

4. Adjust SDK 초기화

Flutter 앱에서 최대한 빨리 Adjust SDK를 초기화하시기 바랍니다. 다음의 정보를 사용하여 AdjustConfig 객체를 인스턴스화하시기 바랍니다.

• appToken: Adjust 앱 토큰.
• environment: 앱이 실행 중인 환경입니다. 로컬에서 앱을 테스트하려면 이 값을 AdjustConfig.ENVIRONMENT_SANDBOX로 설정하세요.

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

6. 앱 빌드

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

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

6. Adjust SDK 서명 추가

Adjust SDK 서명을 사용해 Adjust SDK가 전송한 모든 커뮤니케이션에 서명을 추가할 수 있습니다. Adjust 서버는 이를 기반으로 유효하지 않은 설치 활동을 감지 및 차단할 수 있습니다.

Adjust SDK 서명을 사용하려면 담당 테크니컬 어카운트 매니저 또는 support@adjust.com에 문의하시기 바랍니다.

7. 연동 테스트

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

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

Google Play Services 연동 테스트

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

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