Branch

Branch permite a los clientes llegar, interactuar y evaluar resultados en distintos dispositivos, canales y plataformas. Es una plataforma fácil de usar diseñada para aumentar los ingresos móviles mediante enlaces especializados que funcionan perfectamente en todos los dispositivos, canales y plataformas.

Adapty ofrece un conjunto completo de datos que te permite rastrear los eventos de suscripción de los stores en un solo lugar. Con Adapty, puedes ver fácilmente el comportamiento de tus suscriptores, conocer sus preferencias y usar esa información para comunicarte con ellos de forma dirigida y efectiva.

La integración entre Adapty y Branch funciona de dos maneras principales.

1. Recibir datos de atribución de Branch
   Una vez que hayas configurado la integración con Branch, Adapty comenzará a recibir datos de atribución de Branch. Puedes acceder y ver estos datos fácilmente en la página de perfil del usuario.

   

2. Enviar eventos de suscripción a Branch
   Adapty puede enviar todos los eventos de suscripción configurados en tu integración a Branch. Como resultado, podrás rastrear esos eventos dentro del dashboard de Branch.

Configurar la integración

Conectar Adapty con Branch

Para integrar Branch, ve a Integrations > Branch en el Adapty Dashboard, activa el interruptor y rellena los campos.

Para obtener el valor del campo Branch Key, abre tu Account Settings de Branch y localiza el campo Branch Key. Úsalo para el campo Key test (para Sandbox) o Key live (para Producción) en el Adapty Dashboard. En Branch, cambia entre los entornos Live y Tests para obtener la clave correspondiente.

Configurar eventos y etiquetas

Debajo de las credenciales encontrarás tres grupos de eventos que puedes enviar a Branch desde Adapty. Activa únicamente los que necesites. Consulta la lista completa de eventos que ofrece Adapty aquí.

Puedes enviar un evento con los ingresos netos (después del recorte de Apple/Google) o solo los ingresos brutos. También puedes marcar la casilla para reportar en la moneda del usuario.

Te recomendamos usar los nombres de evento predeterminados que proporciona Adapty. Sin embargo, puedes cambiarlos según tus necesidades.

Adapty enviará los eventos de suscripción a Branch mediante una integración servidor a servidor, lo que te permitirá ver todos los eventos de suscripción en tu dashboard de Branch y vincularlos a tus campañas de adquisición.

Conectar tu app con Branch

1. Llama al método .setIntegrationIdentifier() del SDK para inicializar la conexión. Puedes pasar tu Branch Identity ID al parámetro customerUserId.

do {
    try await Adapty.setIntegrationIdentifier(
        key: "branch_id", 
        value: <BRANCH_IDENTITY_ID>
    )
} catch {
    // handle the error
}

// login and update attribution and identifier
Branch.getAutoInstance(this)
    .setIdentity("YOUR_USER_ID") { referringParams, error ->
        referringParams?.let { data ->
            Adapty.updateAttribution(data, "branch") { error ->
                if (error != null) {
                    //handle the error
                }
            }
        }
    }

// logout
Branch.getAutoInstance(context).logout()

import 'package:flutter_branch_sdk/flutter_branch_sdk.dart';

FlutterBranchSdk.setIdentity('YOUR_USER_ID');

Branch.setIdentity("your user id");

import branch from 'react-native-branch';

branch.setIdentity('YOUR_USER_ID');

2. Usa el método .updateAttribution() para guardar los datos de atribución. Si no especificaste el Branch user ID en el paso anterior, pásalo al parámetro networkUserId aquí.

class YourBranchImplementation {
    func initializeBranch() {
        // Pass the attribution you receive from the initializing method of Branch iOS SDK to Adapty.
        Branch.getInstance().initSession(launchOptions: launchOptions) { (data, error) in
            if let data {
                Adapty.updateAttribution(data, source: .branch)
            }
        }
    }
}

//everything is in the above snippet for Android

try {
    await Adapty().setIntegrationIdentifier(
        key: "branch_id", 
        value: <BRANCH_IDENTITY_ID>,
    );
} on AdaptyError catch (adaptyError) {
    // handle the error
} catch (e) {
    // handle the error
}

using AdaptySDK;

Branch.initSession(delegate(Dictionary<string, object> parameters, string error) {
    string attributionString = JsonUtility.ToJson(parameters);
    
    Adapty.UpdateAttribution(
      attributionString, 
      "branch", 
      (error) => {
        // handle the error
    });
});

import { adapty, AttributionSource } from 'react-native-adapty';
import branch from 'react-native-branch';

branch.subscribe({
  enComplete: ({
    params,
  }) => {
    adapty.updateAttribution(params, "branch");
  },
});

Estructura del evento

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

{
  "branch_key": "key_live_kaFuWw8WvY7n1ss7...",
  "name": "PURCHASE",
  "user_data": {
    "os": "iOS",
    "developer_identity": "user_12345",
    "country": "US",
    "ip": "192.168.100.1",
    "idfa": "00000000-0000-0000-0000-000000000000",
    "idfv": "00000000-0000-0000-0000-000000000000",
    "aaid": "00000000-0000-0000-0000-000000000000"
  },
  "event_data": {
    "transaction_id": "GPA.3383-4699-1373-07113",
    "revenue": 9.99,
    "currency": "USD"
  },
  "custom_data": {
    "vendor_product_id": "yearly.premium.6999",
    "original_transaction_id": "GPA.3383-4699-1373-07113",
    "store": "play_store",
    "environment": "production"
  }
}

Donde: