사전 설치된 앱 활동 전송

Adjust SDK를 사용하여 사용자의 기기에 사전 설치된 앱의 활동을 기록할 수 있습니다. 이 방법으로 캠페인을 통해 앱을 다운로드하지 않은 사용자의 정보를 전송할 수 있습니다.

config 객체에는 해당 기능을 제어하는 Boolean preinstallTrackingEnabled 속성이 포함되어 있습니다. 사전 설치 측정을 활성화하려면 enablePreinstallTracking 메서드를 호출합니다.

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3
val config = AdjustConfig(this, appToken, environment)
4
config.enablePreinstallTracking()
5
//...
6
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.enablePreinstallTracking();
5
//...
6
Adjust.initSdk(config);

1
var yourAppToken = yourAppToken;
2
var environment = AdjustConfig.EnvironmentSandbox;
3
var adjustConfig = new AdjustConfig(yourAppToken, environment);
4
adjustConfig.enablePreinstallTracking();

Adjust SDK는 사전 설치된 앱을 측정하기 위해 6가지 메서드를 제공합니다.

시스템 속성
콘텐츠 공급자
System Installer Receiver
World-readable directory
디폴트 링크 토큰
삼성 MAPS

시스템 속성

OEM(Original Equipment Manufacturer) 파트너는 Android 시스템 속성을 활용하여 사전 설치된 앱을 어트리뷰션할 수 있습니다. OEM(Original Equipment Manufacturer)은 어트리뷰션 정보를 파일에 적고 해당 경로를 시스템 속성에 추가합니다. Adjust SDK는 설치를 어트리뷰션하기 위해 초기화 시 이 파일을 읽습니다.

콘텐츠 공급자

Content provider(컨텐츠 제공자) 메서드는 read-only content provider(읽기 전용 컨텐츠 제공자)를 사용합니다. SDK는 content resolver를 사용하여 요청에서 사전 설치 정보를 수집합니다.

권한을 설정하려면 AndroidManifest.xml 파일에 다음을 추가합니다.

<uses-permission android:name="com.adjust.preinstall.READ_PERMISSION"/>

기기에 사전 설치된 앱 목록에 액세스하려면 AndroidManifest.xml 파일에 다음을 추가합니다.

<queries>
   <intent>
       <action android:name="com.attribution.REFERRAL_PROVIDER"/>
   </intent>
</queries>

System Installer Receiver

시스템 인스톨러 메서드는 브로드캐스트 리시버를 사용합니다. 시스템 인스톨러는 사전 설치 정보를 브로드캐스트합니다. Adjust SDK는 시스템 사전 설치 리퍼러 리시버를 사용하여 이 정보를 읽습니다.

리시버를 설정하려면 AndroidManifest.xml 파일에 다음을 추가합니다.

<receiver android:name="com.adjust.sdk.AdjustPreinstallReferrerReceiver">
   <intent-filter>
      <action android:name="com.attribution.SYSTEM_INSTALLER_REFERRER" />
   </intent-filter>
</receiver>

World-readable directory

사전 설치된 앱의 어트리뷰션 정보를 전세계에서 읽을 수 있는 디렉토리에 저장합니다. SDK는 설치 시 이 파일에서 정보를 읽고 사용자를 어트리뷰션합니다. 시스템의 암호화 프로토콜은 앱 데이터를 보호합니다.

Adjust SDK가 사전 설치 정보에 액세스할 수 있도록 이 정보가 저장된 파일 경로를 setPreinstallFilePath 메서드로 전달합니다.

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3
val config = AdjustConfig(this, appToken, environment)
4
config.setPreinstallFilePath("../EngagementFile.xml")
5
//...
6
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.setPreinstallFilePath("../EngagementFile.xml");
5
//...
6
Adjust.initSdk(config);

1
var yourAppToken = yourAppToken;
2
var environment = AdjustConfig.EnvironmentSandbox;
3
var adjustConfig = new AdjustConfig(yourAppToken, environment);
4
adjustConfig.setPreinstallFilePath("../EngagementFile.xml");

디폴트 링크 토큰

디폴트 링크 토큰을 설정하면 모든 사전 설치를 미리 정의된 Adjust 링크에 어트리뷰션할 수 있습니다. Adjust는 어트리뷰션 소스가 변경될 때까지 이 토큰에 대한 모든 정보를 기록합니다. 설정 방법:

Campaign Lab에서 새로운 캠페인 링크를 생성합니다.
```
1
https://app.adjust.com/{token}
```
이 토큰을 복사하고 setDefaultTracker 메서드로 전달합니다.

1
val appToken = "{YourAppToken}"
2
val environment = AdjustConfig.ENVIRONMENT_SANDBOX
3
val config = AdjustConfig(this, appToken, environment)
4
config.setDefaultTracker("{Token}")
5
//...
6
Adjust.initSdk(config)

1
String appToken = "{YourAppToken}";
2
String environment = AdjustConfig.ENVIRONMENT_SANDBOX;
3
AdjustConfig config = new AdjustConfig(this, appToken, environment);
4
config.setDefaultTracker("{Token}");
5
//...
6
Adjust.initSdk(config);

1
var yourAppToken = yourAppToken;
2
var environment = AdjustConfig.EnvironmentSandbox;
3
var adjustConfig = new AdjustConfig(yourAppToken, environment);
4
adjustConfig.setDefaultTracker("{Token}");

앱을 빌드하고 실행합니다. 로깅이 활성화된 경우 로그에 다음과 같은 메시지가 표시됩니다.
```
1
Default tracker: 'abc123'.
```

삼성 MAPS

삼성은 MAPS 에이전트가 수집한 데이터를 콘텐츠 공급자를 통해 제공합니다. SDK는 콘텐츠 해석기를 사용하여 MAPS 데이터를 조회합니다. 데이터에 액세스하려면 com.samsung.android.mapsagent.permission.READ_APP_INFO 권한과 com.samsung.android.mapsagent 패키지가 표시되어야 합니다.

권한을 설정하려면 AndroidManifest.xml 파일에 다음을 추가합니다.

<uses-permission android:name="com.samsung.android.mapsagent.permission.READ_APP_INFO"/>

com.samsung.android.mapsagent 패키지를 보이게 하려면 다음을 AndroidManifest.xml 파일에 추가합니다.

<queries>
   <package android:name="com.samsung.android.mapsagent" />
</queries>