Google Analytics 4 모듈 설정 가이드

Google Analytics 4은(는) Adjust와 연동된 애널리틱스 파트너입니다. Adjust 연동을 통해 Adjust는 Google Analytics로 교차 네트워크 어트리뷰션 데이터를 전송할 수 있습니다. Google Analytics for Firebase SDK 를 통해 이미 전환을 로깅하고 있는 경우, 연동을 활성화해야 합니다. Adjust는 측정 프로토콜 API의 campaign_details 이벤트를 활용하여 어트리뷰션 상세 정보와 함께 전환을 전송합니다.

이 페이지에서는 Google Analytics 4와(과)의 설정 방법을 확인하실 수 있습니다. Google Analytics 4 활성화와 Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.

시작에 앞서

요구 사항

• Adjust의 관리자, 편집자 또는 사용자 지정 편집자 권한 .
• Adjust SDK v4.0.0 이상 버전에서 SDK 파라미터를 Google Analytics 4 파라미터에 매핑하시기 바랍니다. 자세한 내용은 아래 링크된 가이드를 통해 확인하실 수 있습니다.

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

인증 정보

Firebase App ID, API Secret

인증 정보 찾기

Firebase 앱 ID를 얻으려면 다음을 수행하시기 바랍니다.

1. Firebase 콘솔 로 이동합니다.
2. 프로젝트를 찾아 선택합니다.
3. 설정 (톱니바퀴 아이콘)을 선택한 뒤, 왼쪽 패널에서 프로젝트 설정 을 선택합니다.
4. 내 앱 에서 앱을 선택하고 앱 ID 로 이동합니다.
5. Firebase 앱 ID 를 찾아 복사합니다.

API 시크릿 확인을 위해 다음을 수행하시기 바랍니다.

1. Google Analytics 대시보드 로 이동합니다.
2. 관리자 > 데이터 수집 및 수정 > 데이터 스트림 을 선택합니다.
3. 앱 데이터 스트림을 선택하고 측정 프로토콜 API 시크릿 > 시크릿 값 으로 이동합니다.
4. API 시크릿 을 찾아 복사합니다.
   1. 아직 API 시크릿이 없는 경우 측정 프로토콜 API 시크릿 에서 생성 을 선택합니다.
   2. 이름을 입력하고 생성 을 선택합니다.

Firebase SDK 연동

이 연동을 위해서는 Firebase SDK를 앱에 연동하고 세션 파트너 파라미터를 Adjust SDK에 연동해야 합니다. 이는 Google Analytics 4가 Firebase SDK를 포함하는 앱 설치의 모든 인스턴스에 대해 app_instance_id 를 생성하기 때문에 필요합니다. app_instance_id 이 기록되지 않고 전달되지 않으면 Adjust는 Google Analytics로 콜백을 전송하지 않습니다.

아래의 링크된 가이드를 참조하여 본 기능을 사용하시기 바랍니다.

iOS / Android / Unity / Flutter / React Native

세션 파트너 파라미터를 통해 Adjust SDK는 Google Analytics 4의 app_instance_id 를 트래킹하고, Google Analytics 4로 데이터를 전송할 때 이를 포함할 수 있습니다. Adjust SDK 초기화 전에 app_instance_id 를 설정해야 합니다.

Campaign Lab에서 Google Analytics 4과 앱 선택

1. Campaign Labs 에서 파트너 를 선택합니다.
2. 새 파트너 > Google Analytics 4 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
3. 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, Google Analytics 4를(을) 활성화하여 파트너와 데이터를 공유합니다.
4. 다음 을 선택합니다.

데이터 공유 활성화

Google Analytics 4와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.

1. Firebase App ID, API Secret를 입력합니다.

Google Analytics 4와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 Google Analytics 4에 전송합니다.

• install
• reattribution

데이터 공유 옵션 설정

멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:

1. 플랫폼별 설정 사용 을 선택하여 플랫폼 수준에서 데이터 공유 옵션을 구분.
2. 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.

파라미터 매핑

Google Analytics 4에 커스텀 데이터를 공유하려면 일반적으로 파라미터 매핑이 필요합니다.

파트너 파라미터(Adjust SDK 버전 4.0+에서 이용 가능)를 통해 Adjust는 앱에서 커스텀 데이터를 수집하여 Google Analytics 4에 전송할 수 있습니다. 이를 통해 Google Analytics 4은(는) 연결된 개별 이벤트에 대한 커스텀 이벤트 상세 정보를 수신할 수 있습니다.

Adjust SDK에 새로운 파트너 파라미터를 추가하기 전, 요구 사항을 충족하는 파트너 파라미터가 이미 존재하는지 확인하시기 바랍니다.

파트너 파라미터를 Google Analytics 4에 공유하려면 다음의 단계를 수행하시기 바랍니다.

1. Adjust SDK 내에서 파트너 파라미터를 설정합니다.

   • 시작하기 전에 모든 SDK 개발 플랫폼 링크를 확인하시기 바랍니다.

2. 데이터 공유 옵션 설정 에서 파라미터 를 선택합니다.

3. 파라미터 매핑 에서는 SDK에서 정의된 파트너 파라미터를 네트워크에 어떠한 방식으로 보낼지 지정할 수 있습니다.

   1. 파라미터 매핑 을 선택합니다.
   2. SDK 파라미터 필드에 네트워크와 공유하고자 하는 SDK 파라미터 이름을 입력합니다.
   3. 네트워크 파라미터 영역에 SDK 파라미터에 상응하는 네트워크 파라미터를 입력합니다.

앱에 Google Analytics 4 활성화

설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.

• 선택한 앱
• 데이터 공유 옵션

파트너 활성화 를 선택하여 앱에 대해 Google Analytics 4을 활성화합니다. 애널리틱스 파트너는 캠페인 링크를 사용할 수 없습니다. 활성화가 완료되면 어트리뷰션과 인앱 이벤트 데이터가 자동으로 전송됩니다.

Google Analytics 4에 전송되는 모든 파라미터 목록

Adjust는 Google Analytics 4의 콜백에 다음의 파라미터(데이터)를 전송합니다.