앰플리튜드

    Jeongwon KimWritten by Jeongwon Kim,

    에어브릿지는 앰플리튜드(Amplitude) 연동을 지원합니다. 에어브릿지 사용자는 앰플리튜드에서 에어브릿지의 광고 성과 데이터를 활용해서 더 정교하게 프로덕트를 분석할 수 있습니다.

    알립니다

    에어브릿지의 광고 성과 데이터는 앰플리튜드의 미국(스탠다드) 서버로 전송됩니다. EU 서버로 전송하고 싶다면 에어브릿지 CSM에게 문의해 주세요.

    V1 방식과 V2 방식의 차이

    주의하세요

    V1 방식과 V2 방식 중에서 하나의 방식으로 에어브릿지와 앰플리튜드를 연동해 주세요. 에어브릿지와 앰플리튜드를 2가지 방식을 모두 활용해 연동하면 데이터가 중복으로 집계될 수 있습니다.

    앰플리튜드(Amplitude) 연동에는 V1 방식과 V2 방식이 있습니다. 2가지 방식 중 하나를 선택해서 연동을 진행해 주세요. 활용하는 API부터 유저 매칭 방식까지 두 방식의 주요 차이점은 아래와 같습니다.

    기준

    V1

    V2

    활용하는 API

    어트리뷰션 API

    HTTP V2 API

    사전 개발 작업

    앰플리튜드 SDK에 광고 ID(안드로이드-GAID, iOS-IDFA, IDFV)를 수집하기 위한 코드 삽입 필요

    에어브릿지 SDK에 Amplitude Device ID를 가져오는 코드 삽입 필요

    전송할 수 있는 이벤트

    타겟 이벤트

    인앱이벤트(스탠다드 이벤트와 1번 이상 수집된 커스텀 이벤트)

    전송할 수 있는 프로퍼티

    지정된 유저 프로퍼티 12개만 전송 가능

    124개 프로퍼티 중 선택해서 전송 가능

    유저 매칭 방식

    광고 ID로 유저 매칭을 시도한 이후에 실패하면 72시간 이후에 데이터 폐기

    지정된 우선순위에 따라 유저 매칭을 시도한 이후에 실패하면 해당 유저를 신규 유저로 기록

    V1 방식으로 연동하기

    앰플리튜드(Amplitude) 연동 V1 방식은 앰플리튜드에서 제공하는 어트리뷰션 API를 통해 이뤄집니다. 연동이 정상적으로 완료되면 에어브릿지는 연동 이후에 발생하는 타겟 이벤트와 이벤트의 프로퍼티 같은 광고 성과 데이터를 앰플리튜드로 전송합니다. 앰플리튜드는 에어브릿지에서 전송하는 타겟 이벤트의 프로퍼티를 유저 프로퍼티(User Properties)에 추가합니다.

    그외 다른 이벤트의 프로퍼티는 V1 방식으로 전송할 수 없습니다. 타겟 이벤트 이후에 발생하는 인앱이벤트의 프로퍼티도 앰플리튜드로 전송하고 싶다면 V2 방식으로 연동해야 합니다.

    사전 준비사항

    에어브릿지와 앰플리튜드를 V1 방식으로 연동하기 위해서는 아래 사전 연동 준비 과정이 반드시 필요합니다.

    에어브릿지에 API Key 입력하기

    1. 에어브릿지 대시보드 [Integrations]>[Third-party Integrations]에서 ‘Amplitude V1’를 선택합니다.

    2. 앰플리튜드 대시보드에서 확인한 API Key를 입력합니다.

    3. ‘User Properties 전송’을 활성화합니다. 활성화하면 에어브릿지에 쌓인 타겟 이벤트의 프로퍼티를 앰플리튜드로 전송할 수 있습니다. V1 방식으로 전송된 프로퍼티의 이름은 모두 [Airbridge]로 시작합니다.

    V2 방식으로 연동하기

    앰플리튜드(Amplitude) 연동 V2 방식은 앰플리튜드에서 제공하는 HTTP V2 API를 통해 이뤄집니다. 연동이 정상적으로 완료되면 에어브릿지는 연동 이후에 발생하는 타겟 이벤트를 포함한 다른 이벤트와 이벤트의 프로퍼티 같은 광고 성과 데이터를 앰플리튜드로 전송합니다. 앰플리튜드는 에어브릿지에서 전송하는 프로퍼티를 이벤트 프로퍼티(Event Properties)와 유저 프로퍼티(User Properties)에 추가합니다.

    V2 방식은 V1 방식보다 더 많은 광고 성과 데이터를 에어브릿지에서 앰플리튜드로 전송할 수 있습니다. V2 방식으로 연동하기 전에 에어브릿지에서 앰플리튜드로 전송하는 이벤트가 이미 앰플리튜드 SDK로 수집하고 있는 이벤트인지 확인해 주세요. 앰플리튜드에서 동일한 이벤트를 수집하고 있다면 해당 이벤트가 중복으로 집계될 수 있으니 주의해 주세요.

    사전 준비사항

    에어브릿지와 앰플리튜드를 V2 방식으로 연동하기 위해서는 아래 사전 연동 준비 과정이 반드시 필요합니다.

    에어브릿지에 커넥션 추가하기

    주의하세요

    API Key를 입력하기 전에 데이터를 수집하고 있는 에어브릿지 SDK에 반드시 연동 관련 코드를 삽입해야 합니다. 에어브릿지 SDK에 코드가 삽입되지 않으면 에어브릿지의 광고 성과 데이터를 앰플리튜드에서 활용할 수 없습니다. 앰플리튜드 연동 개발자 가이드를 확인하고 관련 개발자에게 전달해 주세요.

    아래 과정을 통해 에어브릿지에서 V2 방식으로 앰플리튜드 연동을 설정할 수 있습니다.

    1. 에어브릿지 대시보드 [Integrations]>[Third-party Integrations]에서 ‘Amplitude V2’를 선택합니다.

    2. '커넥션 추가’를 클릭합니다.

    커넥션

    커넥션은 V2 방식으로 앰플리튜드 연동을 하기 위해 에어브릿지에 추가해야 하는 요소입니다. 커넥션 이름과 API Key를 입력하고 에어브릿지에서 앰플리튜드로 전송하는 이벤트와 프로퍼티를 선택하면 커넥션을 추가할 수 있습니다.

    커넥션은 여러 개 추가할 수 있습니다. 단, 여러 개의 커넥션을 동시에 연동할 수 없습니다. 예를 들어 A 커넥션을 연동하다가 B 커넥션을 연동하기 위해서는 A 커넥션의 연동을 중지해야 합니다.

    3. 커넥션 이름과 앰플리튜드 대시보드에서 확인한 API Key를 입력합니다. 이전에 입력한 API Key를 API Key 목록에서 선택할 수도 있습니다.

    4. 에어브릿지에서 앰플리튜드로 전송할 이벤트를 선택합니다. 처음에는 모든 이벤트가 선택된 상태로 표시됩니다. ‘전체 선택’, ‘전체 해제’로 모든 이벤트를 선택하거나 해제할 수 있습니다. 에어브릿지 이벤트 중 스탠다드 이벤트는 수집 여부와 관계없이 모두 표시됩니다. 커스텀 이벤트는 기존에 1번 이상 수집된 이벤트만 표시됩니다.

    5. 에어브릿지에서 앰플리튜드로 전송할 프로퍼티를 선택합니다. ‘전체 선택’, ‘전체 해제’로 모든 프로퍼티를 선택하거나 해제할 수 있습니다. 선택을 해제할 수 없는 아래 프로퍼티는 앰플리튜드에 필수로 전송됩니다.

    • Event Category, Event Timestamp, Device ID, Platform, User ID (총 5개)

    에어브릿지에서 앰플리튜드로 전송하는 프로퍼티 중에서 유저 프로퍼티로도 활용할 수 있는 프로퍼티는 아래에서 확인할 수 있습니다.

    6. 전송 규칙을 설정합니다. ‘이벤트명 설정’에서는 에어브릿지에서 앰플리튜드로 전송할 이벤트의 이름 형식을 지정할 수 있습니다.

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

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

    특정 이벤트, 특정 프로퍼티를 전송하고 싶지 않다면 ‘전송 규칙 추가’를 클릭해서 더 자세한 전송 규칙을 추가할 수 있습니다.

    알립니다

    프로퍼티는 [Airbridge] 없이 에어브릿지에서 사용하는 프로퍼티 이름 그대로 앰플리튜드에 전송됩니다.

    7. 추가적인 전송 규칙 설정은 선택 사항입니다. 전송 규칙을 추가하지 않고 커넥션을 추가할 수 있습니다. 전송 규칙을 추가한다면 먼저 전송 규칙 이름을 입력하고 전송하지 않을 이벤트 또는 프로퍼티를 선택합니다. 전송 규칙 이름은 중복될 수 없습니다. 선택한 이벤트 또는 프로퍼티를 전송하지 않는 조건을 설정합니다.

    조건은 여러 개 설정할 수 있습니다. 아래 이미지처럼 전송 규칙을 설정하면 에어브릿지는 Channel 프로퍼티가 example_channel이고 Campaign 프로퍼티가 example_campaign이 아닌 Install (App)을 앰플리튜드에 전송하지 않습니다. 같은 이벤트 또는 프로퍼티에 서로 다른 조건을 설정하기 위해서는 2개 이상의 전송 규칙을 따로따로 추가해야 합니다.

    8. ‘커넥션 추가’를 클릭해서 커넥션을 최종적으로 추가합니다. 전송 규칙에 추가된 이벤트는 에어브릿지에서 앰플리튜드로 전송할 이벤트를 고르는 이전 단계로 돌아가서 선택을 해제할 수 없습니다. 전송 규칙에 추가된 이벤트 선택을 해제하고 싶다면 해당 이벤트에 관한 전송 규칙을 삭제해 주세요.

    9. 커넥션을 추가하면 최초 상태는 비활성화를 의미하는 Inactive로 표시됩니다. 커넥션을 활성화하고 싶다면 해당 커넥션을 클릭합니다.

    10. ‘전송 시작’을 클릭합니다. 선택한 이벤트와 프로퍼티가 에어브릿지에서 앰플리튜드로 전송되기 시작합니다. 커넥션 상태는 활성화를 의미하는 Active로 바뀝니다.

    기본 지원 기능

    에어브릿지는 GA4를 포함한 유저 행동 분석 서드파티 플랫폼에 대해 전송 여부, 전송 조건, 커넥션 정보와 같은 연동 상태를 수정하거나 연동 상태를 복사 또는 보관할 수 있는 기본적인 기능을 제공합니다.

    연동 상태 수정하기

    연동 활성화 여부와 관계없이 에어브릿지에서 추가된 커넥션을 클릭하면 어떤 커넥션이든 연동 상태를 수정할 수 있습니다. 전송 여부, 전송 조건, 커넥션 정보를 바꿀 수 있습니다. 활성화(Active)된 커넥션의 연동 상태를 수정하면 의도하지 않은 이벤트와 프로퍼티가 전송될 수 있으니 주의해 주세요.

    연동 상태 관리하기

    연동 상태를 복사하거나 보관할 수 있습니다.

    앰플리튜드에서 연동 데이터 조회하기

    연동이 정상적으로 완료되면 앰플리튜드(Amplitude)에서 에어브릿지의 데이터를 활용할 수 있습니다.

    V1 방식으로 연동해서 전송한 프로퍼티는 이름 앞에 [Airbridge]가 붙습니다. V2 방식으로 연동하고 전송 규칙으로 ‘[Airbridge]로 시작하는 이벤트로 보내기’를 선택해서 전송한 이벤트 또한 이름 앞에 [Airbridge]가 붙습니다.

    아래 기본적인 활용 방법을 참고해 주세요.

    주의사항

    아래 사항을 주의해 주세요.

    도움이 되었나요?

    더 필요한 내용이 있나요?