- 유저 가이드
- 데이터 트래킹하기
- 크로스 플랫폼 측정하기
PC 게임 측정하기
PC 게임 광고는 광고가 나오는 앱, 웹 외에 게임을 즐기는 PC를 측정해야 성과를 확인할 수 있습니다. 에어브릿지는 앱, 웹, PC 측정을 지원합니다.
알립니다
이 기능은 베타 서비스입니다. 개선 의견과 문의사항은 에어브릿지 CSM을 통해 전달해 주세요. 담당 CSM이 없는 경우 문의하기를 통해 전달해 주세요. 정식 서비스에서 발전한 기능으로 보답하겠습니다.
랜딩 페이지 활용 권장
에어브릿지는 PC 게임을 측정하기 위해 랜딩 페이지를 활용하는 것을 권장합니다. 구글 애즈에서 PC 게임을 측정하고 싶다면 반드시 랜딩 페이지를 활용해야 합니다.
PC 게임 광고 성과를 측정하기 위해서는 여러 플랫폼을 넘나 들어야 합니다. 다양한 플랫폼에서 광고를 본 유저가 게임을 즐기는 곳은 PC이기 때문입니다. PC 게임에서 발생한 성과를 측정하기 위해서는 모바일, 웹, PC에서 데이터를 수집해야 합니다.
광고를 클릭한 유저를 에어브릿지 웹 SDK를 설치한 랜딩 페이지로 이동시킨 후에 웹 사이트와 PC 게임에서 수집한 데이터를 바탕으로 광고 성과를 측정할 수 있습니다. 트래킹 링크를 사용하지 못 하는 광고 채널을 트래킹하거나 쿠키 ID를 수집해 효과적인 리타겟팅 캠페인을 준비할 수 있기 때문에 권장하는 방법입니다.
트래킹 링크와 PC게임에서 수집한 데이터를 바탕으로 광고 성과를 측정할 수 있습니다. 랜딩 페이지를 활용하지 않습니다.
PC 게임 측정 기능을 설정하기 위해서는 모바일, 웹, PC에서 수집한 데이터가 필요합니다. 그리고 수집된 데이터를 다양한 방식으로 에어브릿지에 전달해야 합니다. 랜딩 페이지에 해당하는 웹 사이트에서 수집한 데이터는 에어브릿지 SDK로 에어브릿지에 전달됩니다. PC 게임에서 수집한 데이터는 API를 통해 에어브릿지에 전달됩니다.
주의하세요
구글 애즈에서 PC 게임을 측정하고 싶다면 반드시 랜딩 페이지를 활용해야 합니다. 사전 준비사항을 참고하여 랜딩 페이지를 준비하고 에어브릿지 웹 SDK를 설치해 주세요.
랜딩 페이지를 활용한 PC 게임 측정은 사전 준비사항이 있습니다.
광고를 클릭한 유저의 목적지로 사용하는 랜딩 페이지가 필요합니다. 유저는 랜딩 페이지에서 PC 게임을 바로 시작하거나 스팀, 에픽 게임즈 스토어 같은 다른 게임 플랫폼로 이동할 수 있습니다.
해당 랜딩 페이지에 에어브릿지 웹 SDK를 설치하면 트래킹 링크를 사용하지 못 하는 광고 채널을 트래킹하거나 쿠키 ID를 수집해 효과적인 리타겟팅 캠페인을 준비할 수 있습니다.
모바일 앱을 등록하지 않고 웹 사이트만 입력해도 에어브릿지를 시작할 수 있습니다. 랜딩 페이지가 있다면 랜딩 페이지로 등록해 주세요. 나중에 수정할 수 있습니다.
에어브릿지를 시작하는 방법에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
랜딩 페이지에 에어브릿지 웹 SDK를 설치해 주세요. 웹 SDK의 UTM 파싱(Parsing) 기능을 활성화하면 트래킹 링크 없이 UTM 파라미터로 유입되는 데이터도 트래킹할 수 있습니다.
알립니다
모바일 측정을 위한 이벤트 택소노미와 상관 없이 PC 게임 측정을 위한 이벤트 택소노미를 준비해야 합니다.
이벤트 택소노미를 준비합니다. PC 게임 설치 이벤트는 반드시 처음 수집되어야 합니다. PC 게임 설치 이벤트가 수집된 이후 PC 게임에서 발생한 이벤트는 이벤트 택소노미에 따라 에어브릿지에 전송됩니다. 필요에 따라 PC 게임 실행 이벤트를 별도로 수집하는 것을 권장합니다.
PC 게임에서 발생한 이벤트를 수집한 후에 S2S 이벤트 API로 에어브릿지에 정해진 순서에 맞춰 전송해야 합니다.
아래 설정을 참고해 PC게임에서 발생한 이벤트를 S2S 이벤트 API로 전송해 주세요. S2S 이벤트 API에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요. 인웹 이벤트 전송 기능이 아닌 인앱 이벤트 전송 기능을 사용해야 합니다.
주의하세요
PC 게임 설치 이벤트가 반드시 처음 수집되어야 합니다. PC 게임 설치 이벤트가 수집되지 않으면 이후 수집되는 인게임 이벤트가 정상적으로 어트리뷰션되지 않습니다. 필요에 따라 PC 게임 실행 이벤트를 별도로 수집하는 것을 권장합니다. 에어브릿지 어트리뷰션에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
PC 게임 설치(Install)와 실행(Open) 그리고 인게임 이벤트를 전송하는 엔드포인트(Endpoint)가 다릅니다.
인게임 이벤트는 유저가 PC 게임을 시작한 후에 발생시킬 수 있는 이벤트입니다. 예를 들어 튜토리얼 완료, 특정 레벨 달성 등이 있습니다.
이벤트 |
필수 여부 |
엔드포인트 |
PC 게임 설치 | 필수 |
|
PC 게임 실행 | 선택 |
|
인게임 이벤트 | 선택 |
|
아래 테이블을 참고해 헤더를 설정해 주세요.
이름 |
필수 여부 |
설명 |
| 필수 | 에어브릿지 대시보드에서 API 토큰을 확인해 주세요. API에 요청하기 위해 필요한 API 토큰입니다. |
| 필수 | 인게임 이벤트가 발생한 IP를 |
| 선택 | API 요청과 응답에 사용할 언어를 지정합니다. ISO-639-1 기준 입니다. |
| 선택 | 리소스의 미디어 타입입니다. 기본값은 |
주의하세요
Authorization에 입력하는 API 토큰은 에어브릿지 대시보드의 [설정]>[토큰 관리]에서 확인할 수 있습니다. 반드시 API 토큰을 입력해 주세요.
아래 테이블을 참고해 PC 게임에서 수집한 이벤트를 전송해 주세요. 전송한 이벤트는 eventData.goal로 전송한 정보에 따라 스탠다드 이벤트 또는 커스텀 이벤트로 정의할 수 있습니다. 스탠다드 이벤트와 커스텀 이벤트에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
이름 |
필수 여부 |
설명 |
|---|---|---|
| 필수 | 게임 서비스에서 유저를 식별하는 ID를 전송해 주세요. 해당 ID를 기준으로 어트리뷰션 과정이 진행됩니다 에어브릿지 가이드를 참고해 주세요. |
| 선택 | PC 게임에서 수집한 이벤트가 발생한 플랫폼, 디바이스 정보에 대한 정보를 전송할 수 있습니다 |
| 선택 | PC 게임에서 수집한 이벤트를 전송합니다.
|
에어브릿지는 디바이스 정보를 함께 전송하는 것을 권장합니다. 에어브릿지는 아래와 같은 device 하위 변수를 지원합니다. 에어브릿지 사용자가 지정하는 값이 지원됩니다.
이름 | 설명 | 예시 |
device.platform | 디바이스에서 지원하는 플랫폼입니다. | - Desktop |
device.deviceType | 디바이스 유형입니다. | - mobile |
device.osName | 디바이스에서 지원하는 운영체제입니다. | - Linux |
device.osVersion | 디바이스에서 지원하는 운영체제의 버전입니다. | - XP |
device.deviceModel | 디바이스 모델 이름입니다. | - pc |
디바이스 정보를 전송해야 에어브릿지 리포트에서 PC 게임 트래킹으로 측정한 결과를 플랫폼, 운영 체제 등의 디바이스 정보 기준으로 확인할 수 있습니다.
주의하세요
디바이스 정보를 전송하지 않으면 에어브릿지 리포트에서 의도하지 않은 값이 나타날 수 있습니다.
PC 게임 설치 이벤트를 전송했나요?
PC 게임 설치 이벤트가 반드시 처음 수집되어야 합니다. PC 게임 설치 이벤트가 수집되지 않으면 이후 수집되는 인게임 이벤트가 정상적으로 어트리뷰션되지 않습니다. 필요에 따라 PC 게임 실행 이벤트를 별도로 수집하는 것을 권장합니다.
처음 전송한 PC 게임 설치(Install) 이벤트 또는 PC 게임 실행(Open) 이벤트에 따라 이후에 전송되는 인게임 이벤트의 성과 측정 여부를 결정합니다. 처음에 이벤트를 전송한 이후에 전송하는 인게임 이벤트는 자유롭게 전송할 수 있습니다.
게임에 복귀한 휴면 유저 성과는 재활성화 트래킹을 활성화하면 측정할 수 있습니다. 휴면 유저의 복귀 성과 측정에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
유저 종류 |
처음 전송하는 이벤트 |
설명 |
|---|---|---|
신규 유저 또는 에어브릿지로 트래킹한 기록이 없는 유저 | PC 게임 설치 이벤트 | 타겟 이벤트 입니다. 성과 측정을 새로 시작합니다. PC 게임 설치 이벤트를 전송한 시점부터 어트리뷰션 윈도우 동안 어트리뷰션을 진행합니다. 터치포인트가 룩백 윈도우 내에 있다면 성과로 집계됩니다 |
기존 유저 또는 에어브릿지로 트래킹한 기록 있는 유저 | PC 게임 실행 이벤트 | 타겟 이벤트가 아닙니다. 성과 측정을 새로 시작하지 않습니다. 기존 성과 측정에 포함되거나 미기여(Unattributed)로 처리됩니다 |
설정한 어트리뷰션 윈도우는 3일입니다.
일자 |
유저 |
에어브릿지로 전송하는 이벤트 |
설명 |
|---|---|---|---|
1월 1일 | 유저 A | 1. PC 게임 설치 이벤트 | PC 게임 설치 이벤트를 기준으로 성과 측정을 새로 시작합니다 |
1월 2일 | 유저 A | 1. PC 게임 실행 이벤트 | 유저가 같고 어트리뷰션 윈도우 동안 발생한 이벤트입니다. 기존 성과 측정이 계속됩니다 |
1월 3일 | 유저 B | 1. PC 게임 설치 이벤트 | PC 게임 설치 이벤트를 기준으로 성과 측정을 새로 시작합니다 |
1월 4일 | 유저 C | 1. PC 게임 실행 이벤트 | 기존 성과 측정이 없습니다. 미기여(Unattributed)로 처리됩니다 |
1월 5일 | 유저 A | 1. PC 게임 실행 이벤트 | 유저 A가 발생시킨 이벤트이지만 PC 게임 설치 이벤트를 기준으로 어트리뷰션 윈도우 이후에 발생했습니다. 따라서 기존 성과 측정이 없습니다. 미기여(Unattributed)로 처리됩니다 |
S2S 이벤트 API로 전송하는 PC 게임에서 수집한 이벤트 예시와 에어브릿지 리포트에서 이벤트를 확인하기 위해 권장하는 이벤트 택소노미 예시를 참고해 주세요.
윈도우 11을 사용하는 PC에서 스팀(Steam) 플랫폼으로 PC 게임 설치 이벤트가 발생한 상황의 디바이스 정보를 아래와 같이 준비할 수 있습니다.
이름 | 설명 |
|---|---|
device.platform | stream |
device.deviceType | desktop |
device.osName | Windows |
device.osVersion | 11 |
device.deviceModel | pc |
PC 게임 설치 이벤트를 아래와 같이 에어브릿지로 전송할 수 있습니다.
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9161' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "steam",
"deviceType": "desktop",
"osName": "Windows",
"osVersion": "11",
"deviceModel": "pc",
"screen": {
"width": 1920,
"height": 1080
}
}
}'플레이스테이션(PlayStation) 플랫폼에서 PC 게임 실행 이벤트가 발생한 상황의 디바이스 정보를 아래와 같이 준비할 수 있습니다.
이름 | 설명 |
|---|---|
device.platform | playstaion |
device.deviceType | console |
device.deviceModel | playstation_5 |
PC 게임 실행 이벤트를 아래와 같이 에어브릿지로 전송할 수 있습니다.
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9160' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "playstaion",
"deviceType": "console",
"osName": "playstation_5",
"screen": {
"width": 1920,
"height": 1080
}
}
}'주의하세요
스탠다드 이벤트를 전송하기 위해서는 에어브릿지 데이터 스펙에서 Standard Event Category에 해당하는 값을 입력해야 합니다.
안드로이드를 사용하는 PC에서 금액 데이터가 포함된 이벤트가 발생한 상황의 디바이스 정보를 아래와 같이 준비할 수 있습니다.
이름 | 설명 |
|---|---|
device.platform | Android |
device.deviceType | desktop |
device.osName | Android |
device.osVersion | 7 |
device.deviceModel | pc |
금액 데이터가 발생하는 매출 관련 이벤트는 스탠다드 이벤트로 전송하는 것을 권장합니다. 스탠다드 이벤트로 전송하면 금액 데이터를 레비뉴 리포트에서 확인하거나 포스트백에 활용할 수 있습니다.
eventData.goal.category를 airbridge.ecommerce.order.completed로 설정하면 스탠다드 이벤트 중에서 구매 완료 이벤트로 데이터를 전송하게 됩니다. eventData.goal.value에 포함된 데이터가 금액 데이터입니다.
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9360' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "Android",
"deviceType": "desktop",
"osName": "Android",
"osVersion": "7",
"deviceModel": "pc",
"screen": {
"width": 1920,
"height": 1080
}
},
"eventData": {
"goal": {
"category": "airbridge.ecommerce.order.completed",
"value": 1.234
}
}
}'iOS를 사용하는 PC에서 인게임 이벤트가 발생한 상황의 디바이스 정보를 아래와 같이 준비할 수 있습니다.
이름 | 설명 |
|---|---|
device.platform | iOS |
device.deviceType | desktop |
device.osName | iOS |
device.osVersion | 17.1 |
device.deviceModel | Mac |
유저가 실제로 발생시킨 다양한 인게임 이벤트를 에어브릿지로 전송할 수 있습니다.
전송한 이벤트는 eventData.goal로 전송한 정보에 따라 정의됩니다. 예를 들어 eventData.goal.category가 커스텀 이벤트인 buy_item (App)이기 때문에 액츄얼스 리포트에서 buy_item (App)을 선택하면 해당 이벤트의 성과를 확인할 수 있습니다.
curl --location 'https://api.airbridge.io/events/v1/apps/{{ APP_NAME }}/mobile-app/9360' \
--header 'Authorization: AIRBRIDGE-API-TOKEN {{ API_TOKEN }}' \
--header 'Content-Type: application/json' \
--header 'X-Forwarded-For: {{ CLIENT_IP }}' \
--data '{
"user": {
"externalUserID": "abrid123"
},
"device": {
"platform": "iOS",
"deviceType": "desktop",
"osName": "iOS",
"osVersion": "17.1",
"deviceModel": "Mac",
"screen": {
"width": 1920,
"height": 1080
}
},
"eventData": {
"goal": {
"category": "buy_item",
"action": "weapon",
"label": "longsword",
"value": 1.234,
"customAttributes": {
"foo": "foo",
"bar": 1.234
}
}
}
}'정상적으로 PC 게임 트래킹이 되는지 아래 항목을 확인해 보세요.
테스트 |
내용 |
권장하는 해결 방법 |
|---|---|---|
기여 | 유저가 랜딩 페이지에서 또는 다른 게임 플랫폼으로 이동한 후에 발생한 PC 게임 설치 이벤트와 인게임 이벤트가 의도한 광고 채널에 기여되는지 확인해야 합니다. 랜딩 페이지 URL에 포함된 UTM 파라미터에서 확인한 광고 채널과 에어브릿지 파라미터에서 확인한 광고 채널이 일치하는지 확인해 주세요. | 랜딩 페이지에 설치한 에어브릿지 웹 SDK에서 utm파싱(UTM Parsing) 기능이 설정됐는지 확인해 주세요. |
API 설정 | API 설정대로 이벤트가 수집되는지 확인해야 합니다. | API 설정을 다시 확인해 주세요 |
PC 게임 측정 기능을 설정하기 위해서는 모바일, 웹, PC에서 수집한 데이터가 필요합니다. 그리고 수집된 데이터를 다양한 방식으로 에어브릿지에 전달해야 합니다. 트래킹 링크에서 수집한 데이터는 에어브릿지 SDK로 에어브릿지에 전달됩니다. PC 게임에서 수집한 데이터는 API를 통해 에어브릿지에 전달됩니다.
주의하세요
구글 애즈에서 PC 게임을 측정하고 싶다면 반드시 랜딩 페이지를 활용해야 합니다. 권장) 랜딩 페이지 활용 PC 게임 측정 설정하기를 참고해 주세요.
트래킹 링크를 활용한 PC 게임 측정은 사전 준비사항이 있습니다.
광고에 사용하는 트래킹 링크를 생성합니다. 연동 채널용 트래킹 링크의 [리다이렉트 경로]>[최종 목적지]>[웹사이트]에서 모든 플랫폼에 랜딩 페이지 주소를 입력합니다. 별도 랜딩 페이지를 운영하고 있지 않다면 스팀, 에픽 게임즈 스토어 같은 다른 게임 플랫폼 주소를 입력합니다.
트래킹 링크를 생성하는 자세한 방법은 에어브릿지 가이드를 참고해 주세요.
모바일 앱을 등록하지 않고 웹 사이트만 입력해도 에어브릿지를 시작할 수 있습니다. 랜딩 페이지가 있다면 랜딩 페이지로 등록해 주세요. 나중에 수정할 수 있습니다.
에어브릿지를 시작하는 방법에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.
알립니다
모바일 측정을 위한 이벤트 택소노미와 상관 없이 PC 게임 측정을 위한 이벤트 택소노미를 준비해야 합니다.
이벤트 택소노미를 준비합니다. PC 게임 설치 이벤트는 반드시 처음 수집되어야 합니다. PC 게임 설치 이벤트가 수집된 이후 PC 게임에서 발생한 이벤트는 이벤트 택소노미에 따라 에어브릿지에 전송됩니다. 필요에 따라 PC 게임 실행 이벤트를 별도로 수집하는 것을 권장합니다.
PC 게임에서 발생한 이벤트를 수집한 후에 S2S 이벤트 API로 에어브릿지에 정해진 순서에 맞춰 전송해야 합니다. 전송 방법은 랜딩 페이지를 활용하는 PC 게임 측정 설정하기와 동일합니다.
정상적으로 PC 게임 트래킹이 되는지 아래 항목을 확인해 보세요.
테스트 |
내용 |
권장하는 해결 방법 |
|---|---|---|
기여 | 트래킹 링크를 클릭한 이후에 발생한 PC 게임 설치 이벤트와 인게임 이벤트가 의도한 광고 채널에 기여되는지 확인해야 합니다. 에어브릿지 대시보드 [원본 데이터]>[앱 이벤트 실시간 로그]에서 확인한 PC 게임 설치 이벤트와 인게임 이벤트를 발생시킨 광고 채널을 확인해 주세요. | 인게임 이벤트가 발생한 IP를 |
API 설정 | API 설정대로 이벤트가 수집되는지 확인해야 합니다. | API 설정을 다시 확인해 주세요 |
PC 게임 트래킹으로 확인할 수 있는 광고 성과는 에어브릿지 리포트에서 확인할 수 있습니다. PC 게임에서 발생한 이벤트는 인앱 이벤트로 전송됐기 때문에 앱 메트릭을 선택하면 조회할 수 있습니다. 앱 메트릭은 메트릭 이름에 (App)이 있는 메트릭입니다.
PC 게임에서 전송한 이벤트는 eventData.goal로 전송한 정보에 따라 스탠다드 이벤트 또는 커스텀 이벤트로 정의됩니다. eventData.goal 설정에 따라 액츄얼스 리포트를 조회하면 광고 성과를 확인할 수 있습니다.
특정 레벨 달성 이벤트를 아래처럼 커스텀 이벤트로 설정했습니다.
eventData.goal.category: level_achievedeventData.goal.action: 특정 레벨을 달성한 게임 내에 있는 지역에 대한 정보를 전송합니다. 지역 정보는 예를 들어 region_1, region_2 등으로 전송할 수 있습니다.eventData.goal.label: 특정 레벨을 달성한 방법을 전송합니다. 달성 방법은 예를 들어 quest, pvp, pve 등으로 전송할 수 있습니다.
액츄얼스 리포트에서 메트릭으로 level_achieved (App)을 선택합니다. 그리고 그룹바이로 Channel, Event Action, Event Label을 선택하면 아래 같은 결과를 확인할 수 있습니다.
아이템 구매 이벤트를 아래처럼 커스텀 이벤트로 설정했습니다.
eventData.goal.category: purchase_itemeventData.goal.action: 구매한 아이템 등급에 대한 정보를 전송합니다. 구매한 아이템 등급은 예를 들어 epic_item, unique_item 등으로 전송할 수 있습니다.eventData.goal.label: 구매한 아이템 종류에 대한 정보를 전송합니다. 구매한 아이템 종류는 예를 들어 sword, shield, helmet 등으로 전송할 수 있습니다.
액츄얼스 리포트에서 메트릭으로 purchase_item (App)을 선택합니다. 그리고 그룹바이로 Channel, Event Action, Event Label을 선택하면 아래 같은 결과를 확인할 수 있습니다.
에어브릿지가 제공하는 다양한 리포트 종류와 기능을 확인해 보세요.
아래 사항을 주의해 주세요.
PC 게임 트래킹은 확률적 모델링 매칭을 활용합니다. 같은 유저인지 추측하는 기간은 6시간입니다. PC 게임 트래킹에 한해서 해당 기간을 수정할 수 있습니다.
아래에 있는 자주 하는 실수를 주의해 주세요.
타겟 이벤트 누락: PC 게임 측정의 타겟 이벤트인 PC 게임 설치 이벤트를 인게임 이벤트 전송 전에 먼저 전송해야 합니다. 타겟 이벤트가 누락되면 모든 인게임 이벤트의 성과가 미기여(Unattributed)로 측정될 수 있습니다. 필요에 따라 PC 게임 실행 이벤트를 별도로 수집하는 것을 권장합니다.
IP 전송 누락: 인게임 이벤트가 발생한 IP를
X-Forwarded-For헤더로 전송해야 합니다.잘못된 엔드포인트 사용: 이벤트마다 API 엔드포인트가 다릅니다. 전송하는 이벤트에 알맞은 엔드포인트를 사용해 주세요.
S2S 이벤트 API 설정 오류: S2S 이벤트 API의 인앱 이벤트 설정으로 전송해 주세요. 인웹 이벤트가 아닙니다.
도움이 되었나요?