결제 특성 설정

결제 특성은 어떤 콘텐츠 크리에이터의 링크가 구매를 한 사용자를 연결했는지 파악하는 데 도움이 됩니다. 해당 사용자가 체결한 모든 구매는 크리에이터와 연결되므로 캠페인 결과에 따라 정확한 대금을 지급받을 수 있습니다.

작동 방식

특성을 활성화하려면 tracking_id 매개 변수를 사용하십시오.

tracking_id는 사용자의 결제를 트래픽 소스(예: 광고 캠페인)에 연결하는 고유 식별자입니다. 이는 다음과 같은 목적으로 사용됩니다:

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

tracking_id는 사용자가 콘텐츠 크리에이터의 개인 링크를 클릭할 때 엑솔라에 의해 생성됩니다. 사용자가 이 링크를 따라가면 엑솔라는 고유한 32자 식별자인 tracking_id 매개 변수를 URL에 자동으로 추가합니다. 해당 링크는 캠페인에 따라 웹샵 솔루션의 메인 페이지, 특정 아이템 또는 프로모션으로 연결될 수 있습니다. 결제 토큰을 생성하려면 요청에 tracking_id를 전달해야 합니다. 거래가 완료되면 tracking_id가 결제 데이터와 함께 저장되며 속성, 분석 및 재무 보고에 사용됩니다.

예시: https://webshop-external-demo.xsolla.site/?tracking_id=abcdefghijklmnopqrstuvwxyz123456

tracking_id가 전달되지 않으면 결제가 트래픽 소스에 귀속되지 않으며 성과 보고서에 표시되지 않으며, 크리에이터 측의 결제에 포함되지 않습니다.

결제 토큰 생성 시 tracking_id를 전달하는 방법:

tracking_id 가져오기

클라이언트 측에서 tracking_id 매개 변수를 가져오는 것은 통합 유형에 따라 달라집니다. tracking_id를 추출하기 위한 자체 로직을 구현하거나 엑솔라에서 제공하는 파트너 네트워크 추적 스크립트를 사용하십시오.

스크립트가 URL을 수정하는 다른 자바스크립트보다 먼저 실행되는지 확인합니다. 그렇지 않을 경우, tracking_id가 분실될 수 있습니다.

파트너 네트워크 추적 스크립트를 사용하는 것이 좋습니다. 이 스트립트는 tracking_id를 localStorage에 자동으로 저장하고 getTrackingId() 메서드에 대한 액세스를 제공합니다.

자세한 구현 예시는 아래 탭에서 확인할 수 있습니다.

아래 스니펫은 URL에서 tracking_id를 추출하여 localStorage에 저장합니다. 파트너 네트워크 추적 스크립트를 사용할 계획이 아니라면 이 코드를 사용하십시오.

tracking_id 처리 스니펫:

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})();

이 스트립트는 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>

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

예시:

Copy

Full screen

Small screen

1const trackingId = XsollaPartnerNetworkSDK.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}

access_data를 통한 tracking_id는 더 이상 사용되지 않습니다. 페이 스테이션 임베드와 유사한 access_token을 사용하는 것이 좋습니다.

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_token 대신 access_data를 사용할 수 없습니다. 통합 작업에서 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를 가져옵니다(예: deeplink를 통해 가져옴).
이를 Xsolla.Core.PurchaseParams개체(Unity용 SDK)에 전달합니다.

예시:

Copy

Full screen

Small screen

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

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

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

마지막 업데이트: 2025년 9월 23일

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

콘텐츠

작동 방식
tracking_id 가져오기
결제 토큰 생성 시 tracking_id 전달
클라이언트 측 결제 토큰
서버 측 결제 토큰

Your browser is not supported. Please try a different browser

결제 특성 설정

작동 방식

tracking_id 가져오기

결제 토큰 생성 시 tracking_id 전달

클라이언트 측 결제 토큰

서버 측 결제 토큰