Google Play Install Referrer

כדי לקבל החלטות שיווקיות מושכלות, כדאי לזהות את הערוצים הכי רווחיים להשגת משתמשים במשחק שלכם. כדי לעקוב בצורה מהימנה אחרי פרטי ההפניה של האפליקציות, אפשר להשתמש ב-Google Play Install Referrer API.

מעקב אחרי נתוני הפניות מאפשר לכם להבין אילו מקורות תנועה שולחים הכי הרבה משתמשים להורדת האפליקציה שלכם מחנות Google Play. התובנות האלה יכולות לעזור לכם להפיק את המקסימום מהוצאות הפרסום ולהגדיל את החזר ה-ROI.

מרחב שמות: PlayPcSdkManaged.InstallReferrer

סיווג הלקוח: InstallReferrerClient

קישור לדף האפליקציה בחנות

כדי להתחיל, מקשרים את המשתמשים לדף האפליקציה בחנות Google Play. בכתובת ה-URL, כוללים פרמטרים של שאילתה לגבי:

  • id: שם חבילת Play של המשחק
  • referrer: מחרוזת שמייצגת את מקור ההפניה. אפשר לשלוח שאילתה למחרוזת הזו אחרי שהאפליקציה מותקנת ופועלת.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

יצירת הלקוח

תמיד משתמשים ב-factory כדי ליצור InstallReferrerClient. כך מובטח שהתקשרות חוזרת בטוחה ב-Unity תירשם באופן אוטומטי.

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