Xsollaの設定

XsollaはAdjustと連携しているアナリティクスパートナーです。Adjustとの連携により、 Xsollaは自動コールバックを通じてデータを受信します。このデータをパートナーのツールで使用して、分析データとインサイトを得ることができます。

ここでは、Xsollaとアプリ計測を設定する方法を説明します。 連携を有効化し、AdjustがXsollaと共有できるデータを選択する方法をご確認ください。

事前準備

要件​

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

Campaign LabでXsollaとアプリを選択

  1. Campaign Lab​にて、 パートナー（Partner）​ を選択します。
  2. 新規パートナー（New partner） > Xsolla​ を選択します。 次へ（Next）​ を選択して、次の画面に移動します。
  3. アプリの選択（App selection）​ 画面で、リンクを作成したいアプリを選択し、 Xsollaのデータ共有をするため連携を有効化します。
  4. 次（NEXT）​ を選択します。

データ共有を有効化

データ共有を有効化すると、Xsollaとの連携が有効化されます。データ共有を有効化する方法は以下のとおりです：

  1. 有効化（Enabled）トグルをONにします。

Xsollaとのデータ共有を有効化すると、デフォルトでは、Xsollaに以下のデータが自動送信されます：

データ共有オプションの設定

マルチプラットフォームアプリで複数のプラットフォームを対象にデータ共有を有効にしている場合は、以下のことが可能です：

  1. プラットフォーム固有の設定を使用（Use platform-specific settings）​ を選択すると、プラットフォームレベルでデータ共有オプションを個別に設定できます。
  2. グローバル設定を使用（Use global settings）​ を選択して、複数のプラットフォームに同じデータ共有設定を行います。

デフォルトで共有するデータ（What will be shared by default?）​ にて、Adjustがデフォルトで Xsollaと共有するアクティビティを確認してください。

追加データの送信

コールバックによりXsollaと共有するデータ量とタイプを選択します。 Xsollaはこの情報を使用して、パフォーマンスを最適化することができます。

追加データを送信するには、以下を確認またはカスタマイズしてください：

パラメーターのマッピング

通常、カスタムデータをXsollaと共有するには、パラメーターをマッピングする必要があります。

パートナーパラメーター（Adjust SDKバージョン4.0以降で使用可能）によって、Adjustはアプリからカスタムデータポイントを収集し、Xsollaに送信することができます。 これにより、Xsollaは連携しているイベントごとにカスタムイベントの詳細を受信するようになります。

Adjust SDKに新しいパートナーパラメーターを追加する前に、要件に合うパートナーパラメーターが存在していないことを確認してください。

パートナーパラメーターをXsollaに共有するには、以下の手順に従って設定してください。

  1. AdjustのSDKでパートナーパラメーターを実装します。

    • 全てのSDK開発プラットフォームのリンクについては、事前準備をご確認ください

  2. データ共有オプションの設定（Set your data sharing option）​ で、 パラメーター​を選択します。

  3. パラメーターのマッピング（Map parameters）​では、SDKで定義したパートナーパラメーターをネットワークに送信する方法を指定できます。

    1. パラメーターのマッピング（Map parameters）​を選択します。
    2. SDKパラメーター（SDK parameter）​フィールドで、ネットワークと共有するSDKパラメーターの名前を入力します。
    3. パートナーパラメーター（Partner parameter）​フィールドで、SDKパラメーターに対応するネットワークパラメーターを入力します。
注意:

Adjust SDK内でパートナーパラメーターを設定し、ダッシュボードでパラメーター共有を設定しない場合、AdjustはAdjust SDKで指定されているパラメーターを転送します。

アプリでXsollaを有効化

設定のレビュー（Setup review）​ 画面では 、選択した内容を確認できます。前に戻って、以下の変更も行えます：

  • 選択したアプリ
  • データ共有オプション

パートナーを有効化（Enable partner）​ を選択して、アプリで 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