Google Play Install Referrer

Prenez des décisions marketing éclairées en identifiant les canaux d'acquisition d'utilisateurs les plus intéressants pour votre jeu. Utilisez l'API Google Play Install Referrer pour suivre de manière fiable les informations de provenance de vos applications.

En suivant les données de provenance, vous pouvez identifier les sources de trafic qui envoient le plus d'utilisateurs pour télécharger votre application depuis le Google Play Store. Ces insights peuvent vous aider à tirer le meilleur parti de vos dépenses publicitaires et à maximiser votre ROI.

Espace de noms : PlayPcSdkManaged.InstallReferrer

Classe client : InstallReferrerClient

Lien vers la fiche Play Store

Commencez par rediriger vos utilisateurs vers la page Google Play Store de votre application. Dans l'URL, incluez des paramètres de requête pour :

  • id : nom du package Play de votre jeu
  • referrer : chaîne représentant la source de provenance. Cette chaîne peut être interrogée une fois votre application installée et en cours d'exécution.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Créer le client

Utilisez toujours la fabrique pour créer un InstallReferrerClient. Cela garantit que les rappels sécurisés Unity sont automatiquement enregistrés.

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

Interroger les informations de provenance de l'installation

Une fois que l'utilisateur a installé et lancé le jeu, votre application peut déterminer la source de trafic qui a conduit à l'installation à l'aide de l'API Install Referrer.

Interrogez les détails de provenance à l'aide de GetInstallReferrerAsync. La réponse contient la même chaîne que celle transmise au paramètre de requête referrer de la fiche Play Store.

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