광고를 클릭한 유저를 에어브릿지 웹 SDK를 설치한 랜딩 페이지로 이동시킨 후에 웹 사이트와 PC 게임에서 수집한 데이터를 바탕으로 광고 성과를 측정할 수 있습니다. 트래킹 링크를 사용하지 못 하는 광고 채널을 트래킹하거나 쿠키 ID를 수집해 효과적인 리타겟팅 캠페인을 준비할 수 있기 때문에 권장하는 방법입니다.

트래킹 링크와 PC게임에서 수집한 데이터를 바탕으로 광고 성과를 측정할 수 있습니다.

광고를 클릭한 유저의 목적지로 사용하는 랜딩 페이지가 필요합니다. 유저는 랜딩 페이지에서 PC 게임을 바로 시작하거나 스팀, 에픽 게임즈 스토어 같은 다른 게임 플랫폼로 이동할 수 있습니다.

해당 랜딩 페이지에 에어브릿지 웹 SDK를 설치하면 트래킹 링크를 사용하지 못 하는 광고 채널을 트래킹하거나 쿠키 ID를 수집해 효과적인 리타겟팅 캠페인을 준비할 수 있습니다.

모바일 앱을 등록하지 않고 웹 사이트만 입력해도 에어브릿지를 시작할 수 있습니다. 랜딩 페이지가 있다면 랜딩 페이지로 등록해 주세요. 나중에 수정할 수 있습니다.

에어브릿지를 시작하는 방법에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

랜딩 페이지에 에어브릿지 웹 SDK를 설치해 주세요. 웹 SDK의 UTM 파싱(Parsing) 기능을 활성화하면 트래킹 링크 없이 UTM 파라미터로 유입되는 데이터도 트래킹할 수 있습니다.

• 에어브릿지 웹 SDK 설치하기

• UTM 파싱 기능 활성화하기

이벤트 택소노미를 준비합니다. PC 게임에서 발생한 이벤트는 이벤트 택소노미에 따라 S2S 이벤트 API로 에어브릿지에 전송됩니다.

• 이벤트 택소노미

아래 설정을 참고해 PC게임에서 발생한 이벤트를 S2S 이벤트 API로 전송해 주세요. S2S 이벤트 API에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요. 인웹 이벤트 전송 기능이 아닌 인앱 이벤트 전송 기능을 사용해야 합니다.

PC 게임 설치(Install)와 실행(Open) 그리고 인게임 이벤트를 전송하는 엔드포인트(Endpoint)가 다릅니다.

인게임 이벤트는 유저가 PC 게임을 시작한 후에 발생시킬 수 있는 이벤트입니다. 예를 들어 튜토리얼 완료, 특정 레벨 달성 등이 있습니다.

인게임 이벤트가 발생한 IP를 X-Forwarded-For 헤더로 전달해 주세요.

X-Forwarded-For 헤더로 인게임 이벤트가 발생한 IP를 전달하지 않으면 전송하는 이벤트에 API를 호출한 서버 IP가 기록됩니다. 전송하는 이벤트에 API를 호출한 서버 IP가 기록되면 광고 클릭과 인게임 이벤트가 매칭되지 않습니다.

아래 테이블을 참고해 PC 게임에서 수집한 이벤트를 전송해 주세요. 전송한 이벤트는 eventData.goal로 전송한 정보에 따라 스탠다드 이벤트 또는 커스텀 이벤트로 정의할 수 있습니다. 스탠다드 이벤트와 커스텀 이벤트에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

유저가 게임에 접속할 때마다 PC 게임 설치(Install) 이벤트 또는 PC 게임 실행(Open) 이벤트를 유저 종류에 따라 다른 인게임 이벤트를 전송하기 전에 전송해 주세요. 처음 전송한 이벤트가 이후에 전송되는 인게임 이벤트의 성과 측정 여부를 결정합니다. 처음에 전송한 이벤트 이후에 전송하는 인게임 이벤트는 자유롭게 전송할 수 있습니다.

게임에 복귀한 휴면 유저 성과는 재활성화 트래킹을 활성화하면 측정할 수 있습니다. 휴면 유저의 복귀 성과 측정에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

설정한 어트리뷰션 윈도우는 3일입니다.

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",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    }
}'

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": "steam",
        "deviceType": "desktop",
        "osName": "Windows",
        "osVersion": "11",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    }
}'

유저가 실제로 발생시킨 다양한 인게임 이벤트를 에어브릿지로 전송할 수 있습니다.

전송한 이벤트는 eventData.goal로 전송한 정보에 따라 정의됩니다. 예를 들어 eventData.goal.category가 buy_item이기 때문에 액츄얼스 리포트(Actuals Report)에서 buy_item을 선택하면 해당 이벤트의 성과를 확인할 수 있습니다.

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": "steam",
        "deviceType": "desktop",
        "osName": "Windows",
        "osVersion": "11",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    },
    "eventData": {
        "goal": {
            "category": "buy_item",
            "action": "weapon",
            "label": "longsword",
            "value": 1.234,
            "customAttributes": {
                "foo": "foo",
                "bar": 1.234
            }
        }
    }
}'

금액 데이터가 발생하는 매출 관련 이벤트는 스탠다드 이벤트로 전송하는 것을 권장합니다. 스탠다드 이벤트로 전송하면 금액 데이터를 레비뉴 리포트(Revenue Report)에서 확인하거나 포스트백에 활용할 수 있습니다.

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": "steam",
        "deviceType": "desktop",
        "osName": "Windows",
        "osVersion": "11",
        "screen": {
            "width": 1920,
            "height": 1080
        }
    },
    "eventData": {
        "goal": {
            "category": "airbridge.ecommerce.order.completed",
            "value": 1.234
        }
    }
}'

특정 레벨 달성 이벤트를 아래처럼 커스텀 이벤트로 설정했습니다.

• eventData.goal.category: level_achieved

• eventData.goal.action: 특정 레벨을 달성한 게임 내에 있는 지역에 대한 정보를 전송

• eventData.goal.label: 특정 레벨을 달성한 방법을 전송

액츄얼스 리포트에서 메트릭으로 level_achieved (App)을 선택합니다. 그리고 그룹바이로 Channel, Event Action, Event Label을 선택하면 아래 같은 결과를 확인할 수 있습니다.

아이템 구매 이벤트를 아래처럼 커스텀 이벤트로 설정했습니다.

• eventData.goal.category: purchase_item

• eventData.goal.action: 구매한 아이템 등급에 대한 정보를 전송

• eventData.goal.label: 구매한 아이템 종류에 대한 정보를 전송

액츄얼스 리포트에서 메트릭으로 purchase_item (App)을 선택합니다. 그리고 그룹바이로 Channel, Event Action, Event Label을 선택하면 아래 같은 결과를 확인할 수 있습니다.

PC 게임 트래킹은 확률적 모델링 매칭을 활용합니다. 같은 유저인지 추측하는 기간은 6시간입니다. PC 게임 트래킹에 한해서 해당 기간을 수정할 수 있습니다.

아래에 있는 자주 하는 실수를 주의해 주세요.

• IP 전송 누락: 인게임 이벤트가 발생한 IP를 X-Forwarded-For 헤더로 전송해야 합니다.

• 잘못된 엔드포인트 사용: 이벤트마다 API 엔드포인트가 다릅니다. 전송하는 이벤트에 알맞은 엔드포인트를 사용해 주세요.

• S2S 이벤트 API 설정 오류: S2S 이벤트 API의 인앱 이벤트 설정으로 전송해 주세요. 인웹 이벤트가 아닙니다.