캠페인 측정 - Android SDK v2 (기존)

이 문서에서는 Android v2용 Google 애널리틱스 SDK를 사용하여 캠페인 및 트래픽 소스를 측정하는 방법을 간략하게 설명합니다.

개요

Google 애널리틱스에서 캠페인을 측정하면 애플리케이션 내 사용자 활동에 대한 캠페인 및 트래픽 소스 기여 분석을 사용 설정하여 마케팅 채널의 가치를 개선할 수 있습니다.

Android용 Google 애널리틱스 SDK에서는 다음과 같은 여러 종류의 캠페인 측정을 사용할 수 있습니다.

  • Google Play 캠페인 측정 - 앱을 다운로드하기 위해 사용자를 앱의 Google Play 스토어 페이지로 유도한 캠페인, 웹사이트, 앱을 확인합니다.
  • 일반 캠페인 측정 - 앱이 설치된 앱을 실행한 캠페인 또는 트래픽 소스를 확인합니다.
  • 추천 측정 - 앱이 설치된 후 웹사이트나 기타 앱 등 어떤 추천 트래픽 소스가 내 앱을 실행했는지 확인할 수 있습니다.

다음 섹션에서는 앱에서 각 유형의 캠페인 측정을 구현하는 경우와 방법을 설명합니다.

Google Play 캠페인 측정

Google Play 캠페인 측정을 사용하면 Google Play 스토어에서 앱을 다운로드하도록 사용자를 보내는 캠페인과 트래픽 소스를 확인할 수 있습니다. 모든 개발자는 Google Play 스토어 캠페인 측정을 구현하는 것이 좋습니다.

Google Play 캠페인 측정의 작동 방식

Google Play 스토어 캠페인 측정은 Google Play 스토어에서 앱을 다운로드할 때 캠페인 및 트래픽 소스 정보를 앱에 전달하기 위해 캠페인 매개변수를 사용합니다.

다음은 Google Play 캠페인 측정의 작동 방식에 대한 종합적인 설명입니다.

  1. 사용자가 광고, 웹사이트 또는 앱에서 링크를 클릭하여 앱의 Google Play 스토어 페이지로 이동합니다. 이 링크에는 캠페인 매개변수 태그가 지정되어 있습니다.
  2. 사용자가 앱을 다운로드하여 설치하면 Google Play 스토어는 동일한 캠페인 매개변수가 포함된 기기에 INSTALL_REFERRER 인텐트를 브로드캐스트합니다.
  3. 그러면 앱이 아래에 제공된 BroadcastReceiver 객체를 사용하여 해당 인텐트에 응답하고, 캠페인 매개변수를 읽고 이를 사용하여 Google 애널리틱스 캠페인 정보를 업데이트합니다.

Google Play 캠페인 측정 구현

Google Play 스토어 캠페인 측정을 구현하려면 다음 단계를 따르세요.

1. AndroidManifest.xml 파일에 새 BroadcastReceiver 추가

다음 BroadcastReceiver를 사용하면 앱이 설치될 때 앱이 Google Play 스토어의 INSTALL_REFERRER 인텐트 브로드캐스트에 응답할 수 있습니다. 다음과 같이 AndroidManifest.xml 파일에 추가합니다.

<!-- Used for install referral measurement-->
<service android:name="com.google.analytics.tracking.android.CampaignTrackingService"/>
<receiver android:name="com.google.analytics.tracking.android.CampaignTrackingReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>

2. Google Play 스토어 링크에 캠페인 매개변수 추가하기

캠페인 매개변수는 사용자를 앱의 Google Play 스토어 페이지로 보낸 캠페인 또는 트래픽 소스에 관한 정보를 앱의 Google 애널리틱스 구현으로 전달하는 데 사용됩니다.

캠페인 매개변수 문자열을 만드는 방법을 알아보려면 Google Play URL 빌더를 사용하거나 캠페인 매개변수 참조 섹션을 확인하세요.

캠페인 매개변수 문자열을 만들었으면 다음 예와 같이 Google Play 스토어 URL에 referrer 매개변수의 값으로 추가합니다. 

https://play.google.com/store/apps/details?id=com.example.app
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3DdisplayAd1
%26utm_campaign%3Dshoe%252Bcampaign

Google Play 스토어는 referrer 매개변수의 값만 앱의 Google 애널리틱스 구현에 전달하므로 이 매개변수가 Google Play 스토어 링크에 있는지 확인하는 것이 중요합니다.

일반 캠페인 측정

일반 캠페인 측정을 사용하면 사용자가 앱을 설치한 후 캠페인 또는 트래픽 소스를 사용자와 연결할 수 있습니다.

예를 들어 앱을 이미 설치한 기존 사용자에게 도달하기 위해 유료 캠페인을 실행 중인 경우 일반 캠페인 측정을 사용하여 해당 캠페인의 결과인 앱 실행을 측정할 수 있습니다.

일반 캠페인 측정 구현하기

일반 캠페인의 캠페인 값을 설정하려면 setCampaign()를 호출하고 캠페인 매개변수 문자열을 인수로 전달합니다.

일반적인 구현에서는 앱이 실행될 때 setCampaign()를 호출하고 앱을 실행한 인텐트를 확인하여 유효한 캠페인 매개변수가 있는지 확인할 수 있습니다.

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before calling activityStart().
    EasyTracker.getInstance().setContext(this);

    if (intent.getData() != null) {
      EasyTracker.getTracker().setCampaign(uri.getPath());
    }
    ... // The rest of your onCreate() code.
  }

  @Override
  public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

