Show Menu
화제×

모바일 앱 획득

Adobe Mobile Services에서 고유한 추적 코드가 있는 획득 링크를 생성할 수 있습니다. 사용자가 생성된 링크를 클릭한 후 앱스토어에서 앱을 다운로드하여 실행하면 SDK에서 자동으로 획득 데이터를 수집하여 Adobe Mobile Services로 보냅니다.

새로운 Adobe Experience Platform Mobile SDK 릴리스

Adobe Experience Platform Mobile SDK와 관련된 정보 및 문서 찾기 최신 문서를 보려면 여기 를 클릭하십시오.
2018년 9월 일자로 SDK의 새로운 주요 버전을 릴리스하였습니다. 이러한 새로운 Adobe Experience Platform Mobile SDK는 Experience Platform Launch 를 통해 구성할 수 있습니다.
  • 시작하려면 Adobe Experience Platform Launch로 이동합니다.
  • Experience Platform SDK 리포지토리의 항목을 보려면 Github: Adobe Experience Platform SDK 로 이동하십시오.
획득을 사용하려면 반드시 SDK 버전 4.1 이상이 있어야 합니다.
획득 링크는 Adobe Mobile Services에서 만들어야 합니다. 자세한 내용은 획득 을 참조하십시오.
SDK 버전 4.18.0 이상 :
2020년 3월 1일부터 Google은 install_referrer 인텐트 브로드캐스트 메커니즘을 더는 사용하지 않습니다. 자세한 내용은 InstallBroadcast를 계속 사용하십니까? 2020년 3월 1일까지 Play 레퍼러 API로 전환하십시오 를 참조하십시오. Google Play 스토어에서 설치 레퍼러 정보를 계속 수집하려면 SDK 버전 4.18.0 이상을 사용하도록 애플리케이션을 업데이트하십시오.
사용 중단 시 BroadcastReceiver 를 생성하는 대신 새 Google API에서 설치 레퍼러 URL을 수집하고 결과 URL을 SDK에 전달해야 합니다.
  1. Google Play 설치 레퍼러 패키지를 gradle 파일의 종속성에 추가합니다.
    implementation 'com.android.installreferrer:installreferrer:1.1'
  2. Install Referrer API에서 레퍼러 URL을 검색하려면 설치 레퍼러 가져오기 의 단계를 완료하십시오.
  3. 레퍼러 URL을 SDK에 전달합니다.
    Analytics.processGooglePlayInstallReferrerUrl(referrerUrl);
앱에서 불필요한 API 호출을 방지하려면 설치 후 바로 API를 한 번만 호출하는 것이 좋습니다.
앱에서 Google Play 설치 레퍼러 API를 사용하는 최고의 방법을 결정하려면 Google 설명서를 참조하십시오. 다음은 Google Play 설치 레퍼러 API와 함께 Adobe SDK를 사용하는 방법의 예입니다.
void handleGooglePlayReferrer() {
    // Google recommends only calling this API the first time you need it:
    // https://developer.android.com/google/play/installreferrer/library#install-referrer

    // Store a boolean in SharedPreferences to ensure we only call it once.
    final SharedPreferences prefs = getSharedPreferences("acquisition", 0);
    if (prefs != null) {
        if (prefs.getBoolean("referrerHasBeenProcessed", false)) {
            return;
        }
    }

    final InstallReferrerClient referrerClient = InstallReferrerClient.newBuilder(getApplicationContext()).build();
    referrerClient.startConnection(new InstallReferrerStateListener() {
        private boolean complete = false;

        @Override
        public void onInstallReferrerSetupFinished(int responseCode) {
            switch (responseCode) {
                case InstallReferrerClient.InstallReferrerResponse.OK:
                    // connection is established
                    complete();
                    try {
                        final ReferrerDetails details = referrerClient.getInstallReferrer();                        

                        // pass the install referrer url to the SDK
                        Analytics.processGooglePlayInstallReferrerUrl(details.getInstallReferrer());

                    } catch (final RemoteException ex) {
                        Log.w("Acquisition - RemoteException while retrieving referrer information (%s)", ex.getLocalizedMessage() == null ? "unknown" : ex.getLocalizedMessage());
                    } finally {
                        referrerClient.endConnection();
                    }
                    break;
                case InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
                case InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE:
                default:
                    // API not available in the Play Store app - nothing to do here
                    complete();
                    referrerClient.endConnection();
                    break;
            }
        }

        @Override
        public void onInstallReferrerServiceDisconnected() {
            if (!complete) {
                // something went wrong trying to get a connection, try again
                referrerClient.startConnection(this);
            }
        }

        void complete() {
            complete = true;
            SharedPreferences.Editor editor = getSharedPreferences("acquisition", 0).edit();
            editor.putBoolean("referrerHasBeenProcessed", true);
            editor.apply();
        }
    });
}

