Google 태그 관리자에서 기본 제공 변수로는 처리할 수 없는 특정 요구사항에 맞춰 맞춤형 사용자 정의 모바일 변수를 만들 수 있습니다.
새로운 사용자 정의 변수를 만드는 방법은 다음과 같습니다.
- 수정하려는 태그 관리자 컨테이너를 엽니다.
- 왼쪽 탐색 메뉴의 '작업공간' 탭에서 변수를 클릭합니다.
- 사용자 정의 변수 섹션에서 새로 만들기를 클릭합니다.
- 변수 구성을 클릭하고 원하는 변수 유형을 선택합니다.
- 선택한 변수 유형에 대한 옵션 설정을 완료합니다.
- 변수의 이름을 지정합니다. 변수의 기능을 설명해 주는 이름 지정 방식을 사용하세요(예: '데이터 영역 변수: 제품 이름').
- 저장을 클릭합니다.
태그 관리자에서는 모바일용으로 다음과 같은 사용자 정의 변수를 지원합니다.
Firebase
이벤트 이름
앱에서 다음 코드가 실행되면 값이 'eventNameXYZ'로 설정됩니다.
Android:
FirebaseAnalytics.getInstance(mContext).logEvent("eventNameXYZ", null);
iOS:
[FIRAnalytics logEventWithName:@"eventNameXYZ" parameters:parameters];
대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
이벤트 매개변수
값이 특정 키의 Google 애널리틱스(Firebase) 이벤트 매개변수 값으로 설정됩니다.
Firebase 사용자 속성
값이 특정 키의 Google 애널리틱스(Firebase) 사용자 속성 값으로 설정됩니다.
유틸리티
광고주 추적 설정됨
Android의 경우 광고 추적이 사용 설정된 상태이면 true가, 사용자가 관심기반 광고를 차단한 상태이면 false가 반환됩니다. 자세한 내용은 Android 개발자 센터를 참고하세요. SDK v4 이전 버전에서는 항상 false가 반환됩니다. iOS 6 이상 버전의 경우 값이 advertisingTrackingEnabled 속성으로 설정됩니다. 그 외에는 값이 true로 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
상수
값이 제공된 문자열 값으로 설정됩니다.
참고표
이 값은 참고표의 지침에 따라 설정됩니다. 참고표에는 아래와 같은 2개의 항목이 표시됩니다(데이터가 나중에 사용되는 방식을 보여주기 위해 표가 빈 상태로 표시됨).
| [변수 선택]이(가) 아래와 같을 경우 | [이 변수]을(를) 다음으로 설정 |
|---|
참고표를 이용하여 다른 변수의 값에 따라 값이 달라지는 변수를 만들 수 있습니다. 이는 앱에서 적절한 값(예: 전환추적 ID)을 앱 버전 코드 또는 앱의 다른 부분에 매핑할 수 있도록 설정된 경우에 유용합니다. 이 예에서는 전환 ID라는 변수를 만듭니다. 앱 버전 코드가 1.0인 경우 값은 '12345'로 설정되고, 앱 버전 코드가 1.1인 경우 값은 '34567'로 설정됩니다. 참고표의 행 수에는 제한이 없습니다. 필드는 대소문자를 구분합니다.
| {{App Version Code}}이(가) 아래와 같을 경우 | {{전환 ID}}을(를) 아래의 값으로 설정 |
|---|---|
| 1.0 | 12345 |
| 1.1 | 34567 |
| 1.2 | 56789 |
임의의 숫자
0과 2147483647 사이의 임의의 숫자로 값이 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
컨테이너 데이터
컨테이너 ID
컨테이너의 공개 ID 값입니다(예: GTM-ABC42). 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
컨테이너 버전 번호
컨테이너가 미리보기 모드일 때 이 변수의 값이 컨테이너의 미리보기 버전 번호가 됩니다. 그렇지 않은 경우 이 변수의 값이 컨테이너의 실제 버전 번호가 됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
애플리케이션
앱 ID
값이 패키지 이름(Android) 또는 앱 ID(iOS)로 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
앱 이름
값은 앱의 이름으로 설정됩니다. 대부분의 경우 동등한 기본 변수를 사용해야 합니다.
앱 버전 코드
현재 실행 중인 애플리케이션의 버전 값으로 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
광고 ID
Android의 경우 값이 광고 ID로 설정됩니다. v4 이전의 SDK 버전은 항상 비어있는 문자열을 반환합니다. iOS 6 이상 버전에서는 값이 광고용 ID(IDFA)로 설정됩니다. 그렇지 않으면 값이 비어있는 문자열로 설정됩니다.
SDK 버전
애플리케이션이 설치된 운영체제의 SDK 버전 값으로 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
기기
기기 이름
현재 실행 중인 애플리케이션의 기기 이름 값으로 설정됩니다(예: 'Samsung Android', 'Pixel 2'). 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
언어
사용자가 설정한 기기 언어를 나타내는 2문자 언어 코드 값으로 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
운영체제 버전
애플리케이션이 설치된 운영체제의 버전 값으로 설정됩니다. 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
플랫폼
현재 실행 중인 애플리케이션의 플랫폼 값으로 설정됩니다(예: 'Android', 'iOS'). 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
화면 해상도
값이 현재 앱을 실행 중인 기기의 화면 해상도로 설정됩니다. 형식은 '너비 x 높이'입니다(예: '1920x1080'). 대부분의 경우 이에 해당하는 기본 변수를 사용해야 합니다.
기타
함수 호출
사전 등록된 함수 호출의 반환 값으로 설정됩니다. 자세히 알아보려면 SDK 설명서(Android 또는 iOS)를 참고하세요.
값 컬렉션(이전 컨테이너만 해당)
이 변수에는 JSON 형식으로 표현된 키-값 쌍의 집합이 포함됩니다. 값 컬렉션을 이용하여 앱의 구성값을 설정합니다. 예를 들어 레이싱 게임 앱의 경우 아래의 코드를 이용해 값 컬렉션 유형의 '앱 설정' 변수를 지정할 수 있습니다.
{
"fuel-burn-rate": 20
}
모바일 앱은 키를 제공하여 변수의 값을 가져올 수 있습니다. 예를 들면 다음과 같습니다.
public class MainActivity {
// Add your public container ID.
private static final String CONTAINER_ID = "XXX-YYY";
// Container configuration value keys, used later
// for retrieving values.
private static final String MAX_FUEL_KEY = "max-fuel";
private static final String INIT_FUEL_KEY = "init-fuel";
private static final String FUEL_BURN_KEY = "fuel-burn-rate";
// Rest of your onCreate code.
}
}
/*
* Method to update game configuration values using a
* Google Tag Manager container.
*/
public void updateConfigurationFromContainer(Container container) {
// Get reference to the container.
Container container = mFutureContainer.get();
// Update game settings using Container
// configuration value keys.
maxFuel = mContainer.getDoubleValue(MAX_FUEL_KEY);
startingFuel = mContainer.getDoubleValue(INIT_FUEL_KEY);
burnRate = mContainer.getDoubleValue(FUEL_BURN_KEY);
}
값 컬렉션 변수에는 연결된 트리거가 있습니다. 앱의 모든 인스턴스 및 버전에 적용되는 구성값에서는 사용 설정 트리거를 사전 정의된 값인 '항상'으로 설정하세요. 값 컬렉션 변수를 사용하는 방법은 개발자 문서(Android 또는 iOS)를 참조하세요.