Instalação
- Tópicos:
- Marketing para dispositivos móveis
Criado para:
- Administrador
Instruções de instalação do SDK do Marketo Mobile. As etapas abaixo são necessárias para enviar notificações por push e/ou mensagens no aplicativo.
Instalar o SDK do Marketo no iOS
Pré-requisitos
- Adicionar um aplicativo no Marketo Admin (obtenha a Chave Secreta e a ID do Munchkin do aplicativo)
- Configurar notificações por push (opcional)
Instalar a estrutura via CocoaPods
- Instale o CocoaPods.
$ sudo gem install cocoapods
- Altere o diretório para o diretório do projeto e crie um Podfile com padrões inteligentes.
$ pod init
- Abra o Podfile.
$ open -a Xcode Podfile
- Adicione a seguinte linha ao Podfile.
$ pod 'Marketo-iOS-SDK'
- Salve e feche o Podfile.
- Baixe e instale o SDK do Marketo iOS.
$ pod install
- Abra o espaço de trabalho no Xcode.
$ open App.xcworkspace
Instalar a estrutura usando o Gerenciador de pacotes Swift
-
Selecione seu projeto no Navegador de projetos e em "Adicionar dependência de pacote", clique em "+" como mostrado abaixo:
-
Adicionar o pacote do Marketo a partir deste repositório. Adicione este URL para este repositório: https://github.com/Marketo/ios-sdk.
-
Agora adicione o conjunto de recursos conforme mostrado: Localize
MarketoFramework.XCframework
no navegador do projeto e abra-o no Localizador. Arraste e solteMKTResources.bundle
para Copiar Recursos do Pacote.
Configurar cabeçalho de ponte Swift
-
Vá para Arquivo > Novo > Arquivo e selecione "Arquivo de cabeçalho".
-
Nomeie o arquivo "<ProjectName>-Bridging-Header".
-
Vá para Projeto > Target > Criar fases > Compilador Swift > Geração de código. Adicione o seguinte caminho ao Cabeçalho da ponte de objetivos:
$(PODS_ROOT)/<_ProjectName_>-Bridging-Header.h
Inicializar SDK
Antes de usar o Marketo iOS SDK, você deve inicializá-lo com sua ID de conta do Munchkin e a chave secreta do aplicativo. Você pode encontrar cada um desses na área Administrador do Marketo, abaixo de "Aplicativos e dispositivos móveis".
-
Abra o arquivo AppDelegate.m (Objetive-C) ou o arquivo Bridging (Swift) e importe o arquivo de cabeçalho Marketo.h.
#import <MarketoFramework/MarketoFramework.h>
-
Cole o seguinte código dentro da função
application:didFinishLaunchingWithOptions
:.Observe que devemos transmitir "nativo" como tipo de estrutura para Aplicativos nativos.
Marketo *sharedInstance = [Marketo sharedInstance];
[sharedInstance initializeWithMunchkinID:@"munchkinAccountId" appSecret:@"secretKey" mobileFrameworkType:@"native" launchOptions:launchOptions];
let sharedInstance: Marketo = Marketo.sharedInstance()
sharedInstance.initialize(withMunchkinID: "munchkinAccountId", appSecret: "secretKey", mobileFrameworkType: "native", launchOptions: launchOptions)
- Substitua
munkinAccountId
esecretKey
acima usando sua "ID de Conta do Munchkin" e a "Chave Secreta" encontradas na seção Admin > Aplicativos e Dispositivos Móveis do Marketo.
Dispositivos de teste iOS
- Selecione Projeto > Destino > Informações > Tipos de URL.
- Adicionar identificador: $
- Definir Esquemas de URL:
mkto-<Secret Key_>
- Incluir aplicativo
sourceApplication
no arquivo AppDelegate.m (Objetive-C)
Tratar tipo de URL personalizado no AppDelegate
- (BOOL)application:(UIApplication *)app
openURL:(NSURL *)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options{
return [[Marketo sharedInstance] application:app
openURL:url
options:options];
}
private func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool
{
return Marketo.sharedInstance().application(app, open: url, options: options)
}
Como instalar o SDK do Marketo no Android
Pré-requisitos
- Adicionar um aplicativo no Marketo Admin (obtenha a Chave Secreta e a ID do Munchkin do aplicativo)
- Configurar notificações por push (opcional)
- Baixar o SDK do Marketo para Android
Configuração do SDK do Android com Gradle
1. No arquivo build.gradle do nível do aplicativo, na seção dependências, adicione
implementation 'com.marketo:MarketoSDK:0.8.9'
-
O arquivo raiz
build.gradle
deve terbuildscript { repositories { google() mavenCentral() }
-
Sincronizar seu projeto com arquivos Gradle
Configurar permissões
Abra AndroidManifest.xml
e adicione as seguintes permissões. Seu aplicativo deve solicitar as permissões "INTERNET" e "ACCESS_NETWORK_STATE". Se seu aplicativo já solicitar essas permissões, ignore esta etapa.
<uses‐permission android:name="android.permission.INTERNET"></uses‐permission>
<uses‐permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses‐permission>
Inicializar SDK
-
Abra a classe Application ou Activity no aplicativo e importe o Marketo SDK para a atividade antes de setContentView ou no Contexto do aplicativo.
// Initialize Marketo Marketo marketoSdk = Marketo.getInstance(getApplicationContext()); marketoSdk.initializeSDK("native","munchkinAccountId","secretKey");
-
Configuração do ProGuard (opcional)
Se você estiver usando o ProGuard no seu aplicativo, adicione as seguintes linhas no arquivo
proguard.cfg
. O arquivo está localizado na pasta do projeto. A adição desse código exclui o Marketo SDK do processo de ofuscação.-dontwarn com.marketo.* -dontnote com.marketo.* -keep class com.marketo.`{ *; }
Dispositivos de teste Android
Adicionar "MarketoActivity" ao arquivo AndroidManifest.xml
dentro da marca do aplicativo.
<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>
Suporte a Firebase Cloud Messaging
O MME Software Development Kit (SDK) para Android foi atualizado para uma estrutura mais moderna, estável e escalável, que contém mais flexibilidade e novos recursos de engenharia para o desenvolvedor de aplicativos do Android.
Os desenvolvedores de aplicativos da Android agora podem usar diretamente o Firebase Cloud Messaging (FCM) da Google com este SDK.
Adicionar o FCM ao aplicativo
-
Integre o SDK do Marketo Android mais recente ao aplicativo da Android. As etapas estão disponíveis em GitHub.
-
Configurar o aplicativo Firebase no console do Firebase.
-
Criar/adicionar um projeto no 🔗Console Firebase.
- No console Firebase, selecione
Add Project
. - Selecione o projeto GCM na lista de projetos existentes da Google Cloud e selecione
Add Firebase
. - Na tela de boas-vindas do Firebase, selecione
Add Firebase to your Android App
. - Forneça o nome do pacote e SHA-1 e selecione
Add App
. Um novo arquivogoogle-services.json
para seu aplicativo Firebase está sendo baixado. - Selecione
Continue
e siga as instruções detalhadas para adicionar o plug-in do Google Services no Android Studio.
- No console Firebase, selecione
-
Navegue até "Configurações do projeto" na Visão geral do projeto
- Clique na guia 'Geral'. Baixe o arquivo "google-services.json".
- Clique na guia "Cloud Messaging". Copie "Chave do servidor" e "ID do remetente". Forneça essas "Chave do servidor" e "ID do remetente" à Marketo.
-
Configurar alterações no FCM no aplicativo do Android
-
Alterne para a exibição Projeto no Android Studio para ver o diretório raiz do projeto
-
Mova o arquivo "google-services.json" baixado para o diretório raiz do módulo do aplicativo Android
-
Em build.gradle no nível do projeto, adicione o seguinte:
buildscript { dependencies { classpath 'com.google.gms:google-services:4.0.0' } }
-
Em build.gradle no nível do aplicativo, adicione o seguinte:
dependencies { compile 'com.google.firebase:firebase-core:17.4.0' } // Add to the bottom of the file apply plugin: 'com.google.gms.google-services'
-
Por fim, clique em "Sincronizar agora" na barra exibida na ID
-
-
-
Editar o manifesto do aplicativo O SDK do FCM adiciona automaticamente todas as permissões necessárias e a funcionalidade do receptor necessária. Remova os seguintes elementos obsoletos (e possivelmente prejudiciais, pois podem causar duplicação de mensagem) do manifesto do seu aplicativo:
<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>
-