Adjust와 통합

글로서리

Adjust

모바일 어트리뷰션 및 마케팅 분석 플랫폼인 Adjust를 사용하면 애플리케이션 개발자, 마케터, 브랜드가 다양한 채널과 장치에서 마케팅 캠페인의 효과를 추적, 측정, 최적화할 수 있습니다.

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

앱 토큰

각 플랫폼(Android, iOS 등)에 대한 고유한 모바일 애플리케이션 ID입니다. Adjust에 애플리케이션 추가 시 자동으로 생성됩니다. 이 값은 해당 애플리케이션의 이름 옆에 있는 AppView > All apps 섹션에 있는 Adjust에서 찾을 수 있습니다.

Adjust ID

Adjust에서 생성한 사용자 ID입니다.

평생 가치(LTV)

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

광고 투자 대비 수익(ROAS)

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

인앱 이벤트

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

사용자 확보

마케팅 활동을 통해 사이트, 서비스, 플랫폼 또는 애플리케이션에 새로운 사용자를 끌어들이는 프로세스입니다.

고객 사용자 ID(CUID)

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

다음 지침에 따라 CUID를 xsolla_cuid 파트너 매개 변수로 전달해야 합니다.

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

콜백

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

서버 간(S2S) 보안 토큰

Adjust에 이벤트 데이터를 전송하기 위해 S2S 호출을 승인하는 데 사용하는 토큰입니다. Adjust 측에서 생성됩니다. S2S 토큰에 대한 자세한 내용은 Adjust 문서를 참조하십시오.

애플리케이션이 서로 다른 플랫폼(iOS, Android)에 배포되어 있고 각기 다른 애플리케이션 ID를 사용하는 경우, 두 플랫폼에서 공통으로 사용하는 단일 S2S 보안 토큰을 생성해야 합니다.

리타겟팅

이전에 애플리케이션 또는 사이트와 상호 작용한 참여 사용자의 전략. 이 전략의 목적은 현재 활동을 복원하거나 광고 캠페인을 통해 사용자를 비활성화하는 데 있습니다. 자세한 내용은 Adjust 참조 문서를 참조하십시오.

웹 이벤트

웹샷 솔루션의 클라이언트 측에서 Adjust로 전송된 웹샷 솔루션에서의 사용자 작업으로, 웹 SDK 통합에 필요합니다.

연동 시나리오

Adjust와 엑솔라는 다음과 같은 유형의 통합을 지원합니다:

애플리케이션 내에서 그리고 웹샵 솔루션에서 구매를 위해 전체 LTV 및 ROAS 측정 완료를 허용하는 모바일 애플리케이션 S2S 통합을 지원합니다. 엑솔라는 웹샵 솔루션에서의 구매 정보를 모바일 인앱 이벤트로 Adjust에 전송합니다.
Adjust는 이벤트를 모바일 애플리케이션 설치 수, 사용자 획득 및 재참여 캠페인에 귀속시킵니다.
Web Shop 트래픽을 늘리기 위한 사용자 확보 및 리타게팅 캠페인의 효과를 측정 및 평가할 수 있도록 허용하는 웹 SDK 연동. 웹 SDK 통합 기능은 리타게팅 캠페인을 통해 사이트에 방문한 사용자 수와 사이트로 연결되는 채널의 전환을 평가할 수 있습니다. 엑솔라는 Web Shop의 구매에 대한 정보를 웹 이벤트로 Adjust에 전송하며, Adjust는 해당 미디어 소스, 캠페인, 광고 세트 및 사용자를 구매로 유도한 광고에 기여한 것으로 간주합니다.

두 시나리오를 모두 구성할 계획인 경우, 웹 SDK 통합을 위해 Adjust 내에서 웹 애플리케이션을 생성하는 것이 좋습니다. 이는 Adjust 내에서 플랫폼별로 정확한 ROAS 기여도 분석 작업을 보장하는 데 필요합니다.

다음의 경우 Adjust와 Web SDK 통합을 구성하여 고급 이벤트 분석 결과를 얻을 수 있습니다:

Adjust를 사용하는 경우
엑솔라 웹사이트 빌더를 사용하여 사이트를 생성한 경우

웹 SDK 통합을 통해 다음 이벤트를 이용할 수 있습니다:

이벤트	설명
`xsolla-web-event`	사용자가 어디에서 왔는지 소스 정보가 포함된 URL 매개 변수와 당사자 쿠키에 저장되는 장치 ID를 포함한 사이트 방문 이벤트.
`xsolla-web-identify`	장치 ID 및 CUID를 포함한 로그인 이벤트.
`xsolla-web-purchase`	아이템 구매 이벤트(사이트 빌더 이벤트 포함). 거래 내역도 포함될 수 있습니다.

작동 방식