SDK 버전 4.13.1 이상 :
Adobe Mobile Services에서 생성된 획득 링크를 사용할 수 없는 경우 Google Play 획득을 사용하여 획득 데이터를 수집할 수 있고 SDK에서 보낼 수 있습니다.
표준 Google Play 획득 캠페인에서 획득 데이터를 수집하는 방법은 다음과 같습니다.
  • 표준 Google Play 스토어 획득 메서드를 사용합니다.
    사용자 지정 획득 데이터는 표준 Google Play Acquisition 키 값 쌍과 함께 사용할 수 있습니다.
  • 사용자가 Google Play 스토어를 통해 앱을 다운로드하고 실행하면 레퍼러의 데이터가 획득되어 Adobe Mobile Services로 전송됩니다.
    • 데이터는 저장되고 SDK와 함께 이전에 등록된 AdobeDataCallback 인스턴스에서 사용할 수 있습니다.
      자세한 내용은 구성 메서드 를 참조하십시오.
    • MobileDataEvent.MOBILE_EVENT_ACQUISITION_INSTALL 또는 MobileDataEvent.MOBILE_EVENT_ACQUISITION_LAUNCH 이벤트 유형이 사용됩니다.
    • Google Play에서 획득한 데이터의 일부인 사용자 지정 키의 이름은 " a.acquisition.custom. "."으로 지정됩니다.
Adobe Mobile Services에서 만든 획득 링크를 사용하는 경우 다음 작업을 완료하여 획득 링크에 사용자 지정 데이터를 추가하십시오.
  1. 획득 변수 접두사로 " adb "를 사용합니다.
    SDK 첫 실행 시 Adobe Mobile Services에서 획득 데이터를 받으면 데이터가 저장되고 SDK에 이전에 등록한 AdobeDataCallback 인스턴스에서 사용할 수 있습니다. 자세한 내용은 구성 메서드 를 참조하십시오.
  2. MobileDataEvent.MOBILE_EVENT_ACQUISITION_INSTALL 또는 MobileDataEvent.MOBILE_EVENT_ACQUISITION_LAUNCH 이벤트 유형이 사용됩니다.
  3. 사용자 지정 데이터 키의 접두사로 " a.acquisition.custom. "이 사용됩니다.
여러 보고서 세트로 데이터를 보내는 경우 보고서 세트 ID 목록의 첫 번째 보고서 세트와 연결된 앱의 획득 데이터를 사용하십시오.
이 섹션의 업데이트를 통해 SDK는 획득 링크에서 획득 데이터를 전송할 수 있습니다.

모바일 획득 추적

  1. 프로젝트에 라이브러리를 추가하고 라이프사이클을 구현합니다.
    자세한 내용은 핵심 구현 및 라이프사이클 에서 IntelliJ IDEA 또는 Eclipse 프로젝트에 SDK 및 구성 파일 추가 ​를 참조하십시오.
  2. 라이브러리를 가져옵니다:
    import com.adobe.mobile.*;
    
    
  3. 레퍼러에 대해 BroadcastReceiver 를 구현합니다.
    package com.your.package.name;  // replace with your app package name
    
    import android.content.BroadcastReceiver;
    import android.content.Context;
    import android.content.Intent;
    
    public class GPBroadcastReceiver extends BroadcastReceiver {
      @Override
      public void onReceive(Context c, Intent i) {
       com.adobe.mobile.Analytics.processReferrer(c, i);
      }
    }
    
    
  4. AndroidManifest.xml 을 업데이트하여 이전 단계에서 생성된 BroadcastReceiver 를 사용하도록 설정합니다.
    <receiver android:name="com.your.package.name.GPBroadcastReceiver" android:exported="true">
     <intent-filter>
      <action android:name="com.android.vending.INSTALL_REFERRER" />
     </intent-filter>
    </receiver>
    
    
  5. ADBMobileConfig.json 파일에 필요한 획득 설정이 포함되어 있는지 확인합니다.
    "acquisition": {
       "server": "c00.adobe.com",
       "appid": "0652024f-adcd-49f9-9bd7-2552a4565d2f"
    },
    "analytics": {
      "referrerTimeout": 5,
      ...
    
    
    여러 보고서 세트로 데이터를 보내는 경우 보고서 세트 ID 목록의 첫 번째 보고서 세트와 연결된 앱의 획득 설정(획득 서버 및 appid)을 사용하십시오.
    acquisition 설정은 Adobe Mobile Services에 의해 생성되므로 변경해서는 안 됩니다. acquisition 설정이 미리 구성된 사용자 지정 ADBMobileConfig.json 파일을 다운로드하는 방법에 대한 자세한 내용은 시작하기 전에 를 참조하십시오.
이 설정을 사용하면 첫 번째 앱 시작 이후 초기 라이프사이클 호출과 함께 획득 데이터가 자동으로 전송됩니다.
referrerTimeout 앱 획득을 사용하려면 을 0보다 큰 값으로 설정해야 합니다.