Traqio.

SDK

SDK para Unity

Añade Traqio a un juego de Unity: el paquete app.traqio.sdk lee el Play Install Referrer en Android, registra en SKAdNetwork en iOS y gestiona los deep links.

Abrir en:ChatGPTClaudePerplexity

app.traqio.sdk es el SDK de Traqio para Unity (namespace Traqio, clase TraqioSdk). En Android lee el Install Referrer de Google Play mediante AndroidJavaProxy; en iOS, un pequeño plugin nativo registra las instalaciones en SKAdNetwork. Los eventos se ponen en cola en PlayerPrefs y los envía una corrutina; los deep links llegan a través de Application.deepLinkActivated sin código adicional.

Aún no está en UPM — acceso anticipado

Paquete app.traqio.sdk · versión 0.1.0Los paquetes del SDK aún no están en sus registros públicos. Para integrarlo hoy, pide la build: hello@traqio.appNivel de prueba: Implementación real, pero ningún build automatizado lo demuestra todavía.

Requisitos#

  • Unity 2021.3 o posterior.

Configuración#

  1. Añade el paquete#

    Packages/manifest.json
    // Packages/manifest.json — once the package is published (git URL / OpenUPM)
"dependencies": {
  "app.traqio.sdk": "0.1.0"
}

    El paquete aún no está en OpenUPM ni en una URL git pública. Mientras tanto, usa Window → Package Manager → + → Add package from disk, y elige el package.json de la carpeta que te enviamos.

  2. Inicializa una vez#

    using Traqio;
using UnityEngine;

public class Bootstrap : MonoBehaviour
{
    void Awake()
    {
        // Creates its own "Traqio" GameObject (DontDestroyOnLoad); call it once.
        TraqioSdk.Init("YOUR_SDK_KEY", "https://api.traqio.app");
    }
}

    El arranque se ejecuta como una corrutina en el GameObject propio del SDK: se informa de la instalación, se resuelve el enlace diferido, se registra la apertura de la app, y la cola se envía con un temporizador y cada vez que el juego se pausa.

  3. Registra eventos#

    TraqioSdk.SetUserId(player.Id);           // same id as RevenueCat's app_user_id
TraqioSdk.Track("tutorial_complete");
TraqioSdk.Track("purchase", 4.99f, "EUR");

    Nombres: Nombres de eventos. Consentimiento: TraqioSdk.SetConsent(bool).

Deep links#

var unsubscribe = TraqioSdk.OnDeepLink(link =>
{
    if (link.DeepLink != null) Router.Open(link.DeepLink);
});

TraqioSdk.GetDeferredDeepLink(link => { /* null when the install came from no link */ });

Aún no está en este SDK#

En iOS no se define ningún valor de conversión ni se informa de ningún token de Apple Ads. Sin id de transacción en las compras, sin ingresos publicitarios de AdMob, sin borrado desde la app: usa RevenueCat y el borrado del lado del servidor.

Pruebas hasta ahora

La lógica del SDK se ha probado contra un servidor simulado, pero Unity es el único SDK sin build automatizada: compilar contra UnityEngine requiere una licencia de Unity en CI, que aún no está configurada. Solo el script de Editor que modifica el proyecto Gradle de Android se prueba en CI, sobre .NET estándar.

Preguntas frecuentes#

¿Tengo que añadir la librería Install Referrer a mi proyecto de Unity?
No. Cuando Unity genera el proyecto Gradle de Android, el script de Editor del paquete añade com.android.installreferrer:installreferrer:2.2, la entrada <queries> de Play Store que exigen Android 11 y posteriores, y una regla keep para las builds minificadas. No hace falta ninguna plantilla de Gradle ni manifest personalizados; una que ya los declare se deja tal cual.
¿El SDK de Traqio para Unity funciona en el Editor?
El C# se ejecuta en el Editor y envía eventos, pero las llamadas al Install Referrer y a SKAdNetwork solo se compilan para las builds de dispositivo Android e iOS. La atribución solo puede observarse en una build de dispositivo instalada desde una tienda.

Actualizado el 19 de octubre de 2026