Completa la integración.

Antes de seguir estos pasos, asegúrate de haber integrado el SDK mediante Carthage, CocoaPods, Swift Package Manager o una integración manual.

Paso 1: Actualiza el delegado de tu aplicación

• objective-c
• swift

1
#import "Appboy-iOS-SDK/AppboyKit.h"

1
#import "AppboyKit.h"

1
2
3
[Appboy startWithApiKey:@"YOUR-APP-IDENTIFIER-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions];

1
import Appboy_iOS_SDK

1
import AppboyKit

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

Paso 2: Especifica tu clúster de datos

Configuración del punto final en tiempo de compilación (recomendado)

Si se te da un punto final personalizado preexistente:

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

Tu representante de Braze ya debería haberte indicado el punto final correcto.

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

Si se te da un punto final personalizado preexistente:

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

Integración de SDK completa

Ahora Braze debería estar recopilando datos de tu aplicación, y tu integración básica debería estar completa. Consulta los artículos siguientes para habilitar el seguimiento de eventos personalizado, la mensajería push y la línea completa de características de Braze.

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.

• objective-c
• swift

1
2
3
4
[Appboy startWithApiKey:@"YOUR-APP-IDENTIFIER-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

1
2
3
4
Appboy.start(withApiKey: "YOUR-APP-IDENTIFIER-API-KEY",
                 in:application,
                 withLaunchOptions:launchOptions,
                 withAppboyOptions:appboyOptions)

Este método se llama con los siguientes parámetros:

• YOUR-APP-IDENTIFIER-API-KEY - Tu clave de API identificadora de la aplicación desde 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 teclas de inicio de Braze.

Appboy.sharedInstance() y anulabilidad 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 a 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.

Recursos adicionales

La documentación completa de las clases de iOS está disponible para proporcionar orientación adicional sobre cualquier método del SDK.