Xsolla kurulumu

Xsolla, Adjust ile entegre bir analitik partneridir. Entegrasyonumuz ile Xsolla, Adjust tarafından ölçümlenen verileri otomatik callback'ler ile alabilir. Ardından bu verileri içgörü edinmek ve analitik amacıyla partnerin araçları ile kullanabilirsiniz.

Bu makalede, Xsolla ölçümlemesini uygulamanız için nasıl yapılandırabileceğinizi bulabilirsiniz. Buna entegrasyonu etkinleştirmek ve Adjust'ın Xsolla ile paylaşabileceği verileri seçmek de dahildir.

Başlamadan önce

Gereklilikler

• Adjust'ta Admin, Editör ya da Özel Editör izinlerine sahip olmak.
• SDK parametrelerini Xsolla parametreleri ile eşleştirmek için Adjust SDK v4.0.0 ve üstü. Bu özelliği kullanmak için aşağıdaki rehberleri takip edebilirsiniz.

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

Campaign Lab'de Xsolla seçeneğini seçin ve uygulamanızı seçin

1. Campaign Lab kısmında Partnerler seçeneğini seçin.
2. Yeni partner > Xsolla seçeneğini seçin. İleri 'yi seçerek sonraki ekrana geçin.
3. Uygulama seçimi ekranında link'ini oluşturmak istediğiniz uygulamayı seçin ve Xsolla ile veri paylaşımı için entegrasyonu etkinleştirin.
4. İleri 'yi seçin.

Veri paylaşımını etkinleştirin

Xsolla entegrasyonu için veri paylaşımını etkinleştirin. Veri paylaşımını etkinleştirmek için:

1. Etkin seçeneğini açık konuma getirin.

Xsolla ile veri paylaşımını etkinleştirdiğinizde Adjust, varsayılan olarak aşağıdaki verileri Xsolla partnerine otomatik olarak gönderecektir:

Veri paylaşımı seçeneklerinizi belirleyin

Veri paylaşımı birden fazla platformda etkin olan bir multi-platform uygulama ile çalışıyorsanız aşağıdakileri yapabilirsiniz:

1. Platforma özgü ayarları kullan seçeneğini seçerek veri paylaşımı seçeneklerini platform seviyesinde ayırabilirsiniz.
2. Birden fazla platformda aynı veri paylaşımı seçeneklerini kullanmak için Global ayarları kullan seçeneğini seçin.

Varsayılan olarak neler paylaşılır? kısmında Adjust'ın varsayılan olarak Xsolla ile paylaştığı aktiviteleri kontrol edebilirsiniz:

Ek veriler göndermek

Xsolla ile callback'ler aracılığıyla paylaşmak istediğiniz veri miktarını ve türünü seçin. Xsolla, bu bilgileri performansı optimize etmek için kullanabilir.

Ek veriler göndermek için bu seçenekleri gözden geçirebilir ve özelleştirebilirsiniz:

Parametre eşleştirmesi

Özel verileri Xsolla ile paylaşmak için genellikle parametreleri eşleştirmeniz gerekir.

Partner parametreleri (Adjust SDK sürüm 4.0 ve üstü), Adjust'ın özelleştirilmiş veri noktalarını uygulamanızdan alıp Xsolla'e göndermesini sağlar. Bu, Xsolla partnerinin bağlı event'lerinizin her biri için özel event detaylarını almasını sağlar.

Yeni partner parametrelerini Adjust SDK'ya eklemeden önce gereksinimlerinizi karşılayan mevcut partner parametrelerinin olmadığını kontrol edin.

Partner parametrelerini Xsolla ile paylaşmak için bu adımları takip edin.

1. Adjust SDK içindeki partner parametrelerini ayarlayın.

   • Tüm SDK geliştirme platform linkleri için Başlamadan önce'yi inceleyin.

2. Veri paylaşımı seçeneklerinizi belirleyin altından Parametreler seçimini yapın.

3. Parametre eşleştirmesi 'nin altında, SDK'da tanımlanan partner parametrelerini ağa nasıl göndermek istediğinizi belirleyebilirsiniz:

   1. Parametre eşleştirmesi 'ni seçin.
   2. SDK parametresi alanına ağ ile paylaşmak istediğiniz SDK parametresinin adını girin.
   3. Partner parametresi alanına SDK parametresine karşılık gelen ağ parametresini girin.

Uygulamanız için Xsolla partnerini etkinleştirin

Yaptığınız seçimleri Yapılandırma kontrolü ekranında kontrol edin. Bu noktada geri dönebilir ve aşağıdakilerde değişiklik yapabilirsiniz:

• Seçtiğiniz uygulama
• Veri paylaşımı seçenekleri

Partneri etkinleştir 'i seçerek Xsolla partnerini uygulamanız için etkinleştirin. Analitik partnerleri, kampanya linkleri ile çalışmazlar. Entegrasyonumuz etkinleştirildiğinde attribution ve uygulama-içi event verileri otomatik callback'ler ile gönderilir.

Partnerlere özgü yapılandırma yönergeleri

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