Airbridge와 통합

글로서리

Airbridge

모바일 마케팅 어트리뷰션 및 분석 플랫폼입니다. 내장된 보고, 딥 링크, 대상 관리 기능을 통해 앱과 웹사이트 전반에서 사용자 여정을 추적하고 성장을 최적화할 수 있도록 지원합니다.

플랫폼에 대한 자세한 내용은 Airbridge 문서를 참조하십시오.

애플리케이션 스토어 ID

플랫폼(Android 또는 iOS)별로 할당된 고유한 모바일 애플리케이션 ID입니다. Airbridge 계정에서 확인한 후 아래에 설명된 바와 같이 관리자 페이지의 해당 입력란에 붙여넣으세요.

플랫폼(Android 또는 iOS)별로 할당된 고유한 모바일 애플리케이션 ID입니다. Airbridge 계정에서 확인한 후 아래에 설명된 바와 같이 모바일 게임 계정의 해당 입력란에 붙여넣으세요.

Airbridge ID

Airbridge에서 생성된 사용자 ID입니다. 자세한 내용은 Airbridge 문서를 참조하십시오.

평생 가치(LTV)

애플리케이션을 사용하는 동안 사용자가 생성한 평균 수익입니다. LTV에 대한 자세한 내용은 Airbridge 문서를 참조하십시오.

광고 투자 대비 수익(ROAS)

광고 지출 단위당 벌어들인 수익을 계산하여 광고 캠페인의 효과를 측정하는 지표입니다. ROAS에 대한 자세한 내용은 Airbridge 문서를 참조하십시오.

인앱 이벤트

애플리케이션 내에서의 사용자 활동. 인앱 이벤트에 대한 자세한 내용은 Airbridge 문서를 참조하십시오. 웹샵 솔루션에서의 사용자 활동도 S2S(Server-to-Server) 통합의 경우 인앱 이벤트로 간주되어 엑솔라 백엔드에서 Airbridge로 전송됩니다.

사용자 확보

마케팅 활동을 통해 사이트, 서비스, 플랫폼 또는 애플리케이션에 신규 사용자를 유치하는 과정입니다. 자세한 내용은 Airbridge 문서를 참조하십시오.

고객 사용자 ID(CUID)

사용자 등록 시 애플리케이션 소유자가 생성하고 설정한 사용자 ID입니다. СUID는 웹샵 솔루션과 Airbridge에서 동일해야 합니다. 이 매개 변수는 사용자 매칭 및 어트리뷰션에 사용됩니다.

웹 스토어와 모바일 애플리케이션의 CUID가 일치하지 않는 경우 웹샵 솔루션에서 사용자 유효성 검사 웹훅 또는 딥링크를 통한 인증을 실행하려면 고객 성공 관리자에게 연락하거나 [email protected]으로 이메일을 보내세요.

Postback

인앱 이벤트에 대한 데이터를 수신하는 프로세스입니다. 자세한 내용은 Airbridge 문서를 참조하십시오.

Airbridge S2S 토큰

Airbridge로 이벤트 데이터를 전송하기 위한 S2S 호출 인증에 사용되는 토큰입니다. Airbridge 측에서 생성됩니다.

통합 시나리오

Airbridge와 엑솔라는 모바일 애플리케이션과 웹샵 솔루션을 위해 전체 LTV 및 ROAS 측정 완료를 허용하는 모바일 애플리케이션 S2S 통합을 지원합니다. 엑솔라는 웹샵 솔루션 구매 정보를 모바일 인앱 이벤트로 Airbridge에 전송합니다. Airbridge는 모바일 애플리케이션 설치 수, 사용자 획득 및 재참여 캠페인에 귀속시킵니다.

다음과 같은 경우 모바일 애플리케이션 통합을 구성하여 고급 이벤트 분석을 얻을 수 있습니다:

Android/iOS 플랫폼에 모바일 애플리케이션이 있는 경우.
Airbridge를 사용하는 경우.
인게임 아이템을 판매하는 데 웹샵 솔루션을 사용하는 경우.

엑솔라와 Airbridge S2S 통합을 통해 다음 이벤트를 이용할 수 있습니다:

이벤트	설명
xsolla-billing-payment Airbridge 측에서 `Order Complete`로 표시됩니다.	아이템 구매. 이벤트 매개 변수에는 구매에 대한 정보가 포함되어 있습니다.

작동 방식

이 통합에는 엑솔라와 Airbridge 간의 양방향 데이터 흐름이 포함됩니다. 다음은 사용자가 구매할 때 시스템이 상호 작용하는 시나리오입니다.

  sequenceDiagram
    participant U as 사용자
    participant MA as 모바일 앱
    participant WS as 웹샵 솔루션
    participant XB as 엑솔라 백엔드
    participant AB as Airbridge
    U->>MA: 로그인
    MA->>AB: CUID 전송
    AB-->>XB: 포스트백 전송
    U->>WS: CUID로 로그인
    U->>WS: 구매
    WS->>XB: 구매 이벤트 전송
    XB->>AB: xsolla-billing-payment 이벤트 전송