추천 측정

추천 측정은 사용자의 기기에서 앱을 실행한 추천 소스를 측정할 수 있다는 점에서 다른 유형의 캠페인 측정과 유사합니다. 그러나 추천 측정에서는 캠페인 매개변수 문자열이 아닌 'google.com' 또는 'myOtherApp'과 같은 간단한 문자열을 사용합니다.

'google.com'과 같은 추천 소스를 설정하면 소스 측정기준은 'google.com'으로 설정되고 매체 측정기준은 암시적으로 '리퍼러'로 설정됩니다.

캠페인 측정과 마찬가지로 추천 소스를 설정하면 기본적으로 다음 전송 호출에서 새 세션이 시작됩니다.

다음 코드 스니펫에서는 Google 애널리틱스 캠페인 매개변수 또는 참조 소스를 설명하는 간단한 referrer 매개변수를 사용하여 앱을 여는 링크에 태그를 추가했다고 가정합니다. 다른 캠페인 매개변수가 없는 경우 referrer 매개변수가 있으면 사용자의 캠페인 정보가 새로운 참조 소스로 업데이트됩니다.

public class SampleActivity extends Activity {

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    // Get the intent that started this Activity.
    Intent intent = this.getIntent();
    Uri uri = intent.getData();

    // Call setContext() here so that we can access EasyTracker
    // to update campaign information before activityStart() is called.
    EasyTracker.getInstance().setContext(this);

    if (uri != null) {
      if(uri.getQueryParmeter("utm_source") != null) {    // Use campaign parameters if avaialble.
        EasyTracker.getTracker().setCampaign(uri.getPath());
      } else if (uri.getQueryParameter("referrer") != null) {    // Otherwise, try to find a referrer parameter.
        EasyTracker.getTracker().setReferrer(uri.getQueryParameter("referrer"));
      }
    }
  }


  @Override
    public void onStart() {
    super.onStart();
    EasyTracker.getInstance().activityStart(this);
    ... // The rest of your onStart() code.
  }


  @Override
  public void onStop() {
    super.onStop();
    EasyTracker.getInstance().activityStop(this);
    ... // The rest of your onStop() code.
  }
}

알려진 문제

  • CampaignTrackingReceiver의 javadoc은 사용 예에서 잘못된 클래스 경로를 사용합니다. 올바른 사용법은 Google Play 캠페인 측정 구현을 참고하세요.
  • 앱당 하나의 BroadcastReceiver 클래스만 지정할 수 있습니다. 여러 SDK에서 BroadcastReceivers를 두 개 이상 통합해야 하는 경우 모든 브로드캐스트를 수신하고 각 브로드캐스트 유형에 적절한 BroadcastReceivers를 호출하는 자체 BroadcastReceiver 클래스를 만들어야 합니다.
  • Google Play 캠페인 측정은 현재 웹 Play 스토어에서 시작된 웹-기기 설치를 지원하지 않습니다.

캠페인 매개변수

캠페인 매개변수는 사용자를 앱으로 유도하는 트래픽 소스 및 캠페인에 대한 정보를 전달하는 데 사용됩니다.

  • 일반적으로 캠페인 측정에서는 인코딩되지 않은 캠페인 매개변수 문자열이 setCampaign()에 인수로 전달됩니다.
  • Google Play 캠페인 측정에서는 인코딩된 캠페인 매개변수 문자열이 값으로 포함된 referrer 매개변수가 앱의 Play 스토어 페이지를 가리키는 모든 URL에 추가됩니다.

다음은 일반적인 캠페인 측정에 사용할 수 있는 인코딩되지 않은 유효한 캠페인 문자열의 예입니다.

"utm_campaign=my_campaign&utm_source=google&utm_medium=cpc&utm_term=my_keyword&utm_content=ad_variation1"

아래 표에는 Google Play 또는 일반 캠페인 측정에 사용할 수 있는 캠페인 매개변수의 전체 목록이 나와 있습니다.

매개변수 설명 예시
utm_campaign 캠페인 이름. 특정 제품 프로모션 또는 전략적 캠페인을 식별하기 위한 키워드 분석에 사용됩니다. utm_campaign=spring_sale
utm_source 검색엔진, 뉴스레터 또는 기타 소스를 식별하는 데 사용되는 캠페인 소스 utm_source=google
utm_medium 캠페인 매체. 이메일 또는 클릭당비용 (CPC)과 같은 매체를 식별하는 데 사용됨 utm_medium=cpc
utm_term 광고 키워드를 제공하기 위해 유료 검색과 함께 사용되는 캠페인 검색어 utm_term=running+shoes
utm_content 캠페인 콘텐츠: 동일한 URL을 가리키는 광고 또는 링크를 구분하기 위해 A/B 테스트 및 콘텐츠 타겟팅 광고에 사용됨 utm_content=logolink
utm_content=textlink
gclid Google Ads 자동 태그 추가 매개변수: Google Ads를 측정하는 데 사용됩니다. 이 값은 동적으로 생성되며 수정해서는 안 됩니다.

Google Play URL 작성 도구

Google Play URL 작성 도구를 사용하여 Google Play 캠페인 측정을 위한 URL을 생성하세요.