Xsolla 모듈 설정 가이드

Xsolla은(는) Adjust와 연동된 애널리틱스 파트너입니다. Adjust 연동을 통해 Xsolla은(는) 자동화 콜백으로 Adjust에서 측정된 데이터를 수신합니다. 이러한 데이터를 파트너의 툴과 함께 분석 및 인사이트에 활용할 수 있습니다.

이 페이지에서는 Xsolla와(과)의 설정 방법을 확인하실 수 있습니다. Xsolla 활성화와 Adjust가 공유할 수 있는 데이터 선택 방법을 아래에서 확인하시기 바랍니다.

시작에 앞서

요구 사항

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

Campaign Lab에서 Xsolla 및 앱 선택

  1. Campaign Labs 에서 파트너 를 선택합니다.
  2. 새 파트너 > Xsolla 을 선택합니다. 다음 을 선택하여 다음 화면으로 이동합니다.
  3. 앱 선택 화면에서 링크를 생성하고자 하는 앱을 선택하고, Xsolla를(을) 활성화하여 파트너와 데이터를 공유합니다.
  4. 다음 을 선택합니다.

데이터 공유 활성화

Xsolla와(과)의 연동을 활성화하려면 다음의 단계를 수행하시기 바랍니다.

  1. 활성화 켜기

Xsolla와(과)의 데이터 공유가 활성화되면, Adjust는 기본 설정에 따라 다음의 데이터를 자동으로 Xsolla에 전송합니다.

데이터 공유 옵션 설정

멀티 플랫폼에 대해 데이터 공유가 활성화된 멀티 플랫폼 앱인 경우, 다음이 가능합니다:

  1. 플랫폼별 설정 사용 을 선택하여 플랫폼 레벨에서 데이터 공유 옵션을 구분.
  2. 글로벌 설정 사용 을 선택하여 여러 플랫폼에 대해 동일한 데이터 공유 설정을 적용.

기본 설정으로 공유되는 데이터 에서 Adjust가 Xsolla과 디폴트로 공유하는 활동을 확인하시기 바랍니다:

추가 데이터 전송

콜백을 통해 Xsolla과(와) 공유하고자 하는 데이터의 양과 유형을 선택합니다. Xsolla은(는) 퍼포먼스 최적화를 위해 이 정보를 사용할 수 있습니다.

추가 데이터 전송을 위해 다음 항목을 검토하고 설정할 수 있습니다.

파라미터 매핑

Xsolla에 커스텀 데이터를 공유하려면 일반적으로 파라미터 매핑이 필요합니다.

파트너 파라미터(Adjust SDK 버전 4.0+에서 이용 가능)를 통해 Adjust는 앱에서 커스텀 데이터를 수집하여 Xsolla에 전송할 수 있습니다. 이를 통해 Xsolla은(는) 연결된 개별 이벤트에 대한 커스텀 이벤트 상세 정보를 수신할 수 있습니다.

Adjust SDK에 새로운 파트너 파라미터를 추가하기 전, 요구 사항을 충족하는 파트너 파라미터가 이미 존재하는지 확인하시기 바랍니다.

파트너 파라미터를 Xsolla에 공유하려면 다음의 단계를 수행하시기 바랍니다.

  1. Adjust SDK 내에서 파트너 파라미터를 설정합니다.

  2. 데이터 공유 옵션 설정 에서 파라미터 를 선택합니다.

  3. 파라미터 매핑 에서는 SDK에서 정의된 파트너 파라미터를 네트워크에 어떠한 방식으로 보낼지 지정할 수 있습니다.

    1. 파라미터 매핑 을 선택합니다.
    2. SDK 파라미터 필드에 네트워크와 공유하고자 하는 SDK 파라미터 이름을 입력합니다.
    3. 네트워크 파라미터 영역에 SDK 파라미터에 상응하는 네트워크 파라미터를 입력합니다.
참고:

대시보드에서 파라미터 공유를 설정하지 않고 Adjust SDK 내에서 파트너 파라미터를 설정한 경우, Adjust는 Adjust SDK에 설정된 파라미터명을 그대로 전송합니다.

앱에 대해 Xsolla 활성화

설정 검토 화면에서는 선택 사항을 검토할 수 있습니다. 이전 페이지로 돌아가서 다음을 변경할 수도 있습니다.

  • 선택한 앱
  • 데이터 공유 옵션

파트너 활성화 를 선택하여 앱에 대해 Xsolla을 활성화합니다. 애널리틱스 파트너는 캠페인 링크를 사용할 수 없습니다. 활성화가 완료되면 어트리뷰션과 인앱 이벤트 데이터가 자동으로 전송됩니다.

파트너별 설정 가이드

Important: To ensure the data is sent correctly to Xsolla, please make sure the Parameters checkbox is selected.

xsolla_cuid

Xsolla requires that the cuid be configured as a partner parameter in your Adjust SDK or S2S event implementations. Adjust will include this parameter in the callbacks sent to Xsolla. Xsolla then uses the provided cuid to correctly associate purchases with the specific device.

Please note: payloads lacking the cuid parameter will not be processed by Xsolla, as it would prevent proper purchase-to-device mapping.

For further details on this and any other setup requirements, you can refer to Xsolla documentation.

Sending the cuid to Xsolla

The cuid should be set on the login event, signup or another low-frequency event. It must be sent to Adjust as a partner parameter . Adjust will include this parameter in the callbacks it forwards to Xsolla. On Xsolla’s side, the parameter is then used to associate purchases with the specific device.

You can send the cuid parameter in both SDK events and S2S events .

1. Sending cuid via SDK events

To send the cuid as a partner parameter in SDK events, you can use the relevant SDK method for adding partner parameters. Define the key as xsolla_cuid and assign it the value of the cuid.

For details on how to add partner parameters in SDK events, you can refer to the guides linked below:

iOS | Android | Windows | Unity | React Native | Flutter | Adobe Air | Cordova | Marmalade | Xamarin | Cocos2d-x | Titanium | Corona

2. Sending cuid via S2S Events

When sending S2S events, the cuid can be included as a partner parameter within the partner_params parameter. You can use the xsolla_cuid as the key and assign the cuid value accordingly.

For detailed instructions on sending partner parameters via S2S events, you can refer to the relevant section of S2S events documentation .

Xsolla requires you to setup the cuid as custom partner parameters in your Adjust SDK implementation. You can learn more about partner parameters here and here . Note, all payloads without the cuid parameter will not be processed by Xsolla since they'll be unable to attribute those users to the right profile. For more information about this and any other setup requirements, check out the Xsolla documentation