캠페인 측정 - iOS SDK

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

개요

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

iOS 설치 캠페인 측정 - iOS 앱을 다운로드하도록 사용자를 유도한 다른 앱의 캠페인을 확인합니다.
일반 캠페인 및 트래픽 소스 기여 분석 - 앱을 설치한 후 어떤 캠페인 또는 리퍼러가 앱을 실행하는지 확인합니다.

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

캠페인 매개변수

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

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

매개변수	설명	예시
`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`	캠페인 콘텐츠: A/B 테스트 및 콘텐츠 타겟팅 광고로 동일한 URL을 가리키는 광고 또는 링크를 구분하는 데 사용됨	`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를 확인하려면 측정기준으로 앱 ID를, 측정항목으로 세션을 사용하여 Google 애널리틱스 웹 인터페이스에서 맞춤 보고서를 만듭니다.

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

맞춤 보고서 만들기

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

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

앱에서 iOS용 Google 애널리틱스 SDK 버전 3.10 이상을 사용하고 있습니다.
독립형 SDK 다운로드를 사용하는 경우 다음을 따르세요.
- Google 애널리틱스 iOS 출시의 일환으로 앱이 libAdIdAccess.a에 연결됩니다.
- 앱이 AdSupport.framework에 연결되었습니다.
CocoaPods를 사용하여 종속 항목을 설치하고 관리하는 경우 Podco에 GoogleIDFASupport CocoaPods를 추가합니다.
```
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 매개변수가 필요하지 않습니다.