아래 개발자 가이드의 코드를 데이터를 수집하고 있는 앰플리튜드 SDK에 반드시 삽입해 주세요.

• 앰플리튜드 안드로이드 SDK에 앰플리튜드 V1 방식 연동 관련 코드 삽입하는 방법

• 앰플리튜드 iOS SDK에 앰플리튜드 V1 방식 연동 관련 코드 삽입하는 방법

해당 코드를 앰플리튜드 SDK에 미리 삽입하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 앰플리튜드가 정상적으로 연동되지 않습니다.

앰플리튜드에서 계정 역할(Role)을 확인해 주세요. 에어브릿지에 입력해야 하는 API Key는 아래 역할의 앰플리튜드 계정만 확인할 수 있습니다.

• Admin

• Manager

앰플리튜드 계정 역할은 앰플리튜드 대시보드 [설정]>[Personal settings]>[Profile]의 ‘Role’에서 확인할 수 있습니다. 계정 역할이 Member라면 에어브릿지와 연동할 수 있는 새로운 계정 역할이 필요합니다.

API Key는 앰플리튜드 대시보드 [설정]>[Organization settings]>[Projects]에서 에어브릿지의 광고 성과 데이터를 전송받을 프로젝트별로 확인할 수 있습니다. 원하는 프로젝트를 선택한 후에 [General]에서 ‘Show’를 클릭하면 API Key를 확인할 수 있습니다.

아래 개발자 가이드의 코드를 데이터를 수집하고 있는 에어브릿지 SDK에 반드시 삽입해 주세요.

• 에어브릿지 SDK에 앰플리튜드 V2 방식 연동 관련 코드 삽입하는 방법

해당 코드를 에어브릿지 SDK에 미리 삽입하지 않으면 에어브릿지 대시보드에서 연동 설정을 하더라도 에어브릿지와 앰플리튜드가 정상적으로 연동되지 않습니다.

앰플리튜드에서 계정 역할(Role)을 확인해 주세요. 에어브릿지에 입력해야 하는 API Key는 아래 역할의 앰플리튜드 계정만 확인할 수 있습니다.

• Admin

• Manager

앰플리튜드 계정 역할은 앰플리튜드 대시보드 [설정]>[Personal settings]>[Profile]의 ‘Role’에서 확인할 수 있습니다. 계정 역할이 Member라면 에어브릿지와 연동할 수 있는 새로운 계정 역할이 필요합니다.

API Key는 앰플리튜드 대시보드 [설정]>[Organization settings]>[Projects]에서 에어브릿지의 광고 성과 데이터를 전송받을 프로젝트별로 확인할 수 있습니다. 원하는 프로젝트를 선택한 후에 [General]에서 ‘Show’를 클릭하면 API Key를 확인할 수 있습니다.

앰플리튜드는 기본적으로 에어브릿지에서 전송하는 프로퍼티를 이벤트 프로퍼티(Event Properties)에 활용합니다. 이중 일부 프로퍼티는 유저 프로퍼티(User Properties)에도 추가됩니다.

앰플리튜드에서 유저 프로퍼티를 활용하면 유저 레벨에서 데이터를 분석하기 위한 조건을 설정할 수 있습니다. 또한 앰플리튜드의 유저 컴포지션(User Composition)에서는 유저 프로퍼티만 활용할 수 있습니다. 이벤트 프로퍼티는 유저 컴포지션에서 활용할 수 없습니다.

유저 프로퍼티로도 추가되는 에어브릿지 프로퍼티는 아래와 같습니다.

알립니다

터치포인트 관련 프로퍼티는 수집된 데이터가 없으면 앰플리튜드에 -로 전송됩니다. 하지만 아래 조건에 해당하는 커넥션의 경우에는 수집된 데이터가 없으면 빈 값이 전송됩니다.

• 2024년 2월 29일 이전에 생성한 커넥션

• 2024년 2월 29일 이후에 다시 활성화하지 않거나 설정을 변경하지 않은 커넥션

터치포인트와 관련 있는 프로퍼티입니다. 아래 프로퍼티에 수집된 데이터가 없으면 앰플리튜드에 -로 전송됩니다.

성과에 기여하지 않은 채널

광고 성과에 기여하지 않은 채널의 Channel 프로퍼티에는 Unattributed로 처리됩니다. Unattributed로 수집된 데이터는 앰플리튜드에 Unattributed로 전송됩니다.

앰플리튜드에 -로 전송된 Channel 프로퍼티는 수집된 데이터가 없는 프로퍼티입니다.

유저 정보에 관한 프로퍼티입니다. 아래 프로퍼티는 수집된 데이터가 없다면 앰플리튜드에 빈 값으로 전송됩니다.

에어브릿지에서 앰플리튜드로 전송할 이벤트 이름의 형식을 지정할 수 있습니다.

• [Airbridge] 없이 이벤트 이름 그대로 전송하기: 에어브릿지에 표시되는 이벤트 이름을 그대로 유지합니다. 기본 설정 값입니다.

• [Airbridge]로 시작하는 이벤트 이름으로 전송하기: 모든 이벤트 이름 앞에 [Airbridge]가 붙습니다. 이 형식을 지정하면 에어브릿지에서 전송한 이벤트를 앰플리튜드에서 구분할 수 있습니다.

에어브릿지에서 앰플리튜드의 유저 프로퍼티로 활용할 타겟 이벤트의 터치포인트 관련 프로퍼티를 전송할 때마다 설치 이벤트의 터치포인트 관련 프로퍼티를 함께 전송할지 결정할 수 있습니다. 설치 이벤트의 터치포인트 관련 프로퍼티는 앰플리튜드에서 install_이 붙은 유저 프로퍼티로 따로 표시됩니다. 재설치가 발생하면 재설치 이벤트의 터치포인트 관련 프로퍼티로 전송됩니다.

• 토글을 비활성화하면 에어브릿지에서 최근 발생한 타겟 이벤트의 터치포인트 관련 프로퍼티만 전송합니다. 타겟 이벤트의 어트리뷰션 데이터를 전송할 때마다 앰플리튜드에서 유저 프로퍼티가 업데이트됩니다.

• 토글을 활성화하면 에어브릿지에서 설치 이벤트의 터치포인트 관련 프로퍼티를 계속 전송합니다. 따라서 설치 이벤트와 최근 발생한 타겟 이벤트의 어트리뷰션 데이터를 앰플리튜드에서 모두 확인할 수 있습니다.

데이터 전송 여부를 변경할 수 있습니다. ‘관리’에서 ‘전송 중지’를 클릭하면 데이터가 전송되지 않습니다. 커넥션은 비활성화됩니다.

서드파티의 연동 상태를 아래 상태 메시지로 확인할 수 있습니다. 상태 메시지는 에어브릿지의 [연동]>[서드파티 연동]에 있는 서드파티의 표시 이름 아래에서 확인할 수 있습니다.

이벤트 스키마

[이벤트 스키마]에서 에어브릿지에서 서드파티로 전송할 이벤트와 프로퍼티를 추가로 선택하거나 해제할 수 있습니다. ‘설정’ 또는 이벤트를 선택하면 표시되는 [프로퍼티 설정]에서 프로퍼티의 톱니바퀴 모양 아이콘을 클릭해 주세요. 또한 [적용된 규칙]에서는 이벤트, 프로퍼티별로 적용된 전송 규칙을 확인하고 삭제할 수 있습니다.

전송 규칙

[전송 규칙]에서 커넥션에 추가된 모든 전송 규칙을 확인할 수 있습니다. [이벤트 스키마]의 [적용된 규칙]과 동일하게 이미 추가된 전송 규칙을 수정, 삭제할 수 있습니다. 현재 전송 규칙을 CSV 또는 구글 스프레드시트 형태로 다운로드하거나 새로운 전송 규칙을 추가할 수도 있습니다.

특정 커넥션을 선택하면 [커넥션 정보]에서 커넥션 이름과 서드파티 연동 정보를 변경할 수 있습니다. 서드파티 연동 정보는 일부 값만 표시됩니다. 현재 선택한 이벤트와 프로퍼티 개수, 커넥션을 생성한 일시와 계정도 확인할 수 있습니다. 커넥션 이름과 연동 정보를 바꾸고 싶다면 ‘수정’을 클릭합니다.

특정 커넥션의 설정 상태를 복사해서 새로운 커넥션을 만들 수 있습니다. ‘복제’를 클릭하면 새로운 커넥션의 정보를 입력하는 단계에서 커넥션 이름을 제외한 해당 커넥션의 연동 정보 값이 그대로 입력됩니다.

특정 커넥션의 오른쪽에 위치한 점 3개 버튼에서 ‘삭제’를 클릭하면 해당 커넥션을 삭제할 수 있습니다. 활성화된 커넥션은 삭제할 수 없습니다.

