Integración con Tenjin

Tenjin es una plataforma de atribución y analítica móvil para desarrolladores de apps y profesionales del marketing. Proporciona herramientas para medir y optimizar campañas de adquisición de usuarios, ofreciendo información detallada sobre el rendimiento de la app y el comportamiento de los usuarios. Con su enfoque transparente y flexible, Tenjin agrega datos de redes publicitarias y stores de apps, lo que permite a los equipos analizar el ROI, rastrear conversiones y monitorear métricas clave de rendimiento.

Al reenviar eventos de suscripción a Tenjin, puedes ver exactamente de dónde provienen las conversiones y qué campañas generan más valor en todos los canales, plataformas y dispositivos. En esencia, los dashboards de Tenjin ofrecen analítica avanzada para campañas de marketing.

Al reenviar la atribución de Tenjin a Adapty, enriqueces la analítica de Adapty con criterios de filtrado adicionales que puedes usar en el análisis de cohortes y conversiones.

Esta integración funciona de dos maneras principales:

1. Recibir datos de atribución de Tenjin Una vez integrado, Adapty recopila datos de atribución de Tenjin. Puedes acceder a esta información en la página del perfil del usuario en el Adapty Dashboard.
2. Enviar eventos de suscripción a Tenjin Adapty envía eventos de compra a Tenjin en tiempo real. Estos eventos ayudan a evaluar la efectividad de tus campañas publicitarias directamente en el dashboard de Tenjin.

Configurar la integración

Conectar Adapty con Tenjin

1. Abre la página Integrations -> Tenjin en el Adapty Dashboard.

2. Activa el interruptor para habilitar la integración.

   

3. Inicia sesión en el Tenjin Dashboard.

4. Ve a Configuration -> Apps en el menú de navegación.

   

5. Selecciona la app para tu plataforma (iOS o Android) y navega a la pestaña App and SDK.

6. En la pestaña App and SDK, haz clic en Copy en la columna SDK Key. Si aún no tienes una SDK Key, haz clic en el botón Generate SDK Key para crear una.

   

7. Vuelve al Adapty Dashboard y pega la SDK Key copiada en el campo de la plataforma correspondiente:

   • Para apps iOS: pégala en el campo iOS SDK Key o iOS Sandbox SDK Key
   • Para apps Android: pégala en el campo Android SDK Key o Android Sandbox SDK Key
   Tenjin no tiene un modo Sandbox específico para la integración server-to-server. Usa una app de Tenjin separada o la misma clave tanto para eventos de producción como de sandbox.

   

8. Si tienes apps en ambas plataformas, repite los pasos 5-7 para la otra plataforma.

9. (opcional) Ajusta la sección How the revenue data should be sent si es necesario. Para una explicación detallada de sus configuraciones, consulta la sección Integration settings.

10. Haz clic en Save para finalizar la configuración.

Adapty comenzará a enviar eventos de compra a Tenjin y a recibir datos de atribución. Puedes ajustar el intercambio de eventos en la sección Events names.

Configurar eventos y etiquetas

Tenjin solo acepta eventos de compra y Trial started. En la sección Events names, selecciona qué eventos compartir con Tenjin según tus objetivos de seguimiento.

Conectar tu app con Tenjin

Usa el método del SDK Adapty.updateAttribution() para obtener los datos de atribución de Tenjin y enviarlos a Adapty.

func updateTenjinId() {
    guard let tenjinId = TenjinSDK.getAnalyticsInstallationId() else { return }

    do {
        try await Adapty.setIntegrationIdentifier(
            key: "tenjin_analytics_installation_id",
            value: tenjinId
        )
    } catch {
        // handle the error
    }
}

func updateTenjinAttribution() {
    let instance = TenjinSDK.getInstance("<YOUR_TENJIN_API_TOKEN>")
        
    instance?.getAttributionInfo { info, _ in
        guard let info else { return }

        Task {
            do {
                try await Adapty.updateAttribution(info, source: "tenjin")
            } catch {
                // handle the error
            }
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.analyticsInstallationId) { error ->
    if (error != null) {
        // handle the error
    }
}

tenjinSdk.getAttributionInfo { attribution ->
    if (attribution == null) return@getAttributionInfo

    Adapty.updateAttribution(attribution, "tenjin") { error ->
        if (error != null) {
            // handle the error
        }
    }
}

Adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", tenjinSdk.getAnalyticsInstallationId(), error -> {
    if (error != null) {
        // handle the error
    }
});

tenjinSdk.getAttributionInfo(attribution -> {
    if (attribution == null) return;

    Adapty.updateAttribution(attribution, "tenjin", error -> {
        // handle the error
    });
});

try {
    final tenjinId = await TenjinSDK.instance.getAnalyticsInstallationId();
    
    if (tenjinId != null) {
        await Adapty().setIntegrationIdentifier(
            key: 'tenjin_analytics_installation_id', 
            value: tenjinId,
        );
    }

    final attribution = await TenjinSDK.instance.getAttributionInfo();
    if (attribution != null) {
        await Adapty().updateAttribution(attribution, source: 'tenjin');
    }
} catch (e) {
    // handle the error
}

using AdaptySDK;
using System.Linq;

BaseTenjin instance = Tenjin.getInstance("<SDK_KEY>");
var tenjinId = instance.GetAnalyticsInstallationId();

Adapty.SetIntegrationIdentifier(
    "tenjin_analytics_installation_id",
    tenjinId,
    (error) => {
        // handle the error
    });

instance.GetAttributionInfo((attribution) => {
    var dynamicAttribution = attribution.ToDictionary(
        kvp => kvp.Key,
        kvp => (dynamic)kvp.Value
    );
                
Adapty.UpdateAttribution(
    dynamicAttribution,
    "tenjin",
    (error) => {
        // handle the error
    });
});

// ...
const posthog = usePostHog()

// ...
try {
  await adapty.setIntegrationIdentifier("tenjin_analytics_installation_id", await Tenjin.getAnalyticsInstallationId());
} catch (error) {
  // handle `AdaptyError`
}

Estructura de los eventos

Adapty envía los eventos seleccionados a Tenjin tal como se configuraron en la sección Events names de la página de integración con Tenjin. Cada evento tiene la siguiente estructura:

{
  "price": 99.0,
  "locale": "en-US",
  "country": "ME",
  "postcut": "false",
  "currency": "USD",
  "platform": "ios",
  "quantity": 1,
  "bundle_id": "com.adapty.adaptydemoapp",
  "ip_address": "127.0.0.1",
  "os_version": "18.1.1",
  "product_id": "month.premium.99",
  "app_version": "3.2.0",
  "sdk_version": "server",
  "device_model": "iPhone 13 Mini",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "os_version_release": "18.1.1",
  "developer_device_id": "00000000-0000-0000-0000-000000000000",
  "analytics_installation_id": "00000000-0000-0000-0000-000000000000"
}

Donde: