Skip to content


Configuración inicial del SDK

En este artículo de referencia se explica cómo instalar el SDK de Braze para tvOS. La instalación del SDK de Braze te proporcionará una funcionalidad básica de análisis.

El SDK de Braze de tvOS debe instalarse o actualizarse mediante CocoaPods, un administrador de dependencias para proyectos Objective-C y Swift. CocoaPods proporciona una mayor simplicidad para la integración y la actualización.

Integración del SDK de tvOS en CocoaPods

Paso 1: Instalar CocoaPods

La instalación del SDK a través de los CocoaPods de tvOS automatiza la mayor parte del proceso de instalación por ti. Antes de comenzar este proceso, asegúrate de que utilizas la versión de Ruby 2.0.0 o superior.

Ejecuta el siguiente comando para empezar:

1

$ sudo gem install cocoapods

Paso 2: Construir el archivo de bibliotecas

Ahora que has instalado la gema Ruby de CocoaPods, tendrás que crear un archivo en el directorio de tu proyecto de Xcode llamado Podfile.

Añade la siguiente línea a tu archivo de bibliotecas:

1
2
3

target 'YourAppTarget' do
  pod 'Appboy-tvOS-SDK'
end

Te sugerimos que versiones Braze para que las actualizaciones de pods recojan automáticamente cualquier cosa menor que una actualización de versión menor. Esto se ve así: pod 'Appboy-tvOS-SDK' ~> Major.Minor.Build. Si quieres integrar automáticamente la última versión del SDK de Braze, incluso con cambios importantes, puedes utilizar pod 'Appboy-tvOS-SDK' en tu archivo de bibliotecas.

Paso 3: Instalación del SDK de Braze

Para instalar los CocoaPods del SDK de Braze, ve al directorio de tu proyecto de aplicación Xcode en tu terminal y ejecuta el siguiente comando:

1

pod install

En este punto, deberías poder abrir el nuevo espacio de trabajo del proyecto Xcode creado por CocoaPods. Asegúrate de utilizar este espacio de trabajo de Xcode en lugar de tu proyecto de Xcode.

Paso 4: Actualizar el delegado de tu aplicación

Añade la siguiente línea de código a tu archivo AppDelegate.m:

1

#import <AppboyTVOSKit/AppboyKit.h>

Dentro de tu archivo AppDelegate.m, añade el siguiente fragmento de código dentro de tu método application:didFinishLaunchingWithOptions:

1
2
3

[Appboy startWithApiKey:@"YOUR-API-KEY"
         inApplication:application
     withLaunchOptions:launchOptions];

Por último, actualiza YOUR-API-KEY con el valor correcto desde tu página Administrar configuración.

Si estás integrando el SDK de Braze con CocoaPods o Carthage, añade la siguiente línea de código a tu archivo AppDelegate.swift:

1

import AppboyTVOSKit

Para más información sobre el uso de código Objective-C en proyectos Swift, consulta los documentos para desarrolladores de Apple.

En AppDelegate.swift, añade el siguiente fragmento de código a tu application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool:

1

Appboy.start(withApiKey: "YOUR-API-KEY", in:application, withLaunchOptions:launchOptions)

A continuación, actualiza YOUR-API-KEY con el valor correcto desde tu página Administrar configuración.

Nuestro singleton sharedInstance será nulo antes de llamar a startWithApiKey:, ya que es un requisito previo para utilizar cualquier funcionalidad de Braze.

Paso 5: Especifica tu punto de conexión personalizado o clúster de datos

Tu representante de Braze ya debería haberte informado del punto de conexión correcto.

Si se te proporciona un punto de conexión personalizado preexistente:

  • A partir de la versión 3.0.2 del SDK iOS de Braze, puedes establecer un punto de conexión personalizado utilizando el archivo Info.plist. Añade el diccionario Appboy a tu archivo Info.plist. Dentro del diccionario Appboy, añade la subentrada de cadena Endpoint y establece el valor a la autoridad de URL de tu punto de conexión personalizado (por ejemplo, sdk.iad-01.braze.com, no https://sdk.iad-01.braze.com).

Configuración del punto de conexión en tiempo de ejecución

Si se te proporciona un punto de conexión personalizado preexistente:

  • A partir de la versión 3.17.0+ del SDK iOS de Braze, puedes anular la configuración de tu punto de conexión a través de ABKEndpointKey dentro del parámetro appboyOptions pasado a startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions:. Establece el valor a la autoridad de URL de tu punto de conexión personalizado (por ejemplo, sdk.iad-01.braze.com, no https://sdk.iad-01.braze.com).

Integración del SDK completa

Ahora Braze debería estar recopilando datos de tu aplicación, y tu integración básica debería estar completa. Ten en cuenta que al compilar tu aplicación tvOS y cualquier otra biblioteca de terceros, Bitcode debe estar habilitado.

Actualizar el SDK de Braze mediante CocoaPods

Para actualizar un CocoaPod, simplemente ejecuta los siguientes comandos dentro del directorio de tu proyecto:

1

pod update

Personalizar Braze al iniciarse

Si deseas personalizar Braze al iniciarse, puedes utilizar en su lugar el método de inicialización de Braze startWithApiKey:inApplication:withLaunchOptions:withAppboyOptions y pasar un NSDictionary opcional de claves de inicio de Braze.

En tu archivo AppDelegate.m, dentro de tu método application:didFinishLaunchingWithOptions, añade el siguiente método de Braze:

1
2
3
4

[Appboy startWithApiKey:@"YOUR-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

En AppDelegate.swift, dentro de tu método application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool, añade el siguiente método de Braze:

1
2
3
4

Appboy.start(withApiKey: "YOUR-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:appboyOptions)

donde appboyOptions es un Dictionary de valores de configuración de inicio.

Este método sustituiría al método de inicialización startWithApiKey:inApplication:withLaunchOptions: y se llama con los siguientes parámetros:

  • YOUR-API-KEY: La clave de API de tu aplicación se encuentra en Administrar configuración en el panel de Braze.
  • application: La aplicación actual.
  • launchOptions: Las opciones NSDictionary que obtienes de application:didFinishLaunchingWithOptions:.
  • appboyOptions: Un NSDictionary opcional con valores de configuración de inicio para Braze.

Consulta Appboy.h para ver una lista de las claves de inicio de Braze.

Appboy.sharedInstance() y anulabilidad en Swift

A diferencia de la práctica habitual, el singleton Appboy.sharedInstance() es opcional. Esto se debe a que sharedInstance es nil antes de que se llame a startWithApiKey:, y hay algunas implementaciones no estándar pero no inválidas en las que se puede utilizar una inicialización retardada.

Si llamas a startWithApiKey: en tu delegado didFinishLaunchingWithOptions: antes de cualquier acceso al sharedInstance de Appboy (la implementación estándar), puedes utilizar el encadenamiento opcional, como Appboy.sharedInstance()?.changeUser("testUser"), para evitar comprobaciones engorrosas. Esto tendrá paridad con una implementación de Objective-C que haya asumido un sharedInstance no nulo.

Opciones de integración manual

También puedes integrar nuestro SDK para tvOS manualmente: simplemente obtén el Framework de nuestro repositorio público e inicializa Braze como se indica en las secciones anteriores.

Identificación de usuarios e informes de análisis

Consulta nuestra documentación de iOS para obtener información sobre la configuración de ID de usuario, el registro de eventos personalizados y la configuración de atributos de usuario. También te recomendamos que te familiarices con nuestras convenciones de nomenclatura de eventos.
New Stuff!