[User Look-Up]에서 에어브릿지에서 전송한 이벤트와 프로퍼티를 유저별로 확인할 수 있습니다.

에어브릿지에서 전송한 이벤트와 프로퍼티는 앰플리튜드의 차트 중 하나인 세그멘테이션(Segmentation) 차트를 기준으로 아래와 같이 활용할 수 있습니다. 이벤트와 프로퍼티를 활용하는 방법은 차트별로 조금씩 다를 수 있습니다.

‘Add Event or Metric’를 클릭하면 차트에서 조회할 에어브릿지 이벤트를 선택할 수 있습니다. 별도의 카테고리를 지정하지 않았다면 모든 에어브릿지 이벤트는 이벤트 리스트 중 ‘Uncategorized’ 또는 ‘Unexpected’로 분류됩니다.

선택한 이벤트의 이벤트 프로퍼티를 필터 또는 그룹바이로 설정할 수 있습니다. ‘Filter by’를 클릭해서 설정할 수 있는 필터는 특정 이벤트의 수치만 조회하기 위한 조건입니다. ‘Group-by’를 클릭해서 설정할 수 있는 그룹바이는 조회할 이벤트 수치를 나누는 기준입니다. 예를 들어 아래 이미지처럼 차트를 설정하면 채널 값이 example_channel인 앱 설치에 관한 데이터를 플랫폼별로 조회할 수 있습니다.

이벤트를 선택하고 나서 설정창을 스크롤하면 ‘Segment by’에서 데이터를 조회할 유저 조건을 설정할 수 있습니다. ‘Filter by’를 클릭하면 유저 프로퍼티를 특정 유저의 수치만 조회하기 위한 조건인 필터로 설정할 수 있습니다.

‘Performed’를 클릭하면 특정 이벤트를 실행한 유저의 수치를 조회하기 위해 이벤트를 선택할 수 있습니다. 이벤트를 선택하고 나서 ‘Add Property filter’를 클릭하면 유저 프로퍼티 또는 이벤트 프로퍼티를 유저가 실행한 이벤트의 속성으로 설정할 수 있습니다.

예를 들어 아래 이미지처럼 차트를 설정하면 8월 22일부터 8월 29일 사이에 example_channel에 기여되고 구매 완료를 1번 이상 실행한 유저를 대상으로 데이터를 조회할 수 있습니다.

[Data]>[Events]를 클릭하면 여러 이벤트를 관리할 수 있습니다.

공백으로 표시되는 CATEGORY 열에 마우스 커서를 가져가면 ‘Add a category’이 나옵니다. ‘Add a category’를 클릭하면 이벤트를 카테고리에 추가할 수 있습니다.

이벤트를 카테고리에 추가하기 위해서는 해당 이벤트의 상태가 Live여야 합니다. 여러 이벤트를 카테고리별로 분류하면 원하는 이벤트를 차트에서 쉽게 찾을 수 있습니다.

커스텀 이벤트로 차트에서 자주 선택하는 이벤트를 한번에 선택할 수 있습니다. 커스텀 이벤트로 만들고 싶은 이벤트를 선택한 후에 ‘CREATE CUSTOM EVENT’를 클릭하면 여러 이벤트를 하나의 커스텀 이벤트로 만들 수 있습니다.

에어브릿지와 앰플리튜드(Amplitude)는 연동 방식에 따라 서로 다른 방식으로 유저를 매칭합니다.

V1 방식으로 에어브릿지와 연동한 앰플리튜드는 대소문자를 구분한 광고 ID(안드로이드의 GAID와 iOS의 IDFA, IDFV)를 기준으로 유저를 매칭합니다. 에어브릿지에서 광고 ID를 수집하지 않았다면 앰플리튜드는 null 등 유저 매칭을 할 수 없는 값을 받습니다.

따라서 에어브릿지가 광고 ID를 정상적으로 전송하더라도 해당 값이 유저 매칭을 할 수 없는 값이라면 앰플리튜드는 유저 매칭에 실패할 수 있습니다. 앰플리튜드는 데이터가 전송된 시점에 유저 매칭을 실패하면 이후 72시간 동안 데이터를 보관한 채로 유저 매칭을 시도합니다. 정해진 시간 안에도 유저가 매칭되지 않으면 해당 데이터는 폐기됩니다.

유저 매칭 확률을 높이고 싶다면 V2 방식 연동이 더 효과적일 수 있습니다. 구글과 애플의 개인정보보호정책으로 인해 광고 ID를 수집하지 못 하는 Amplitude JS SDK 혹은 React Native SDK를 사용하는 앱은 V2 방식으로 연동하기를 권장합니다.

에어브릿지와 앰플리튜드를 연동할 때 아래 우선순위에 따라 여러 가지 식별자가 유저 매칭에 사용됩니다.

1. Amplitude Device ID(device.alias.amplitude_device_id)

2. Amplitude Device ID(user.alias.amplitude_device_id)

3. 에어브릿지 디바이스 ID(device.deviceUUID)

4. 브라우저 클라이언트 ID(browser.clientID)

앰플리튜드의 디바이스 ID인 Amplitude Device ID를 가져오지 않으면 에어브릿지는 환경(앱, 웹)에 따라 각각 에어브릿지 디바이스 ID와 브라우저 클라이언트 ID를 앰플리튜드에 전송합니다. Amplitude Device ID가 아닌 다른 식별자를 바탕으로 데이터를 전송하면 에어브릿지와 앰플리튜드 사이에서 유저 매칭 확률이 떨어집니다.

특히 앱에 Amplitude JS SDK 또는 React Native SDK가 설치되어 있다면 Amplitude Device ID를 반드시 에어브릿지로 가져와야 합니다. 두 SDK가 설치된 앱은 구글과 애플의 개인정보보호정책에 따라 에어브릿지 디바이스 ID 값으로 사용되는 OS별 광고 식별자(안드로이드-GAID, iOS-IDFA)를 수집하지 못 하기 때문입니다.

에어브릿지와 앰플리튜드 사이에서 유저가 매칭되지 않으면 앰플리튜드는 기존 유저 데이터 존재 여부와 관계없이 해당 유저를 별도의 유저로 인식합니다. 이에 따라 앰플리튜드에서 분석하는 유저 수가 과장되고 필요 이상의 이용 금액이 과금될 수 있습니다.

앰플리튜드에서 에어브릿지의 데이터를 최적의 금액으로 정교하게 분석하고 싶다면 사전 준비사항을 반드시 진행해야 합니다.

메타 애즈에 기여된 데이터는 메타 개인정보보호정책에 따라 서드파티에 전송되거나 공유될 수 없습니다. 해당 데이터는 광고를 집행한 주체만 메타 애즈의 광고 성과를 분석하기 위한 목적으로 내부에서 사용할 수 있습니다.

따라서 에어브릿지는 메타 애즈에 기여된 데이터의 Channel을 facebook.business에서 Restricted로 변경한 후에 서드파티에 전송합니다. 에어브릿지와 서드파티를 정상적으로 연동하더라도 메타 애즈에 기여된 데이터를 서드파티에서 활용할 수 없습니다.

웹 캠페인 전용 트래킹 링크 또는 커스텀 채널용 트래킹 링크로 수집한 광고 성과 데이터는 미기여로 처리되지 않기 때문에 서드파티에서 확인할 수 있습니다.

앰플리튜드는 유저 프로퍼티가 빈 값이면 직전 값을 적용합니다. 예를 들어 유저 프로퍼티 A가 빈 값이면 직전에 수집된 유저 프로퍼티 A 값을 유지합니다. 앰플리튜드 유저 프로퍼티 적용 규칙에 대한 자세한 내용은 앰플리튜드 가이드에서 확인할 수 있습니다.

앰플리튜드 유저 프로퍼티 적용 규칙에 따라 에어브릿지에서 빈 값으로 전송된 에어브릿지 프로퍼티가 앰플리튜드에서 빈 값이 아닐 수 있습니다.

아래 예시를 참고해 주세요. 2번째 전송한 프로퍼티 B는 에어브릿지에서 빈 값이기 때문에 앰플리튜드에서 직전에 수집된 값이 유지됩니다.

에어브릿지는 값이 없는 유저 프로퍼티에 의도하지 않은 값이 적용되지 않도록 일부 프로퍼티에 대해서 빈 값이면 -을 전송합니다. -을 전송하는 에어브릿지 프로퍼티는 에어브릿지 가이드에서 확인할 수 있습니다.

아래 예시를 참고해 주세요. 2번째 전송한 프로퍼티 B는 - 이 전송되었기 때문에 동일하게 - 로 기록됩니다.

알립니다

터치포인트 관련 프로퍼티는 수집된 데이터가 없으면 앰플리튜드에 -로 전송됩니다. 하지만 아래 조건에 해당하는 커넥션의 경우에는 수집된 데이터가 없으면 빈 값이 전송됩니다.

• 2024년 2월 29일 이전에 생성한 커넥션

• 2024년 2월 29일 이후에 다시 활성화하지 않거나 설정을 변경하지 않은 커넥션

Channel, Campaign은 빈 값이면 앰플리튜드에 -을 전송하는 에어브릿지 프로퍼티입니다. Custom User Properties는 빈 값이면 앰플리튜드에 빈 값을 그대로 전송하는 에어브릿지 프로퍼티입니다.

2번째 전송에서 Campaign과 Custom User Properties는 아래와 같이 앰플리튜드에서 수집됩니다.

• Campaign: -을 전송하기 때문에 앰플리튜드에서 -로 수집됩니다.

• Custom User Properties: 빈 값으로 전송하기 때문에 앰플리튜드 유저 프로퍼티 적용 규칙에 따라 직전에 수집된 값이 유지됩니다. 따라서 shoes로 수집됩니다.

앰플리튜드에서 세션 중복 집계를 방지하기 위해서는 에어브릿지에서 Session Start Timestamp를 전송하지 않아야 합니다. Session Start Timestamp는 에어브릿지 SDK에서 수집된 세션의 세션 ID입니다. V2 방식으로 연동하는 과정에서 Event Property 그룹에 속한 Session Start Timestamp의 선택 여부를 확인해 주세요. 선택하지 않은 상태가 기본 값입니다. V1 방식으로 연동하면 기본적으로 Session Start Timestamp를 전송할 수 없습니다.

세션 중복 집계는 에어브릿지 SDK와 앰플리튜드 SDK가 동일한 세션을 서로 다른 세션 ID로 각각 수집하기 때문에 발생합니다. 따라서 에어브릿지에서 앰플리튜드로 전송하는 프로퍼티에서 세션 ID에 해당하는 Session Start Timestamp를 제외해야 세션에 관한 데이터가 중복으로 집계되지 않습니다.

Session Start Timestamp를 전송하지 않으면 에어브릿지는 세션 ID를 널(null) 값으로 전송합니다. 널 값으로 전송된 세션 ID는 앰플리튜드에서 -1로 기록됩니다. 앰플리튜드는 세션 ID가 -1로 기록된 세션을 집계 대상에서 제외합니다. 이를 통해 유저 세션(User Session) 차트, 패스파인더(Pathfinder) 차트에서 세션에 관한 데이터를 정확하게 조회할 수 있습니다.

Session Start Timestamp를 전송하면 유저 세션 차트에서 세션 수가 실제 수치보다 많이 조회될 수 있습니다. 또한 패스파인더 차트에서 에어브릿지 SDK와 앰플리튜드 SDK가 각각 서로 다른 세션 ID로 수집한 동일 세션의 데이터가 함께 표시될 수 있습니다. 에어브릿지에서 앰플리튜드로 전송하는 프로퍼티를 선택하는 과정에서 참고해 주세요.

상품 관련 시맨틱 어트리뷰트(Semantic Attributes)를 사용하는 이벤트가 여러 상품을 담고 있으면 앰플리튜드 또는 믹스패널은 해당 이벤트를 에어브릿지와 다른 방식으로 기록합니다. 따라서 에어브릿지는 에어브릿지 이벤트 택소노미에 따라 하나의 이벤트를 상품(product)별로 나눠서 앰플리튜드 또는 믹스패널에 여러 개의 이벤트로 전송합니다.

어트리뷰트 이름에 products.$0이 있는 시맨틱 어트리뷰트는 모두 상품에 관한 어트리뷰트입니다.

아래처럼 택소노미를 설계하면 입력한 어트리뷰트에 따라 구매 완료(Order Complete) 이벤트가 발생했을 때 구매한 상품별로 상품 ID(Product ID)가 기록됩니다.

이 택소노미를 바탕으로 상품이 5개 담긴 구매 완료 이벤트 1건이 에어브릿지에 기록되면 앰플리튜드 또는 믹스패널에서는 5건의 구매 완료 이벤트가 기록됩니다.

• 에어브릿지 - 구매 완료 이벤트 1건

• 앰플리튜드 또는 믹스패널 - 구매 완료 이벤트 5건