Instalación
Instale e inicialice Marketo Mobile SDK para enviar notificaciones push, mensajes en la aplicación o ambos.
Instalación de Marketo SDK en iOS
Requisitos previos
- Agregue una aplicación al administrador de Marketo y obtenga la clave secreta y el Munchkin Id de la aplicación.
- Opcional: Configurar notificaciones push.
Instalar Framework mediante CocoaPods
- Instale CocoaPods.
$ sudo gem install cocoapods - Cambie el directorio al directorio del proyecto y cree un Podfile con valores predeterminados inteligentes.
$ pod init - Abra el Podfile.
$ open -a Xcode Podfile - Añada la siguiente línea a su Podfile.
$ pod 'Marketo-iOS-SDK' - Guarde y cierre el Podfile.
- Descargue e instale Marketo iOS SDK.
$ pod install - Abra el espacio de trabajo en Xcode.
$ open App.xcworkspace
Instalación de Framework mediante el Administrador de paquetes Swift
-
Seleccione el proyecto en el Navegador de proyectos. En “Añadir dependencia del paquete”, seleccione “+”.
-
Agregar el paquete de Marketo desde https://github.com/Marketo/ios-sdk.
-
Añada el paquete de recursos. Busque
MarketoFramework.XCframeworken el Navegador de proyectos y ábralo en el Buscador. ArrastreMKTResources.bundlepara copiar los recursos del paquete.
Configurar encabezado de puente de Swift
-
Vaya a Archivo > Nuevo > Archivo y seleccione “Archivo de encabezado”.
-
Asigne un nombre al archivo “<ProjectName>-Bridging-Header”.
-
Vaya a Proyecto > Target > Fases de compilación > Compilador Swift > Generación de código. Añada la siguiente ruta al encabezado Objective-Bridging:
$(PODS_ROOT)/<_ProjectName_>-Bridging-Header.h
Inicializar SDK
Inicialice Marketo iOS SDK con su ID de cuenta de Munchkin y la clave secreta de la aplicación. Busque ambos valores en “Aplicaciones y dispositivos móviles” en Administración de Marketo.
-
Abra el archivo AppDelegate.m para Objective-C o el archivo puente para Swift. Importe el archivo de encabezado Marketo.h.
code language-none #import <MarketoFramework/MarketoFramework.h> -
Pegue el siguiente código dentro de la función
application:didFinishLaunchingWithOptions:.Pase “native” como el tipo de framework para aplicaciones nativas.
| code language-objectivec |
|---|
|
| code language-swift |
|---|
|
- Reemplace
munkinAccountIdysecretKeypor el “ID de cuenta de Munchkin” y la “clave secreta” de Marketo Admin > Aplicaciones y dispositivos móviles.
Dispositivos de prueba iOS
- Seleccione Proyecto > Target > Información > Tipos de URL.
- Agregue el identificador ${PRODUCT_NAME}.
- Definir esquemas de URL en
mkto-<Secret Key_>. - Agregue la aplicación sourceApplication al archivo AppDelegate.m para Objective-C.
Administrar el tipo de URL personalizada en AppDelegate
| code language-objectivec |
|---|
|
| code language-swift |
|---|
|
Cómo instalar Marketo SDK en Android
Requisitos previos
- Agregue una aplicación al administrador de Marketo y obtenga la clave secreta y el Munchkin Id de la aplicación.
- Opcional: Configurar notificaciones push.
- Descargar Marketo SDK para Android
Configuración de Android SDK con Gradle
-
En el archivo build.gradle de nivel de aplicación, agregue la dependencia en la sección de dependencias.
implementation 'com.marketo:MarketoSDK:0.8.9' -
Agregue la siguiente configuración al archivo raíz
build.gradle.code language-none buildscript { repositories { google() mavenCentral() } -
Sincronice el proyecto con los archivos de Gradle.
Configuración de permisos
Abra AndroidManifest.xml y agregue los siguientes permisos. La aplicación debe solicitar los permisos “INTERNET” y “ACCESS_NETWORK_STATE”. Omita este paso si la aplicación ya los solicita.
<uses‐permission android:name="android.permission.INTERNET"></uses‐permission>
<uses‐permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses‐permission>
Inicializar SDK
-
Abra la clase Application o Activity. Importe Marketo SDK en la actividad antes de setContentView o en el contexto de la aplicación.
code language-java // Initialize Marketo Marketo marketoSdk = Marketo.getInstance(getApplicationContext()); marketoSdk.initializeSDK("native","munchkinAccountId","secretKey"); -
Configuración de ProGuard (opcional)
Si su aplicación utiliza ProGuard, agregue las siguientes líneas al archivo
proguard.cfgen la carpeta del proyecto. Esta configuración excluye la SDK de Marketo de la ofuscación.code language-none -dontwarn com.marketo.* -dontnote com.marketo.* -keep class com.marketo.`{ *; }
Dispositivos de prueba Android
Agregue “MarketoActivity” a AndroidManifest.xml dentro de la etiqueta de la aplicación.
<activity android:name="com.marketo.MarketoActivity" android:configChanges="orientation|screenSize" >
<intent-filter android:label="MarketoActivity" >
<action android:name="android.intent.action.VIEW"/>
<category android:name="android.intent.category.DEFAULT"/>
<category android:name="android.intent.category.BROWSABLE"/>
<data android:host="add_test_device" android:scheme="mkto" />
</intent-filter>
</activity>
Compatibilidad con Firebase Cloud Messaging
MME SDK para Android admite el uso directo de Firebase Cloud Messaging (FCM) de Google.
Añadir FCM a la aplicación
-
Integre la última versión de Marketo Android SDK en la aplicación de Android. Consulte los pasos en GitHub.
-
Configure la aplicación Firebase en la consola de Firebase.
-
Crear/agregar un proyecto en 🔗consola Firebase.
- En la consola de Firebase, seleccione
Add Project. - Seleccione el proyecto GCM de la lista de proyectos existentes de Google Cloud y seleccione
Add Firebase. - En la pantalla de bienvenida de Firebase, seleccione
Add Firebase to your Android App. - Proporcione el nombre del paquete y SHA-1, y seleccione
Add App. Se ha descargado un nuevo archivo degoogle-services.jsonpara la aplicación Firebase. - Seleccione
Continuey siga las instrucciones detalladas para agregar el complemento de Google Services en Android Studio.
- En la consola de Firebase, seleccione
-
Vaya a “Configuración del proyecto” en Información general del proyecto
- Haga clic en la pestaña General. Descargue el archivo “google-services.json”.
- Haga clic en la pestaña “Mensajería en la nube”. Copie “Clave de servidor” e “ID de remitente”. Proporcione estas opciones “Clave de servidor” e “ID de remitente” a Marketo.
-
Configure FCM en la aplicación de Android.
-
Cambie a la vista Proyecto en Android Studio para ver el directorio raíz del proyecto
-
Mueva el archivo “google-services.json” descargado al directorio raíz del módulo de la aplicación de Android
-
En el archivo build.gradle de nivel de proyecto, agregue lo siguiente:
code language-none buildscript { dependencies { classpath 'com.google.gms:google-services:4.0.0' } } -
En App-level build.gradle, agregue lo siguiente:
code language-none dependencies { compile 'com.google.firebase:firebase-core:17.4.0' } // Add to the bottom of the file apply plugin: 'com.google.gms.google-services' -
Finalmente, selecciona Sincronizar ahora en la barra que aparece en el identificador
-
-
-
Edite el manifiesto de la aplicación. FCM SDK agrega automáticamente los permisos necesarios y la funcionalidad del receptor. Elimine los siguientes elementos obsoletos, que podrían provocar la duplicación de mensajes:
code language-xml <uses-permission android:name="android.permission.WAKE_LOCK" /> <permission android:name="<your-package-name>.permission.C2D_MESSAGE" android:protectionLevel="signature" /> <uses-permission android:name="<your-package-name>.permission.C2D_MESSAGE" /> ... <receiver> android:name="com.google.android.gms.gcm.GcmReceiver" android:exported="true" android:permission="com.google.android.c2dm.permission.SEND" <intent-filter> <action android:name="com.google.android.c2dm.intent.RECEIVE" /> <category android:name="<your-package-name> /> </intent-filter> </receiver>
-