다음은 사용자 확보 및 리타겟팅 캠페인 구현 시 시스템 상호 작용에 대한 시나리오입니다. 사용자가 광고 배너를 통해 웹샵 솔루션으로 이동하여 구매를 진행합니다. 이 과정에서 Adjust로 전송되는 일련의 이벤트를 통해:

얼마나 많은 사용자가 각 배너를 클릭했는지 그리고 어떤 배너를 통해 유입되었는지
사용자가 결제한 금액
리타게팅 캠페인의 효과 여부

등을 확인할 수 있습니다.

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant Adjust as Adjust
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>Adjust: 3. xsolla-web-event event
    User->>Shop: 4. Logs in with CUID
    Shop->>Adjust: 5. xsolla-web-identify event
    User->>Shop: 6. Makes purchase
    Shop->>Adjust: 7. xsolla-web-purchase event

사용자 절차:

사용자가 광고 캠페인 배너를 클릭합니다.
사용자는 웹샵 솔루션으로 리디렉션되며, 이 전환의 URL에는 사용자가 어떤 배너와 웹 사이트로부터 연결되었는지 지정하는 매개 변수가 포함되어 있습니다.
방문에 대한 이벤트가 웹샵 솔루션의 클라이언트 측에서 Adjust로 전송됩니다.
사용자가 CUID를 사용하여 웹샵 솔루션에 로그인합니다.
인증 이벤트가 Adjust로 전송됩니다.
사용자가 Web Shop에서 구매를 합니다.
구매 이벤트가 Adjust로 전송됩니다.

Adjust에서 설정하는 방법

Adjust에서 다음을 수행해야 합니다:

웹 애플리케이션 생성.
Adjust 분석 보고서에 포함하고자 하는 이벤트 생성.
엑솔라와 통합 활성화.

웹 애플리케이션 생성

Adjust 계정에 로그인합니다.
AppView > All apps 섹션으로 이동합니다.
New app을 클릭합니다.

이름을 지정하고 보고 통화를 선택합니다.
Add app을 클릭합니다.
Add platform을 클릭합니다.
Web을 선택합니다.

웹샵 솔루션 URL을 지정합니다.
Save를 클릭합니다.

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

이벤트 생성

Adjust 계정에서 다음 역할 중 하나를 맡고 있어야 토큰을 보고 관리할 수 있습니다:

관리자
편집자
사용자 지정 편집자

Adjust 계정에 로그인합니다.
AppView > All apps 섹션으로 이동합니다.
필요한 애플리케이션의 이름을 클릭합니다.

Events 탭에서, Add event를 클릭합니다.

다음 이벤트를 하나씩 추가합니다:
- 사이트 방문에 관한 일반 정보를 수신하는 이벤트(예: xsolla-web-event).
- 사용자 인증에 관한 정보를 수신하는 이벤트(예: xsolla-web-identify).
- 구매에 관한 정보를 수신하는 이벤트(예: xsolla-web-purchase).

이벤트 이름을 지정하고 필요에 맞게 규칙을 설정할 수 있습니다. 이벤트를 추가한 경우 Events 탭 목록에 표시됩니다.

엑솔라와 통합 활성화

Adjust 계정에 로그인합니다.
Campaign Lab > Partners 섹션으로 이동합니다.
New partner를 클릭합니다.

검색 창에 Xsolla를 입력하고 선택합니다.
Next를 클릭합니다.

통합을 구성할 애플리케이션을 선택합니다.
Next를 클릭합니다.
데이터 공유를 활성화합니다. 이렇게 하려면Enable data sharing 블록에서, Edit을 클릭하고 토글을 활성화로 설정한 다음, Enable을 클릭하십시오.

이벤트 매핑 구성:

1. Map your events 블록에서, Map event를 클릭합니다.
2. 테이블에 따라 이벤트 매핑:

Adjust event	Partner event
사이트 방문에 관한 일반 정보를 받기 위해 생성한 이벤트.	Xsolla Web Events
사용자 인증에 관한 정보를 수신하기 위해 생성한 이벤트.	Xsolla Web Identify
구매 관련 정보를 수신하기 위해 생성한 이벤트.	Xsolla Web Purchase

1. Apply를 클릭합니다.

Next를 클릭합니다.
설정을 확인하고 Enable partner를 클릭합니다. 필요한 경우 이전 단계로 돌아가서 설정을 업데이트할 수 있습니다.

Campaign lab > Partners > 귀하의 애플리케이션 > Data sharing 섹션에서 기존 통합 설정을 업데이트한 경우, 변경 사항을 저장하려면 반드시 Save를 클릭하십시오.

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

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

웹 SDK(웹사이트 빌더) 창에서 구성을 클릭합니다. 웹 사이트 목록으로 리디렉션됩니다.

스토어프런트 > 웹 사이트 섹션으로 이동하여 이 목록에 액세스할 수 있습니다.

필요한 사이트의 창에서 구성을 클릭합니다.
사이트 설정 탭에서 앱 섹션으로 이동합니다.
Adjust 웹 SDK 창에서 구성을 클릭합니다.

모달 창이 열리면 앱 토큰을 입력합니다.
연결을 클릭합니다.

Adjust 계정의 이벤트 정보를 확인하려면 Datascape > Reports > All reports 섹션으로 이동하십시오. 보고서 작업에 대한 자세한 내용은 Adjust 문서를 참조하세요.

웹샵 솔루션을 위한 웹 및 인앱 광고 캠페인 실행 방법

웹샵 솔루션을 위해 다음과 같은 사용자 획득 및 리타게팅 광고 캠페인을 실행하고 추적할 수 있습니다:

웹 소스에서 사용자를 웹샵 솔루션으로 유도하는 웹 캠페인. 이 경우 Adjust에서 추적 및 기여도 분석 작업을 처리합니다.
사용자를 애플리케이션에서 웹샵 솔루션까지 유도하는 인앱 캠페인. 이 경우 DSP를 사용해야 하며, Adjust에서 추적 및 기여도 분석 작업을 처리합니다.

Adjust 측에서 광고 캠페인을 설정하려면 문서를 참조하십시오.

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

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

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

이벤트	설명
xsolla-billing-payment	아이템 구매. 이벤트 매개 변수에는 구매에 대한 정보가 포함되어 있습니다.
xsolla-billing-created	인보이스 생성. 이벤트 매개 변수에는 생성된 인보이스에 대한 정보가 포함되어 있습니다.
xsolla-billing-error	결제 오류. 이벤트 매개 변수에는 결제 처리 중 발생한 오류에 대한 정보가 포함되어 있습니다.

작동 방식

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

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Adjust
    User->>Mobile App: 1. Logs in
    Mobile App->>Adjust: 2. Sends CUID
    Adjust-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Adjust: 7. Sends xsolla-billing-payment event

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

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

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

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

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

창이 열리면 이 통합 활성화 상자가 체크 표시되는지 확인합니다.
다음 데이터를 입력합니다:
- Adjust S2S 보안 토큰.
- 플랫폼(Android/iOS) 게시용 앱 토큰. 플랫폼을 추가하려면 앱 토큰 추가를 클릭하십시오.
저장을 클릭합니다.
Adjust에서 통합을 활성화합니다.

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

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

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

Adjust에서 설정하는 방법

Adjust에서 다음을 수행해야 합니다:

CUID를 파트너 매개 변수로 전달하도록 구성.
S2S 보안 토큰으로 생성.
Adjust 분석 보고서를 위한 이벤트 생성.
엑솔라와 통합 활성화.

CUID를 파트너 매개 변수로 전달

지침에 따라 CUID 전송을 직접 구성합니다. 이렇게 하려면 addGlobalPartnerParameter 메서드를 호출하고 다음과 같은 데이터를 전달합니다:

사용자 ID
forKey: “xsolla_cuid”

예:

Copy

Full screen

Small screen

swift

1Adjust.addGlobalPartnerParameter("abcd123", forKey: "xsolla_cuid")

1[Adjust addGlobalPartnerParameter:@"abcd123" forKey:@"xsolla_cuid"];

S2S 보안 토큰 생성

Adjust 계정에서 다음 역할중 하나를 맡고 있어야 S2S 보안 토큰을 보고 관리할 수 있습니다:

관리자
편집자
사용자 지정 편집자

S2S 보안 토큰을 받는 방법:

Adjust 계정에 로그인합니다.
AppView > All apps 섹션을 열고 애플리케이션 페이지로 이동합니다.
Protection 탭으로 이동합니다.
S2S security 블록에서, Open S2S security를 클릭합니다.

Enable S2S authentication 토글을 켤 필요는 없지만, 토큰 자체는 활성 상태여야 합니다.

New token을 클릭하면 열리는 모달 창에서:

토큰 제목을 지정합니다.
Scope필드에서 Events를 선택합니다.
애플리케이션이 여러 플랫폼에 게시된 경우, Enable multi-app S2S token 확인란을 선택하고 이 S2S 토큰이 적용될 애플리케이션을 선택하십시오.
Add token을 클릭합니다.

생성된 토큰은 지정된 애플리케이션에 적용됩니다. 생성된 토큰은 S2S 토큰의 전체 목록에서 확인할 수 있습니다.

이벤트 생성

Adjust 계정에서 다음 역할 중 하나를 맡고 있어야 토큰을 보고 관리할 수 있습니다:

관리자
편집자
사용자 지정 편집자

Adjust 계정에 로그인합니다.
AppView > All apps 섹션을 열고 애플리케이션 페이지로 이동합니다.
Events 탭에서, Add event를 클릭합니다.

