Google Play Install Referrer

Đưa ra quyết định sáng suốt về hoạt động tiếp thị bằng cách xác định các kênh thu nạp người dùng có giá trị nhất cho trò chơi của bạn. Sử dụng Google Play Install Referrer API để theo dõi thông tin liên kết giới thiệu của ứng dụng một cách đáng tin cậy.

Bằng cách theo dõi dữ liệu liên kết giới thiệu, bạn có thể biết nguồn lưu lượng truy cập nào gửi nhiều người dùng nhất đến tải ứng dụng của bạn xuống từ Cửa hàng Google Play. Những thông tin chi tiết này có thể giúp bạn tận dụng tối đa mức chi tiêu quảng cáo và tối ưu hoá lợi tức đầu tư (ROI).

Không gian tên: PlayPcSdkManaged.InstallReferrer

Lớp ứng dụng: InstallReferrerClient

Liên kết đến trang thông tin trên Cửa hàng Play

Bắt đầu bằng cách liên kết người dùng đến trang ứng dụng của bạn trên Cửa hàng Google Play. Trong URL, hãy thêm các tham số truy vấn cho:

  • id: Tên gói Play của trò chơi
  • referrer: Chuỗi đại diện cho nguồn giới thiệu. Bạn có thể truy vấn chuỗi này sau khi ứng dụng được cài đặt và chạy.
https://play.google.com/store/apps/details?id=com.example.package&referrer=example_referrer_source

Tạo ứng dụng

Luôn sử dụng nhà máy để tạo InstallReferrerClient. Điều này đảm bảo rằng các lệnh gọi lại an toàn cho Unity sẽ được tự động đăng ký.

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

Truy vấn liên kết giới thiệu cài đặt

Sau khi người dùng cài đặt và khởi chạy trò chơi, ứng dụng của bạn có thể xác định nguồn lưu lượng truy cập dẫn đến việc cài đặt bằng Install Referrer API.

Truy vấn thông tin chi tiết về liên kết giới thiệu bằng GetInstallReferrerAsync. Phản hồi chứa cùng một chuỗi được truyền vào tham số truy vấn referrer của trang thông tin trên Cửa hàng Play.

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