에어브릿지를 처음 도입했다면 에어브릿지에 식별자(ID)를 업로드하는 것을 권장합니다.
에어브릿지 SDK가 설치된 버전의 앱이 배포돼 있어야 합니다. SDK가 설치된 시점부터 에어브릿지가 이벤트와 데이터를 수집합니다.
업로드할 디바이스 ID 또는 유저 ID가 CSV 파일 형식으로 준비돼 있어야 합니다.
파일 전달과 업로드 완료 확인을 위해 에어브릿지 CSM 또는 문의하기를 통한 지원 채널을 확보하세요.
에어브릿지 SDK가 설치된 앱이 배포되기 영업일 기준 최소 2일 전에 작업을 요청해야 합니다.
다른 솔루션에서 에어브릿지로 이관하는 등 에어브릿지를 처음 도입했다면 도입 직후에 유저가 발생시킨 첫 이벤트가 이전보다 많이 발생할 수 있습니다. 이는 에어브릿지에서 첫 이벤트 여부를 판단하기 위해 필요한 식별자가 처음 수집되기 때문입니다. 따라서 에어브릿지에 식별자를 업로드하면 에어브릿지 도입 전후에 발생하는 수치 차이를 완화할 수 있습니다.
특정 이벤트를 발생시킨 유저의 식별자를 업로드하면 해당 이벤트만 다르게 집계됩니다. 아래 예시를 참고해 주세요.
알립니다
수치에 영향을 주기 시작하는 단계는 유저가 에어브릿지 SDK를 설치한 앱으로 업데이트한 시점입니다. 해당 시점부터 에어브릿지 SDK는 이벤트와 데이터를 수집할 수 있습니다.
앱 설치 이벤트를 발생시킨 유저의 식별자를 업로드하면 앱을 이미 설치한 유저와 앱을 처음 설치하는 유저를 구분할 수 있습니다. 단, 이 식별자 업로드는 앱 설치 이벤트에만 영향을 줍니다. 다른 이벤트의 첫 이벤트 여부를 구분하려면 해당 이벤트의 식별자를 별도로 업로드해야 합니다.
앱을 이미 설치한 유저가 에어브릿지 SDK를 설치한 앱으로 업데이트하고 앱을 실행하면 해당 유저의 식별자 업로드 여부에 따라 아래와 같이 이벤트가 다르게 집계됩니다.
구매 완료(Order Complete) 이벤트를 발생시킨 유저의 식별자를 업로드하면 이전에 상품을 구매한 유저와 처음 상품을 구매하는 유저를 구분할 수 있습니다. 단, 이 식별자 업로드는 구매 완료 이벤트에만 영향을 줍니다. 다른 이벤트의 첫 이벤트 여부를 구분하려면 해당 이벤트의 식별자를 별도로 업로드해야 합니다.
이전에 상품을 구매한 유저가 에어브릿지 SDK를 설치한 앱으로 업데이트하고 앱을 실행하면 해당 유저의 식별자 업로드 여부에 따라 아래와 같이 이벤트가 다르게 집계됩니다.
에어브릿지에서 첫 이벤트 여부 결정에 사용하는 주요 식별자(ID)는 디바이스 ID와 유저 ID입니다.
에어브릿지 리포트에서 그룹바이로 Is First Event per Device ID 또는 Is First Event per User ID를 선택하면 각 그룹바이의 기준에 따라 첫 이벤트 여부를 결정합니다. 아래 테이블을 참고해 주세요.
예를 들어 구매 이력이 있는 기존 유저 A의 디바이스 ID만 업로드하고 유저 ID는 업로드하지 않았습니다. 에어브릿지 SDK를 설치한 앱으로 업데이트한 이후 유저 A가 처음으로 앱에서 상품을 구매하면 그룹바이에 따라 첫 이벤트 여부는 아래와 같이 결정됩니다.
Is First Event per Device ID: 구매 이력이 있는 기존 유저 A의 디바이스 ID가 있습니다. 따라서 첫 이벤트로 집계되지 않기 때문에 false입니다.
Is First Event per User ID: 유저 A의 유저 ID가 없습니다. 따라서 첫 이벤트로 집계되기 때문에 true입니다.
알립니다
에어브릿지는 식별자가 업로드된 유저가 발생시킨 이벤트에 대해서만 첫 이벤트 여부를 결정합니다. 식별자가 업로드되지 않은 유저가 발생시킨 이벤트에 대해서는 어떠한 영향도 없습니다.
측정 목적에 따라 디바이스 ID, 유저 ID 또는 두 식별자 모두를 업로드합니다.
에어브릿지는 디바이스 ID를 기준으로 처음 발생한 이벤트를 포스트백으로 전송합니다. 따라서 에어브릿지를 도입한 이후 에어브릿지에서 처음 발생한 이벤트를 기준으로 광고비를 정산하거나 캠페인을 최적화하려면 디바이스 ID를 업로드해야 합니다.
아래 순서에 따라 수집된 디바이스 ID를 CSV 파일 형식으로 에어브릿지에 업로드할 수 있습니다.
수집된 디바이스 ID를 규칙에 따라 아래 예시 CSV 파일에 입력해 주세요. 규칙을 따르지 않으면 데이터가 정상적으로 처리되지 않습니다.
주의하세요
에어브릿지 SDK가 설치된 버전의 앱이 배포되기 영업일 기준 최소 2일 전에 요청해 주세요.
규칙에 따라 디바이스 ID를 입력한 CSV 파일을 에어브릿지 CSM에게 전달해 주세요. 담당 CSM이 없는 경우 문의하기를 통해 전달해 주세요. 업로드에는 시간이 필요합니다. 업로드 완료 여부는 에어브릿지 CSM 또는 지원 담당자를 통해 확인할 수 있습니다.
주의하세요
업로드 작업 기간은 영업일 기준 최소 2일입니다. 이 기간에는 신규 식별자가 대량으로 수집될 수 있는 광고 캠페인이나 프로모션을 진행하지 마세요. 작업 기간에 수집된 식별자는 업로드되지 않아 일부 이벤트가 처음 발생한 이벤트로 잘못 집계될 수 있습니다.
에어브릿지는 유저 ID를 기준으로 앱 이벤트와 웹 이벤트의 첫 이벤트 여부를 판단합니다. 따라서 앱과 웹을 통합해 유저 기준으로 첫 이벤트를 측정하려면 유저 ID를 업로드해야 합니다.
아래 순서에 따라 수집된 유저 ID를 CSV 파일 형식으로 에어브릿지에 업로드할 수 있습니다.
수집된 유저 ID를 규칙에 따라 아래 예시 CSV 파일에 입력해 주세요. 규칙을 따르지 않으면 데이터가 정상적으로 처리되지 않습니다.
주의하세요
에어브릿지 SDK가 설치된 버전의 앱이 배포되기 영업일 기준 최소 2일 전에 요청해 주세요.
규칙에 따라 유저 ID를 입력한 CSV 파일을 에어브릿지 CSM에게 전달해 주세요. 담당 CSM이 없는 경우 문의하기를 통해 전달해 주세요. 업로드에는 시간이 필요합니다. 업로드 완료 여부는 에어브릿지 CSM 또는 지원 담당자를 통해 확인할 수 있습니다.
주의하세요
업로드 작업 기간은 영업일 기준 최소 2일입니다. 이 기간에는 신규 식별자가 대량으로 수집될 수 있는 광고 캠페인이나 프로모션을 진행하지 마세요. 작업 기간에 수집된 식별자는 업로드되지 않아 일부 이벤트가 처음 발생한 이벤트로 잘못 집계될 수 있습니다.
식별자 업로드 여부 | 이벤트 집계 | 앱 설치 이벤트 수 영향 |
|---|---|---|
X | 업데이트 후 앱을 실행하면 수집된 유저 데이터가 없어 첫 앱 실행 이벤트로 집계됩니다. 첫 앱 실행 이벤트는 앱 설치 이벤트로 집계되므로 앱 설치 이벤트 수가 일시적으로 증가할 수 있습니다. | 앱 설치 이벤트 수 증가 |
O | 업데이트 후 앱을 실행하면 수집된 유저 데이터가 있어 처음이 아닌 앱 실행 이벤트로 집계됩니다. 처음이 아닌 앱 실행 이벤트는 앱 실행 이벤트로 집계되므로 앱 설치 이벤트 수에 영향을 주지 않습니다. | 앱 설치 이벤트 수 안정화 |
식별자 업로드 여부 | 이벤트 집계 | 첫 구매 완료 이벤트 수 영향 |
|---|---|---|
X | 업데이트 후 상품을 구매하면 수집된 유저 데이터가 없어 첫 구매 완료 이벤트로 집계됩니다. 유저가 이전에 상품을 구매했어도 첫 구매 완료 이벤트로 집계되므로 첫 구매 완료 이벤트 수가 일시적으로 증가할 수 있습니다. | 첫 구매 완료 이벤트 수 증가 |
O | 업데이트 후 상품을 구매하면 수집된 유저 데이터가 있어 처음이 아닌 구매 완료 이벤트로 집계됩니다. 유저가 이전에 상품을 구매했다면 처음이 아닌 구매 완료 이벤트로 집계되므로 첫 구매 완료 이벤트 수에 영향을 주지 않습니다. | 첫 구매 완료 이벤트 수 안정화 |
그룹바이 | 첫 이벤트를 판단하는 기준 | 확인할 수 있는 이벤트 종류 |
|---|---|---|
Is First Event per Device ID | 디바이스 ID | 앱 이벤트 |
Is First Event per User ID | 유저 ID | 앱 이벤트, 웹 이벤트 |
측정 목적 | 업로드 권장 식별자 | 영향 범위 |
|---|---|---|
광고비 정산이나 앱 캠페인 최적화가 우선 | 디바이스 ID | 앱 이벤트의 첫 이벤트 여부 |
앱과 웹 이벤트를 유저 기준으로 통합 측정 | 유저 ID | 앱 이벤트, 웹 이벤트의 첫 이벤트 여부 |
두 기준 모두 사용 | 디바이스 ID와 유저 ID를 각각 별도 파일로 준비 | 위 두 항목 모두 |
규칙 | 상세 |
|---|---|
파일 이름 | · 형식: 이벤트 이름_DeviceID.csv · 예시: airbridge.user.signup_DeviceID.csv |
파일 구분 | · GAID, IDFA, IDFV 등의 디바이스 ID 종류는 구분하지 않습니다. · 파일당 최대 크기는 500MB입니다. · 한 번에 여러 개의 파일을 업로드할 수 있습니다. · 유저 ID와 별도 파일로 구분합니다. |
데이터 기간 | · 최근 1년 동안 수집된 디바이스 ID 업로드를 권장합니다. · 마케팅 캠페인 특성에 따라 수집 기간을 조정할 수 있습니다. 예시) 6개월 넘게 상품을 구매하지 않은 유저와 상품을 구매한 적이 없는 유저를 동일한 기준으로 집계하려면 최근 6개월 동안 구매 완료 이벤트를 발생시킨 유저의 식별자를 업로드합니다. |
데이터 형식 | · 형식: 버전 4 UUID로 입력합니다. · 예시: 550e8400-e29b-41d4-a716-446655440000 |
데이터 정렬 | · A열 1행부터 데이터를 입력합니다. · A열만 사용합니다. B열, C열 등은 사용하지 않습니다. · 디바이스 ID만 입력합니다. 디바이스 ID를 제외한 어떠한 정보를 입력하지 마세요. |
규칙 | 상세 |
|---|---|
파일 이름 | · 형식: 이벤트 이름_UserID.csv · 예시: airbridge.user.signup_UserID.csv |
파일 구분 | · 파일당 최대 크기는 500MB입니다. · 한 번에 여러 개의 파일을 업로드할 수 있습니다. · 디바이스 ID와 별도 파일로 구분합니다. |
데이터 기간 | · 최근 1년 동안 수집된 유저 ID 업로드를 권장합니다. · 마케팅 캠페인 특성에 따라 수집 기간을 조정할 수 있습니다. |
데이터 형식 | · 형식: 앞뒤에 공백이나 큰따옴표(")를 포함하지 않도록 주의합니다. · 예시: abcd1234 |
데이터 정렬 | · A열 1행부터 데이터를 입력합니다. · A열만 사용합니다. B열, C열 등은 사용하지 않습니다. · 유저 ID만 입력합니다. 유저 ID를 제외한 어떠한 정보를 입력하지 마세요. |
도움이 되었나요?