다음 이벤트를 하나씩 추가합니다:

구매에 관한 일반 정보를 수신하는 이벤트(예: xsolla-billing-payment).
인보이스 생성에 관한 정보를 수신하는 이벤트(예: xsolla-billing-created).
결제 오류에 관한 정보를 수신하는 이벤트(예: xsolla-billing-error).

이벤트 이름을 지정하고 필요에 맞게 규칙을 설정할 수 있습니다. 이벤트를 추가한 경우 Events 탭 목록에 표시됩니다.

엑솔라와 통합 활성화

Adjust 계정에 로그인합니다.
Campaign Lab > Partners 섹션으로 이동합니다.
New partner를 클릭합니다.

검색 창에 Xsolla를 입력하고 선택합니다.
Next를 클릭합니다.

통합을 구성할 애플리케이션을 선택합니다.
Next를 클릭합니다.
데이터 공유를 활성화합니다. 이렇게 하려면Enable data sharing 블록에서, Edit을 클릭하고 토글을 활성화로 설정한 다음, Enable을 클릭하십시오.

Set your data sharing options 확인란에서 Parameters 확인란을 선택합니다.
이벤트 매핑 구성:

Map your events 블록에서, Map event를 클릭합니다.
테이블에 따라 이벤트 매핑:

Adjust event 필드	Partner event 필드
구매 관련 일반 정보를 수신하기 위해 생성한 이벤트.	Xsolla billing payment
인보이스 생성에 관한 정보를 수신하기 위해 생성한 이벤트.	Xsolla billing created
결제 오류에 관한 정보를 수신하기 위해 생성한 이벤트.	Xsolla billing error

1. Apply를 클릭합니다.

모든 이벤트를 추가한 후, Next을 클릭합니다.

설정을 확인하고 Enable partner를 클릭합니다. 필요한 경우 이전 단계로 돌아가서 설정을 업데이트할 수 있습니다.

이벤트 값 구조

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

아이템 구매

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

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

인보이스 생성

웹샵 솔루션용 엑솔라 시스템에서 아이템 구매에 대한 인보이스 생성 시 엑솔라는 Adjust에 xsolla-billing-created이벤트를 전송합니다. 이벤트 매개 변수에는 생성된 인보이스에 대한 다음 정보가 포함됩니다:

매개 변수	설명
`content_id`	구매 시 단일 SKU 또는 여러 SKU.
`quantity`	해당 SKU를 가진 아이템의 수량(하나 또는 여러 개).
`item_value`	할인을 포함하여 구매한 아이템 비용입니다. 아이템 수준 분석에 사용되며 매출 계산에는 포함되지 않습니다(구매 이벤트에 대한 수익으로 계산되는 `revenue`과 다름).
`currency`	인게임 재화 구매.
`receipt_id`	인보이스 ID의 처음 10자릿수입니다.

결제 오류

웹샵 솔루션에서 구매 중 결제 오류가 발생하면 엑솔라는 Adjust에 xsolla-billing-error 이벤트를 전송합니다. 이벤트 매개 변수에는 다음과 같은 정보가 포함됩니다:

매개 변수	설명
`content_id`	구매 시 단일 SKU 또는 여러 SKU.
`quantity`	해당 SKU를 가진 아이템의 수량(하나 또는 여러 개).
`item_value`	할인을 포함하여 구매한 아이템 비용입니다. 아이템 수준 분석에 사용되며 매출 계산에는 포함되지 않습니다(구매 이벤트에 대한 수익으로 계산되는 `revenue`과 다름).
`currency`	인게임 재화 구매.
`receipt_id`	인보이스 ID의 처음 10자릿수입니다.

추가 데이터

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

매개 변수	설명
os_name	장치 운영 체제.
adid	Adjust 측의 장치 ID(모든 플랫폼).
idfa	앱 스토어의 광고주 ID.
idfv	Apple 측의 공급업체 ID.
gps_adid	Google Play의 광고주 ID.
app_token	Adjust 측의 앱 토큰.
{partner_parameters}	정보를 수신하려는 기타 사용자 지정 매개 변수.

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

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

마지막 업데이트: 2026년 3월 12일

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

콘텐츠

글로서리
연동 시나리오
작동 방식
Adjust에서 설정하는 방법
웹 애플리케이션 생성
이벤트 생성
엑솔라와 통합 활성화
관리자 페이지에서 설정하는 방법
웹샵 솔루션을 위한 웹 및 인앱 광고 캠페인 실행 방법
작동 방식
관리자 페이지에서 설정하는 방법
Adjust에서 설정하는 방법
CUID를 파트너 매개 변수로 전달
S2S 보안 토큰 생성
이벤트 생성
엑솔라와 통합 활성화
이벤트 값 구조
아이템 구매
인보이스 생성
결제 오류
추가 데이터