Google Play Install Referrer

আপনার গেমের জন্য সবচেয়ে মূল্যবান ব্যবহারকারী সংগ্রহের চ্যানেলগুলো শনাক্ত করে সুচিন্তিত বিপণন সিদ্ধান্ত নিন। আপনার অ্যাপের রেফারেল তথ্য নির্ভরযোগ্যভাবে ট্র্যাক করার জন্য গুগল প্লে ইনস্টল রেফারার এপিআই (Google Play Install Referrer API) ব্যবহার করুন।

রেফারেল ডেটা ট্র্যাক করার মাধ্যমে, আপনি বুঝতে পারবেন কোন ট্র্যাফিক সোর্সগুলো থেকে সবচেয়ে বেশি ব্যবহারকারী গুগল প্লে স্টোর থেকে আপনার অ্যাপ ডাউনলোড করে। এই অন্তর্দৃষ্টিগুলো আপনাকে আপনার বিজ্ঞাপনের খরচের সর্বোত্তম ব্যবহার করতে এবং ROI (বিনিয়োগের উপর রিটার্ন) সর্বাধিক করতে সাহায্য করতে পারে।

নেমস্পেস: PlayPcSdkManaged.InstallReferrer

ক্লায়েন্ট ক্লাস: InstallReferrerClient

আপনার স্টোর লিস্টিং পৃষ্ঠার লিঙ্ক

প্রথমে আপনার ব্যবহারকারীদেরকে আপনার অ্যাপ্লিকেশনের গুগল প্লে স্টোর পেজে লিঙ্ক করুন। URL-এ নিম্নলিখিত কোয়েরি প্যারামিটারগুলো অন্তর্ভুক্ত করুন:

  • id : আপনার গেমের প্লে প্যাকেজের নাম
  • referrer : রেফারেলের উৎস নির্দেশকারী একটি স্ট্রিং। আপনার অ্যাপ্লিকেশনটি ইনস্টল এবং চালু হয়ে গেলে এই স্ট্রিংটি কোয়েরি করা যাবে।
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

ক্লায়েন্ট তৈরি করুন

InstallReferrerClient তৈরি করতে সর্বদা ফ্যাক্টরি ব্যবহার করুন। এটি নিশ্চিত করে যে ইউনিটি-সেফ কলব্যাকগুলি স্বয়ংক্রিয়ভাবে নিবন্ধিত হয়।

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