한눈에 보기: Firebase SDK를 통해 보고된 이벤트를 Google 태그 관리자에서 앱스플라이어로 전송하기 위한 설정 지침입니다.
Google 태그 관리자 설정
이 섹션에서는 Google 태그 관리자(GTM) 화면에서 필요한 설정에 대해 설명합니다. GTM에서 앱스플라이어로 이벤트를 전송하기 위해서는 이 섹션에 설명된 모든 단계를 수행해야 합니다. 목록에 나열된 순서대로 단계를 진행해 주세요.
다음 단계는 모바일 앱용 Google 태그 관리자에서 진행할 사항입니다. 귀하의 Google 태그 관리자의 UI가 이 단계들의 스크린샷과 다르다면 다음을 확인해 보세요.
- Google 태그 관리자 컨테이너가 모바일 앱용으로 설정되어 있어야 합니다.
- 컨테이너는 버전 5입니다. 더 자세한 정보는 여기를 클릭하여 볼 수 있습니다.
참고
이 섹션에 설명된 단계들은 구매 이벤트를 예로 들었지만, 전송하고자 하는 모든 이벤트에 적용할 수 있습니다.
1. 이벤트 파라미터 변수 생성
이벤트 파라미터 변수를 사용하면 Google 태그 관리자가 이벤트로부터 데이터를 획득할 수 있습니다. 이벤트를 전송할 때 앱스플라이어 ID와 개발자 키 변수가 같이 전달됩니다. Google 태그 관리자는 해당 값을 평가하여 데이터를 획득하는 방식입니다. 이벤트로부터 얻은 데이터는 두 가지 기능이 있습니다.
- Google 태그 관리자에 앱스플라이어 ID와 개발자 키를 제공
- Google 태그 관리자에 이벤트 이름과 이벤트 파라미터 제공
Google 태그 관리자가 앱스플라이어에 이벤트를 전송할 때는 반드시 앱스플라이어 ID와 개발자 키를 함께 전송해야 합니다. 개발자 키는 Google 태그 관리자가 앱스플라이어 서버와의 통신을 가능하게 합니다. 앱스플라이어 ID는 앱스플라이어에게 해당 이벤트를 어떤 사용자에게 귀속할지 알려줍니다.
- Google 태그 관리자에서 변수를 선택한 후 새로 생성를 클릭하세요.
- 변수의 이름을 “AppsFlyer Dev Key"로 지정하고 변수 설정(Variable Configuration)을 클릭하세요.
- 이벤트 파라미터를 선택하세요.
- 사용자 정의 파라미터를 선택하세요.
- 이벤트 파라미터 필드에 'dev_key'을 입력하고 저장하세요.
- 앱스플라이어 ID에 대해서도 같은 과정을 반복하되, 변수명을 '앱스플라이어 디바이스 ID'로 설정하고 이벤트 파라미터 필드에 'af_id'를 입력하세요.
예시
아래는 GTM 사용자 인터페이스의 스크린샷입니다. 이벤트 파라미터의 최종 설정을 보여줍니다:
중요!
iOS의 경우, 추가적인 이벤트 파라미터 설정이 필요합니다. 위에서 설명한 절차대로 진행하세요. 변수를 생성하고 'Apple 앱 ID'라고 명명하세요. 이벤트 파라미터 필드에 'apple_app_id'를 입력하고 저장하세요.
다음으로, 앱 안에서 앱스플라이어 ID와 개발 키 변수를 생성 및 설정해야 합니다. 이 단계는 이벤트 전송 세션에서 다룹니다.
대부분 인앱 이벤트는 이벤트 값 파라미터가 요구됩니다. 이 경우는 af_revenue와 af_price 파라미터가 해당되지만 다른 이벤트 파라미터들도 전송할 수 있습니다. 앱에서 이벤트를 설정한 후에는 Google 태그 관리자에서 수익과 가격에 해당하는 변수들을 생성해야 합니다. 이 변수들은 나중에 구매 이벤트 태그에 이용됩니다.
- Google 태그 관리자에서 af_revenue와 af_price에 대한 이벤트 파라미터 변수 두 개를 생성하세요.
- 'af_revenue'의 경우 변수명을 '수익'으로 설정하고 이벤트 파라미터 키를 'af_revenue'로 하세요.
- 'af_price'의 경우 변수명을 '가격'으로 설정하고 이벤트 파라미터 키를 'af_price'로 하세요.
예시
아래는 GTM 사용자 인터페이스의 스크린샷입니다. 이벤트 파라미터의 최종 설정을 보여줍니다:
참고
여기에 제시된 예제는 수익과 가격에 관한 이벤트 파라미터 변수를 생성하는 방법을 보여줍니다. 전달되는 이벤트에 따라 어떠한 종류의 이벤트 파라미터에 대해서도 변수를 생성할 수 있습니다.
2. 구매 이벤트에 대하여 트리거를 생성하세요.
Google 태그 관리자가 이벤트를 앱스플라이어로 전송할지 여부를 판단할 수 있도록 해당 이벤트에 대한 트리거 설정이 필요합니다.
- Google 태그 관리자에서 트리거를 클릭하고 새로 만들기를 선택하세요.
- 트리거 이름을 '구매'로 설정하고 트리거 구성을 클릭하세요.
- 커스텀을 선택하세요.
- 일부 이벤트를 선택하세요.
- "af_purchase"와 같은 이벤트 이름일 때 트리거가 작동하도록 조건을 설정합니다
- 저장 버튼을 클릭합니다.
예시
아래는 GTM 사용자 인터페이스의 스크린샷입니다. 트리거의 최종 설정 상태를 확인할 수 있습니다:
3. 구매 이벤트 태그 만들기
필요한 변수들과 이벤트 트리거를 설정한 후, 구매 이벤트 태그를 만들 준비가 되었습니다.
- Google 태그 관리자에서 태그를 선택하고 이어서 신규를 클릭하세요
- "구매"라는 이름의 태그를 만들고 태그 설정를 클릭하세요
- 앱스플라이어 선택
-
어플리케이션 ID 필드에 앱 ID에 대한 내장 변수를 입력합니다
중요!
iOS 용으로는 어플리케이션 ID 필드에 "apple_app_id" 커스텀 변수를 설정하세요.
- 개발 키 필드에서는 "앱스플라이어 개발 키" 변수를 선택하세요
- 앱스플라이어 디바이스 ID 필드에서는 "앱스플라이어 디바이스 ID" 변수를 선택하세요
- 이벤트 이름 필드에는 내장 변수 이벤트 이름을 지정하세요
- 이벤트 통화 필드에는 예를 들어 USD와 같은 귀사의 통화 코드를 입력합니다
- 이벤트 값 추가를 두 번 클릭하세요
- 아래와 같이 설정하세요:
키: af_revenue, 값: "수익" 이벤트 파라미터 변수를 선택합니다
키: af_price, 값: "가격" 이벤트 파라미터 변수를 선택합니다 - 트리거 설정 영역에서 트리거 발생 을 "구매" 이벤트 트리거로 설정하세요
- 저장 버튼을 클릭합니다.
예시
아래는 GTM 사용자 인터페이스의 스크린샷입니다. 태그의 최종 설정 상태를 확인할 수 있습니다:
4. 태그 관리자 컨테이너 배포
- 안드로이드의 경우 - app/src/main/assets/containers
- iOS의 경우 - 루트 폴더/container