Branch

Branch permite a las empresas llegar a sus usuarios, interactuar con ellos y analizar resultados en distintos dispositivos, canales y plataformas. Es una plataforma intuitiva diseñada para aumentar los ingresos móviles mediante enlaces especializados que funcionan sin problemas en todos los dispositivos, canales y plataformas.

Adapty ofrece un conjunto completo de datos que te permite rastrear eventos de suscripción desde 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 consultar y ver estos datos fácilmente en la página del perfil del usuario.

2. Envío de 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 hacer seguimiento de estos eventos desde el 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 de Branch Key, abre los Ajustes de cuenta de Branch y busca el campo Branch Key. Úsalo en el campo Key test (para Sandbox) o Key live (para producción) del 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 simplemente 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.

Recomendamos usar los nombres de eventos predeterminados que ofrece Adapty, aunque puedes cambiarlos según tus necesidades. Adapty enviará 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.

Conecta 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 {
      // Adapty SDK 4.x
      try await Adapty.setIntegrationIdentifier(.branchId(<BRANCH_IDENTITY_ID>))
      // Adapty SDK 3.x
      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 ID de usuario de Branch 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 SDK 4.x
                  Adapty.updateAttribution(data, source: .branch)
                  // Adapty SDK 3.x
                  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 de los eventos

Adapty envía los eventos seleccionados a Branch según lo configurado 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: