결제 특성 설정

결제 특성으로 어떤 콘텐츠 크리에이터가 구매를 유도했는지를 식별할 수 있습니다. 해당 사용자가 구매한 모든 항목이 콘텐츠의 크리에이터에게 귀속되어 캠페인 지불금을 올바르게 받을 수 있도록 돕습니다.

크리에이터 스토어프론트 또는 엑솔라 웹사이트 빌더로 생성한 페이지를 통해 구매가 이루어지는 경우, 추가적인 결제 특성 설정이 필요하지 않으며 자동으로 처리됩니다. 맞춤형 스토어프론트를 사용하는 경우 아래 지침을 따르세요.

작동 방식

특성을 활성화하려면 tracking_id 매개 변수를 사용합니다.

tracking_id는 다음에 사용되는 고유 식별자입니다.

캠페인 성과 추적
사용자를 추천한 크리에이터 식별
파트너 네트워크에서 분석 정보 수집
리워드 및 지불금의 정확한 계산

사용자가 콘텐츠 크리에이터의 개인 링크를 클릭하면, 엑솔라는 길이가 32자인 고유한 tracking_id를 생성하고 이를 목적지 페이지의 URL에 추가합니다. 목적지는 제품 판매와 관련된 랜딩 페이지일 수 있습니다. 생성된 tracking_id를 요청에서 전달하여 결제 토큰을 생성합니다. 거래가 완료되면, tracking_id는 결제 데이터와 함께 저장되어 특성, 분석 및 재무 계산에 사용됩니다.

tracking_id 매개 변수가 포함된 링크 예시: https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

tracking_id가 없으면 결제를 트래픽 소스에 귀속시킬 수 없습니다. 이러한 결제는 성과 보고서에 포함되지 않으며, 크리에이터의 지불금을 계산할 때 고려되지 않습니다.

결제 토큰을 생성할 때 tracking_id를 전달하려면:

tracking_id 가져오기

클라이언트 측에서 tracking_id를 가져오는 방법은 연동 유형에 따라 다릅니다. tracking_id를 추출하는 자체 로직을 구현하거나 엑솔라에서 제공하는 파트너 네트워크 스크립트를 사용할 수 있습니다. 결제 특성은 스토어프론트, 개별 아이템 또는 게임 키 페이지, 멀티 게임 카탈로그를 포함하는 판매 페이지 유형에 관계없이 동일하게 작동합니다.

스크립트가 URL을 수정하는 다른 JavaScript보다 먼저 실행되도록 합니다. 그렇지 않으면 tracking_id를 잃게될 수도 있습니다.

이 스크립트는 URL의 쿼리 매개변수에서 tracking_id를 자동으로 추출하여 localStorage에 저장합니다. 저장된 값을 가져오기 위해 결제 토큰을 생성할 때 호출되는 getTrackingId() 메서드가 제공됩니다.

아래 탭에서 자세한 구현 예시를 확인해 보세요.

이 스크립트는 URL의 쿼리 매개 변수에서 tracking_id를 자동으로 추출하여 localStorage에 저장하고, 결제 토큰을 생성할 때 사용하는 getTrackingId() 메서드를 제공합니다.

다음 스크립트를 랜딩 페이지의 HTML에 추가합니다.

Copy

Full screen

Small screen

1<script src="https://cdn.xsolla.net/xpn-bucket-prod/xpn-script/xpn@latest/xpn.min.js"></script>

이 스크립트는 결제 토큰이 생성될 수 있는 모든 페이지에 로드되어야 합니다.

아래 스니펫은 URL에서 tracking_id를 추출하여 localStorage에 저장합니다.

tracking_id 처리 JavaScript 스니펫:

Copy

Full screen

Small screen

 1(function () {
 2  const XPN_TRACKING_ID = 'xsolla_partner_network_tracking_id';
 3  const TRACKING_ID = 'tracking_id';
 4
 5  function removeTrackingIdFromUrl() {
 6    if (window.history && window.history.replaceState) {
 7      const url = new URL(window.location.href);
 8      url.searchParams.delete(TRACKING_ID);
 9      window.history.replaceState(null, '', url.toString());
10    }
11  }
12
13  function extractTrackingIdFromURL() {
14    try {
15      const savedTrackingId = localStorage.getItem(XPN_TRACKING_ID);
16      const searchParams = new URLSearchParams(window.location.search);
17      const trackingId = searchParams.get(TRACKING_ID) || savedTrackingId || '';
18      if (trackingId !== '') {
19        localStorage.setItem(XPN_TRACKING_ID, trackingId);
20      }
21      removeTrackingIdFromUrl();
22    } catch (e) {
23      console.error('[Xsolla Partner Network] Failed to extract tracking_id:', e);
24    }
25  }
26
27  function getTrackingId() {
28    return localStorage.getItem(XPN_TRACKING_ID) || null;
29  }
30
31  extractTrackingIdFromURL();
32  window.XsollaPartnerNetwork = window.XsollaPartnerNetwork || {};
33  window.XsollaPartnerNetwork.getTrackingId = getTrackingId;
34})();

