DocumentaçãoMarketo Guia do Desenvolvedor

Instalação

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

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

  1. Adicionar um aplicativo no Marketo Admin (obtenha a Chave Secreta e a ID do Munchkin do aplicativo)
  2. Configurar notificações por push (opcional)

Instalar a estrutura via CocoaPods

  1. Instale o CocoaPods. $ sudo gem install cocoapods
  2. Altere o diretório para o diretório do projeto e crie um Podfile com padrões inteligentes. $ pod init
  3. Abra o Podfile. $ open -a Xcode Podfile
  4. Adicione a seguinte linha ao Podfile. $ pod 'Marketo-iOS-SDK'
  5. Salve e feche o Podfile.
  6. Baixe e instale o SDK do Marketo iOS. $ pod install
  7. Abra o espaço de trabalho no Xcode. $ open App.xcworkspace

Instalar a estrutura usando o Gerenciador de pacotes Swift

  1. Selecione seu projeto no Navegador de projetos e em "Adicionar dependência de pacote", clique em "+" como mostrado abaixo:

    Adicionar dependência

  2. Adicionar o pacote do Marketo a partir deste repositório. Adicione este URL para este repositório: https://github.com/Marketo/ios-sdk.

    URL do repositório

  3. Agora adicione o conjunto de recursos conforme mostrado: Localize MarketoFramework.XCframework no navegador do projeto e abra-o no Localizador. Arraste e solte MKTResources.bundle para Copiar Recursos do Pacote.

Configurar cabeçalho de ponte Swift

  1. Vá para Arquivo > Novo > Arquivo e selecione "Arquivo de cabeçalho".

    Selecione Arquivo de Cabeçalho

  2. Nomeie o arquivo "<ProjectName>-Bridging-Header".

  3. 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

    Fases de Compilação

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".

  1. Abra o arquivo AppDelegate.m (Objetive-C) ou o arquivo Bridging (Swift) e importe o arquivo de cabeçalho Marketo.h.

    code language-none 
    #import <MarketoFramework/MarketoFramework.h>

  2. Cole o seguinte código dentro da função application:didFinishLaunchingWithOptions:.

    Observe que devemos transmitir "nativo" como tipo de estrutura para Aplicativos nativos.

Objetivo C
code language-none 
Marketo *sharedInstance = [Marketo sharedInstance];

[sharedInstance initializeWithMunchkinID:@"munchkinAccountId" appSecret:@"secretKey" mobileFrameworkType:@"native" launchOptions:launchOptions];
Swift
code language-none 
let sharedInstance: Marketo = Marketo.sharedInstance()

sharedInstance.initialize(withMunchkinID: "munchkinAccountId", appSecret: "secretKey", mobileFrameworkType: "native", launchOptions: launchOptions)
  1. Substitua munkinAccountId e secretKey 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

  1. Selecione Projeto > Destino > Informações > Tipos de URL.
  2. Adicionar identificador: $
  3. Definir Esquemas de URL: mkto-<Secret Key_>
  4. Incluir aplicativosourceApplication no arquivo AppDelegate.m (Objetive-C)

Tratar tipo de URL personalizado no AppDelegate

Objetivo C
code language-none 
- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options{

    return [[Marketo sharedInstance] application:app
                                         openURL:url
                                         options:options];
}
Swift
code language-none 
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

  1. Adicionar um aplicativo no Marketo Admin (obtenha a Chave Secreta e a ID do Munchkin do aplicativo)
  2. Configurar notificações por push (opcional)
  3. 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'

  1. O arquivo raiz build.gradle deve ter

    code language-none 
    buildscript {
    repositories {
        google()
        mavenCentral()
    }

  2. 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

  1. Abra a classe Application ou Activity no aplicativo e importe o Marketo SDK para a atividade antes de setContentView ou no Contexto do aplicativo.

    code language-java 
    // Initialize Marketo
Marketo marketoSdk = Marketo.getInstance(getApplicationContext());
marketoSdk.initializeSDK("native","munchkinAccountId","secretKey");

  2. 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.

    code language-none 
    -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

  1. Integre o SDK do Marketo Android mais recente ao aplicativo da Android.  As etapas estão disponíveis em GitHub.

  2. Configurar o aplicativo Firebase no console do Firebase.

    1. Criar/adicionar um projeto no 🔗Console Firebase.

      1. No console Firebase, selecione Add Project.
      2. Selecione o projeto GCM na lista de projetos existentes da Google Cloud e selecione Add Firebase.
      3. Na tela de boas-vindas do Firebase, selecione Add Firebase to your Android App.
      4. Forneça o nome do pacote e SHA-1 e selecione Add App. Um novo arquivo google-services.json para seu aplicativo Firebase está sendo baixado.
      5. Selecione Continue e siga as instruções detalhadas para adicionar o plug-in do Google Services no Android Studio.

    2. Navegue até "Configurações do projeto" na Visão geral do projeto

      1. Clique na guia 'Geral'. Baixe o arquivo "google-services.json".
      2. Clique na guia "Cloud Messaging". Copie "Chave do servidor" e "ID do remetente". Forneça essas "Chave do servidor" e "ID do remetente" à Marketo.

    3. Configurar alterações no FCM no aplicativo do Android

      1. Alterne para a exibição Projeto no Android Studio para ver o diretório raiz do projeto

        1. Mova o arquivo "google-services.json" baixado para o diretório raiz do módulo do aplicativo Android

        2. Em build.gradle no nível do projeto, adicione o seguinte:

          code language-none 
          buildscript {
  dependencies {
    classpath 'com.google.gms:google-services:4.0.0'
  }
}

        3. Em build.gradle no nível do aplicativo, adicione o seguinte:

          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'

        4. Por fim, clique em "Sincronizar agora" na barra exibida na ID

    4. 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:

      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>
recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59