캠페인 측정 - iOS SDK

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

개요

Google 애널리틱스에서 캠페인을 측정하면 애플리케이션 내 사용자 활동에 대한 캠페인 및 트래픽 소스의 기여 분석을 사용할 수 있습니다. 이 옵션은 iOS용 Google 애널리틱스 SDK에서 캠페인 및 트래픽 소스 기여 분석에 사용할 수 있습니다.

iOS 설치 캠페인 측정 - iOS 앱 다운로드를 위해 사용자를 iTunes로 안내한 다른 앱의 캠페인을 확인합니다.
일반 캠페인 및 트래픽 소스 기여 분석 - 앱이 설치된 후 앱을 실행하는 캠페인 또는 리퍼러를 확인합니다.

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

캠페인 매개변수

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

아래 표에는 일반적인 캠페인 측정에 사용할 수 있는 캠페인 매개변수가 나와 있습니다.

매개변수	설명	예시
`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 자동 태그 추가 매개변수: 광고를 측정하는 데 사용됩니다. 이 값은 동적으로 생성되며 수정해서는 안 됩니다.

일반 캠페인 및 트래픽 소스 기여 분석

설치된 앱은 광고 캠페인, 웹사이트 또는 기타 앱의 추천을 통해 실행될 수 있습니다. 이 시나리오에서는 추적기에 직접 캠페인 필드를 설정하여 후속 세션에서의 사용자 활동이 추천 트래픽 소스 또는 마케팅 캠페인에 기여했다고 간주할 수 있습니다.

캠페인 데이터를 전송하는 가장 쉬운 방법은 [GAIDictionaryBuilder setCampaignParametersFromUrl:urlString]를 사용하는 것입니다. 여기서 urlString는 Google 애널리틱스 캠페인 매개변수가 포함될 수 있는 URL을 나타내는 문자열입니다. 다음 예에서는 캠페인 데이터를 한 번만 전송하면 되므로 추적기에 직접 설정되지 않습니다.

/*
 * MyAppDelegate.m
 *
 * An example of how to implement campaign and referral attribution.
 * If no Google Analytics campaign parameters are set in the referring URL,
 * use the hostname as a referrer instead.
 */

// For iOS 9.0 and later
- (BOOL)application:(UIApplication *)app openURL:(nonnull NSURL *)url
            options:(nonnull NSDictionary<NSString *,id> *)options {

// For iOS versions prior to 9.0
//- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url
//  sourceApplication:(NSString *)sourceApplication annotation:(id)annotation {

  NSString *urlString = [url absoluteString];

  id<GAITracker> tracker = [[GAI sharedInstance] trackerWithName:@"tracker"
                                                      trackingId:@"UA-XXXX-Y"];

  // setCampaignParametersFromUrl: parses Google Analytics campaign ("UTM")
  // parameters from a string url into a Map that can be set on a Tracker.
  GAIDictionaryBuilder *hitParams = [[GAIDictionaryBuilder alloc] init];

  // Set campaign data on the map, not the tracker directly because it only
  // needs to be sent once.
  [hitParams setCampaignParametersFromUrl:urlString];

  // Campaign source is the only required campaign field. If previous call
  // did not set a campaign source, use the hostname as a referrer instead.
  if(![hitParams get:kGAICampaignSource] && [url host].length !=0) {
    // Set campaign data on the map, not the tracker.
    [hitParams set:@"referrer" forKey:kGAICampaignMedium];
    [hitParams set:[url host] forKey:kGAICampaignSource];
  }

  NSDictionary *hitParamsDict = [hitParams build];

  // A screen name is required for a screen view.
  [tracker set:kGAIScreenName value:@"screen name"];

  // Previous V3 SDK versions.
  // [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:hitParamsDict] build]];

  // SDK Version 3.08 and up.
  [tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:hitParamsDict] build]];

또는 Google 애널리틱스 캠페인 매개변수 이외의 형식으로 캠페인 정보가 있는 경우 NSDictionary에서 설정하고 수동으로 전송할 수 있습니다.

// Assumes at least one tracker has already been initialized.
id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];

// Note that it's not necessary to set kGAICampaignKeyword for this email campaign.
NSDictionary *campaignData = [NSDictionary dictionaryWithObjectsAndKeys:
    @"email", kGAICampaignSource,
    @"email_marketing", kGAICampaignMedium,
    @"summer_campaign", kGAICampaignName,
    @"email_variation1", kGAICampaignContent, nil];

// A screen name is required for a screen view.
[tracker set:kGAIScreenName value:@"screen name"];

// Note that the campaign data is set on the Dictionary, not the tracker.
// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] setAll:campaignData] build]];

// SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] setAll:campaignData] build]];

iOS 설치 캠페인 측정

Google 애널리틱스는 인기 네트워크에 대한 iOS 설치 캠페인 측정에 즉시 사용 가능한 지원과 추가 네트워크에 대한 자체 맞춤 URL을 생성할 수 있는 기능을 제공합니다.

iOS 설치 캠페인 측정을 사용 설정하려면 아래의 iOS 캠페인 추적 URL 작성 도구를 사용하여 사용자를 App Store로 보내는 광고의 도착 URL을 생성하세요. iOS 캠페인 추적이 작동하려면 iOS 앱에 Google 애널리틱스를 이미 구현하고 IDFA 수집을 사용 설정하고 앱에서 화면 조회수 또는 이벤트를 하나 이상 추적하고 있어야 합니다. 자동 iAd 설치 캠페인 측정을 사용하려면 앱에 프레임워크를 추가해야 합니다.

iOS 전환 추적에 대한 셀프 서비스 진단

iOS 캠페인에 대한 전환이 표시되지 않는 경우 다음 단계에 따라 문제를 해결하세요.

iOS 캠페인 추적이 사용 설정되어 있는지 확인하기
신청서 ID 일치 확인하기
GA SDK에서 IDFA를 전송하는지 확인
인구통계 보고서를 살펴보고 IDFA가 전송되고 있는지 확인
iOS 캠페인 추적 URL이 정확한지 확인하기

1단계: iOS 캠페인 추적이 사용 설정되어 있는지 확인하기

타겟 속성에 대해 iOS 캠페인 추적이 사용 설정되어 있는지 확인하는 방법은 다음과 같습니다.

관리 탭을 클릭합니다.
속성을 선택하고 속성 설정을 클릭합니다.
iOS 캠페인 추적이 사용 설정되어 있는지 확인합니다.

참고: iOS 캠페인 추적이 설정되어 있지 않으면 Google 애널리틱스에서 앱 데이터가 iOS 캠페인 데이터에 기여한 것으로 기록하지 않습니다.

2단계: 애플리케이션 ID 일치 확인하기

캠페인 기여도를 앱 데이터로 올바르게 지정하려면 iOS 캠페인 추적 URL과 앱 추적 구현에서 동일한 앱 ID를 사용해야 합니다. 현재 추적 중인 앱의 앱 ID를 확인하려면 Google 애널리틱스 웹 인터페이스에서 앱 ID를 측정기준으로, 세션을 측정항목으로 사용하여 맞춤 보고서를 만듭니다.

클릭 iOS 캠페인 추적 URL을 만들 때 맞춤 보고서에 표시되는 앱 ID를 사용합니다.

맞춤 보고서 만들기

3단계: Google 애널리틱스 SDK에서 IDFA를 전송하는지 확인

Google 애널리틱스에서는 광고주용 식별자 (IDFA)를 모바일 클릭과 Google 애널리틱스 조회를 결합하는 키 중 하나로 사용합니다. 다음을 확인하세요.

앱이 iOS 버전 3.10 이상용 Google 애널리틱스 SDK를 사용합니다.
독립형 SDK 다운로드를 사용하는 경우:
- 앱이 Google 애널리틱스 iOS 버전의 일부로 libAdIdAccess.a에 연결되어 있습니다.
- 앱이 AdSupport.framework에 연결되어 있습니다.
CocoaPods를 사용하여 종속 항목을 설치하고 관리하는 경우 GoogleIDFASupport Cocoapod를 Podfile에 추가합니다.
```
pod 'GoogleIDFASupport'
```
각 추적기에서 IDFA 수집을 사용 설정했습니다.
```
tracker.allowIDFACollection = YES;
```
가능하면 디버깅 프록시 애플리케이션을 사용하여 HTTP 요청을 보고 IDFA가 포함되었는지 확인합니다.

4단계: 인구통계 보고서에서 IDFA가 전송되고 있는지 확인합니다

Google 애널리틱스는 IDFA를 사용하여 인구통계 보고서를 생성합니다. Google 애널리틱스에서 보고서 탭을 클릭하고 잠재고객 > 인구통계 > 개요를 클릭하여 인구통계 데이터가 표시되는지 확인합니다. 이렇게 하면 IDFA가 올바르게 전송되고 있는 것입니다.

맞춤 보고서

5단계: iOS 캠페인 추적 URL이 올바른지 확인

iOS 캠페인 추적 URL 작성 도구를 사용하여 iOS 캠페인 추적 URL이 올바른지 확인합니다.

광고 네트워크의 맞춤 옵션을 선택할 때는 해당 네트워크에 문의하여 리디렉션 URL을 사용한 개별 기기 ID 추적을 지원하는지 확인하세요. 그렇지 않으면 Google 애널리틱스 보고에 데이터가 표시되지 않습니다.

iOS 캠페인 추적 URL 작성 도구

아래 도구를 사용하여 iOS 애플리케이션 설치 소스를 측정하기 위한 URL을 생성하세요.

중요: Google AdMob 추적 URL에는 &hash=md5 매개변수가 필요합니다. iOS URL 작성 도구는 이 매개변수를 자동으로 추가합니다. URL을 수동으로 만드는 경우 iOS AdMob 설치 추적이 올바르게 작동하려면 이 매개변수를 추가해야 합니다. AdMob 이외의 광고 네트워크를 선택하는 경우 &hash=md5 매개변수는 필요하지 않습니다.