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 những 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 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 giới thiệu, bạn có thể biết được những nguồn lưu lượng truy cập nào gửi nhiều người dùng nhất để 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 cho quảng cáo và tối đa hoá lợi tức đầu tư.

Không gian tên: PlayPcSdkManaged.InstallReferrer

Lớp ứng dụng: InstallReferrerClient

Đường 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 với trang Cửa hàng Google Play của ứng dụng. 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: Một chuỗi biểu thị 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à đang 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 phương thức khởi tạo để tạo một InstallReferrerClient. Điều này đảm bảo rằng các lệnh gọi lại an toàn cho Unity sẽ tự động được đă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à 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 lượt cài đặt bằng Install Referrer API.

Truy vấn thông tin chi tiết về đơn vị giới thiệu bằng cách sử dụ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);
    }
}