사용자(플레이어)가 모바일 애플리케이션에 가입하거나 로그인합니다.
애플리케이션이 인앱 이벤트를 Airbridge에 전송합니다. 이 이벤트에 대한 예로, login, signup 또는 CUID를 포함하는 다른 이벤트를 들 수 있습니다.
Airbridge는 포스트백을 엑솔라에 전송합니다. 여기에는 애플리케이션 스토어 ID, Airbridge ID, CUID, 기타 관련 데이터 매개 변수가 포함됩니다.
사용자가 CUID를 사용하여 웹샵 솔루션에 로그인합니다.
사용자가 웹샵 솔루션에서 구매를 진행합니다.
구매 이벤트는 엑솔라 서버로 전송되어 Airbridge에서 수신한 데이터와 매칭됩니다.
엑솔라 서버는 Airbridge에서 받은 Airbridge ID, 애플리케이션 스토어 ID 및 기타 매개 변수가 포함된 S2S 인앱 이벤트를 Airbridge에 전송합니다.

Airbridge는 새로운 이벤트, 구매 및 수익을 사용자 확보 또는 사용자 재참여를 유도한 미디어 소스에 귀속시킵니다.

관리자 페이지에서 설정하는 방법

관리자 페이지에서 프로젝트를 열고 통합 섹션으로 이동합니다.

계정에서 설정하는 방법

모바일 게임 계정에서 프로젝트를 열고 운영 > MMP 섹션으로 이동하세요.

Airbridge 창을 클릭합니다.
모바일 앱 S2S 통합 창에서 구성을 클릭합니다.

창이 열리면 이 통합 활성화 상자를 선택하세요.
다음 데이터를 입력하십시오:
- Airbridge S2S 토큰.
- 퍼블리싱 플랫폼(Android/iOS)용 애플리케이션 스토어 ID입니다. 플랫폼을 추가하려면 애플리케이션 ID 추가를 클릭하십시오.

아래에 설명된 바와 같이 Airbridge 계정에서 해당 매개 변수 값을 복사해야 합니다.

저장을 클릭합니다.
Airbridge에서 통합을 활성화합니다.

설정을 저장하면 S2S 통합 창에 녹색 표시등이 표시됩니다.

연결된 통합을 변경하는 방법:

Airbridge 창을 클릭합니다.
창이 열릴 경우 필요한 사항을 변경합니다.
저장을 클릭합니다.

Airbridge에서 설정하는 방법

Airbridge에서 다음을 수행해야 합니다.

자격 증명을 가져와야 합니다.
엑솔라와 통합 기능을 활성화해야 합니다.

자격 증명 가져오기

Airbridge 계정에 로그인합니다.
Integration > Third-party integration 섹션으로 이동합니다.
Xsolla 창을 클릭합니다.

Set up Xsolla dashboard 섹션에서 Application store ID 및 Airbridge S2S token 값을 복사하여 관리자 페이지에 붙여넣기합니다.

Set up Xsolla dashboard 섹션에서 Application store ID 및 Airbridge S2S token 값을 복사하여 내 계정에 붙여넣기합니다.

엑솔라와 통합 활성화

관리자 페이지에서 통합을 활성화한 후 다음을 수행하십시오:

모바일 게임 계정에서 통합을 활성화한 이후에

Airbridge 계정에 로그인합니다.
Integration > Third-party integration 섹션으로 이동합니다.
Xsolla 창을 클릭합니다.
Send events 토글을 활성화로 설정합니다.

앱 추적 투명성(ATT)을 거부한 iOS 사용자가 데이터를 공유하려면 EPC (Extended Privacy Control) 토글을 비활성화 상태로 설정하십시오. 이 토글이 비활성화된 경우 Settings > App settings 섹션으로 이동하여 업데이트하십시오.

이벤트 값 구조

특정 이벤트를 설정하거나 현재 통합 옵션이 요구 사항을 충족하지 못하는 경우에는 고객 성공 관리자에게 문의하거나 [email protected]으로 이메일을 전송하십시오.

아이템 구매

사용자가 웹샵 솔루션에서 구매하면 엑솔라는 Airbridge에 xsolla-billing-payment 이벤트를 전송합니다. 이벤트 매개 변수에 다음과 같은 구매 정보가 전달됩니다:

매개 변수	설명
content_id	구매 시 단일 SKU 또는 여러 SKU.
quantity	해당 SKU를 가진 아이템의 수량(하나 또는 여러 개).
revenue	구매 금액. 할인이 포함되어 있습니다. 수수료 및 세금은 포함되어 있지 않습니다.
currency	인게임 재화 구매.

추가 데이터

또한 포스트백에서 다음 매개 변수를 전달할 수 있습니다:

매개 변수	설명
device.deviceUUID	Airbridge 측의 장치 ID(모든 플랫폼).
device.gaid	Google 광고 ID.
device.appSetID	앱 설정 ID.
device.ifa	앱 스토어의 광고주 ID.
device.ifv	Apple 측의 공급업체 ID.

의견을 보내 주셔서 감사드립니다!

메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.

마지막 업데이트: 2026년 8월 28일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

콘텐츠

글로서리
통합 시나리오
작동 방식
관리자 페이지에서 설정하는 방법
계정에서 설정하는 방법
Airbridge에서 설정하는 방법
자격 증명 가져오기
엑솔라와 통합 활성화
이벤트 값 구조
아이템 구매
추가 데이터