Google Play Install Referrer

अपने गेम के लिए, उपयोगकर्ता हासिल करने वाले सबसे अहम चैनलों की पहचान करके, मार्केटिंग के बेहतर फ़ैसले लें. अपने ऐप्लिकेशन के रेफ़रल की जानकारी को भरोसेमंद तरीके से ट्रैक करने के लिए, Google Play Install Referrer API का इस्तेमाल करें.

रेफ़रल डेटा को ट्रैक करके, यह समझा जा सकता है कि Google Play Store से आपका ऐप्लिकेशन डाउनलोड करने के लिए, सबसे ज़्यादा उपयोगकर्ताओं को कौनसे ट्रैफ़िक सोर्स भेजते हैं. इन अहम जानकारी से, आपको विज्ञापन पर होने वाले खर्च का ज़्यादा से ज़्यादा फ़ायदा पाने और आरओआई को बढ़ाने में मदद मिल सकती है.

नेमस्पेस: PlayPcSdkManaged.InstallReferrer

क्लाइंट क्लास: InstallReferrerClient

अपने स्टोर पेज का लिंक

अपने उपयोगकर्ताओं को अपने ऐप्लिकेशन के Google Play स्टोर पेज से लिंक करें. यूआरएल में, इनके लिए क्वेरी पैरामीटर शामिल करें:

  • id: आपके गेम के Play पैकेज का नाम
  • referrer: रेफ़रल सोर्स को दिखाने वाली स्ट्रिंग. इस स्ट्रिंग को तब क्वेरी किया जा सकता है, जब आपका ऐप्लिकेशन इंस्टॉल हो जाए और चल रहा हो.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

क्लाइंट बनाना

InstallReferrerClient बनाने के लिए, हमेशा फ़ैक्ट्री का इस्तेमाल करें. इससे यह पक्का होता है कि Unity-safe कॉलबैक अपने-आप रजिस्टर हो जाते हैं.

using UnityEngine;
using System;
using System.Threading.Tasks;
// Required SDK Namespaces
using PlayPcSdkManaged.InstallReferrer;
using PlayPcSdkManaged.Unity;

public class InstallReferrerManager : MonoBehaviour
{
    private InstallReferrerClient _installReferrerClient;

    public void SetupInstallReferrer()
    {
        try
        {
            // Creates the client with the required UnityInstallReferrerCallbacksHandler
            _installReferrerClient = PlayPcSdkFactory.CreateInstallReferrerClient();
            Debug.Log("Install Referrer Client created successfully.");
        }
        catch (Exception ex)
        {
            Debug.LogError($"Failed to create Install Referrer Client: {ex.Message}");
        }
    }

    private void OnDestroy()
    {
        // Always dispose of the client to clean up native C++ resources
        _installReferrerClient?.Dispose();
    }
}

इंस्टॉल रेफ़रर के बारे में क्वेरी करना

जब कोई व्यक्ति गेम इंस्टॉल करके उसे लॉन्च करता है, तब आपका ऐप्लिकेशन Install Referrer API का इस्तेमाल करके, उस ट्रैफ़िक सोर्स का पता लगा सकता है जिसकी वजह से गेम इंस्टॉल किया गया.

GetInstallReferrerAsync का इस्तेमाल करके, रेफ़रर की जानकारी के लिए क्वेरी करें. जवाब में वही स्ट्रिंग शामिल होती है जिसे आपने स्टोर पेज की जानकारी वाले पेज के referrer क्वेरी पैरामीटर में पास किया था.

public async Task GetInstallReferrerAsync()
{
    try
    {
        Debug.Log("Querying Install Referrer...");

        // Async call to retrieve referral information
        var result = await _installReferrerClient.GetInstallReferrerAsync();

        if (result.IsOk)
        {
            // On success, access the InstallReferrer and InstallTimeEpochSeconds
            var referrer = result.Value.InstallReferrer;
            var installTime = result.Value.InstallTimeEpochSeconds;

            Debug.Log($"Install Referrer: {referrer}");
            Debug.Log($"Install Time: {installTime}");

            // Attribute your game's installation to an acquisition channel
        }
        else
        {
            // Handle expected API errors (e.g., Error)
            Debug.LogError($"Query Failed: {result.Code} - {result.ErrorMessage}");
        }
    }
    catch (Exception ex)
    {
        Debug.LogException(ex);
    }
}