JavaScript 스니펫을 사용하든, 파트너 네트워크 스크립트를 사용하든, 연동하는 방식에 관계 없이 저장된 tracking_id를 검색하려면 XsollaPartnerNetwork.getTrackingId()를 호출합니다.

Copy

Full screen

Small screen

1const trackingId = XsollaPartnerNetwork.getTrackingId();
2if (trackingId) {
3  console.log('Saved tracking_id from URL:', trackingId);
4  // add tracking_id into your request parameters
5}

결제 토큰 생성 시 tracking_id 전달

연동 설정 방법에 따라, 아래 옵션 중 하나를 사용하여 tracking_id를 토큰 생성 메서드에 전달합니다.

특성의 정확성ㅇ르 보장하려면 tracking_id가 토큰 요청에 포함되어 있는지 확인합니다.

tracking_id를 구매 위젯에 전달하려면:

클라이언트 측에서 tracking_id를 가져옵니다(URL 또는 localStorage에서).
위젯 초기화 시 access_data.user.tracking_id.value 매개 변수에 추가합니다.

Copy

Full screen

Small screen

1{
2 access_data: {
3  user: {
4    tracking_id: {
5      value: "abcdefghijklmnopqrstuvwxyz123456"
6    }
7  }
8}
9}

tracking_id는 위젯 초기화 매개 변수로 전달할 수 없습니다. 대신, 토큰의 매개 변수 user.tracking_id.value에 포함되어야 합니다.

페이 스테이션 임베드에 tracking_id를 전달하려면:

클라이언트 측에서 tracking_id를 가져옵니다(URL 또는 localStorage에서).
결제 토큰 생성 시 이 매개 변수를 전달합니다.

Copy

Full screen

Small screen

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

access_token을 사용하여 위젯을 초기화합니다.

Copy

Full screen

Small screen

1XPayStationWidget.init({
2  access_token: 'your_token_with_tracking_id'
3});

access_data 대신 access_token을 사용하는 것은 더 이상 권장되지 않습니다. 연동에서 access_token을 지원하지 않는 경우, 구매 위젯에 표시된 것처럼 access_data.user.tracking_id.value 매개 변수에서 tracking_id를 전달합니다.

헤드리스 체크아웃으로 tracking_id를 전달하려면:

클라이언트 측에서 tracking_id를 가져옵니다(URL 또는 localStorage에서).
결제 토큰 생성 시 user.tracking_id.value 매개 변수에 추가합니다.
headlessCheckout.init() 메서드를 사용하여 SDK를 초기화합니다.
토큰을 사용하여 전달합니다.

Copy

Full screen

Small screen

1await headlessCheckout.setToken('your_token_with_tracking_id');

클라이언트 측 결제 토큰

다음 API 호출 중 하나로 결제 토큰을 생성하는 경우 이 옵션을 사용합니다.

결제 토큰을 생성할 때 tracking_id를 전달하려면:

클라이언트 측에서 tracking_id를 가져옵니다(URL 또는 localStorage에서).
user.tracking_id.value 매개 변수에 추가합니다.

예시:

Copy

Full screen

Small screen

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

이 옵션은 클라이언트 측에서만 사용 가능합니다. 국가와 통화는 사용자의 IP 주소에 의해 결정됩니다.

서버 측 결제 토큰

구매용 결제 토큰 생성 API 호출을 통해 결제 토큰을 생성하는 경우 이 옵션을 사용하세요.

결제 토큰을 생성할 때 tracking_id를 전달하려면:

클라이언트 측에서 tracking_id를 가져옵니다(URL 또는 localStorage에서).
user.tracking_id.value 매개 변수에 추가합니다.

예시:

Copy

Full screen

Small screen

1{
2  "user": {
3    "tracking_id": {
4      "value": "abcdefghijklmnopqrstuvwxyz123456"
5    }
6  }
7}

Unity용 엑솔라 SDK(레거시/엔터프라이즈)를 사용하여 tracking_id를 전달하려면:

tracking_id를 지원하는 최신 SDK 버전을 사용하고 있는지 확인합니다.
클라이언트 측에서 tracking_id를 가져옵니다(예: 딥링크 사용).
Xsolla.Core.PurchaseParams 개체에 전달합니다.

예시:

Copy

Full screen

Small screen

1var purchaseParams = new PurchaseParams {
2  tracking_id = "abcdefghijklmnopqrstuvwxyz123456"
3};

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

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

마지막 업데이트: 2026년 7월 17일

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

콘텐츠

작동 방식
tracking_id 가져오기
결제 토큰 생성 시 tracking_id 전달