Instalação da Extensão Adobe Launch

Instruções de instalação para a extensão do Marketo Adobe Launch. As etapas abaixo são necessárias para enviar notificações por push e/ou mensagens no aplicativo.

Pré-requisitos

  1. Adicionar um aplicativo no Administrador do Marketo (obter a Chave Secreta e a ID do Munchkin do aplicativo)
  2. Configurar a propriedade no Adobe Launch portal
  3. Configure a chave secreta do aplicativo e a Munchkin ID para a propriedade no portal Adobe Launch
  4. Configurar notificações por push (opcional)

Como instalar a extensão do Marketo no iOS

Configurar cabeçalho de ponte Swift

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

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

  3. Vá para Projeto > Destino > Configurações de Compilação > Compilador Swift > Geração de Código. Adicione o seguinte caminho ao cabeçalho "Objetive-Bridging":

$(PODS_ROOT)/<_ProjectName_>-Bridging-Header.h

Inicializar extensão

Objetivo C

Atualize o método applicationDidBecomeActive conforme abaixo

code language-none
(void)applicationDidBecomeActive:(UIApplication*) application
{
 [[ALMarketo sharedInstance] initializeMarketo:nil];
}
Swift

Atualize o método applicationDidBecomeActive conforme abaixo

code language-none
func applicationDidBecomeActive(_ application: UIApplication)
{
 ALMarketo.sharedInstance().initializeMarketo(nil)
}

Dispositivos de teste iOS

  1. Selecione Projeto > Destino > Informações > Tipos de URL.
  2. Adicionar identificador: $
  3. Definir esquemas de URL: mkto-<Chave_secreta_>
  4. Incluir application:openURL:sourceApplication:annotation: a AppDelegate.m file (Objetive-C)

Tratar tipo de URL personalizado no AppDelegate

Objetivo C
code language-none
#ifdef __IPHONE_10_0
-(BOOL)application:(UIApplication *)application
           openURL:(NSURL *)url
           options:(NSDictionary *)options{
    return [[ALMarketo sharedInstance] application:application
                                         openURL:url
                               sourceApplication:nil
                                      annotation:nil];
}
#endif

- (BOOL)application:(UIApplication *)application
            openURL:(NSURL *)url
  sourceApplication:(NSString *)sourceApplication
         annotation:(id)annotation {
    return [[ALMarketo sharedInstance] application:application
                                         openURL:url
                               sourceApplication:nil
                                      annotation:nil];
}
Swift
code language-none
func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
    return ALMarketo.sharedInstance().application(application, open: url, sourceApplication: nil, annotation: nil)
}

Como instalar o Marketo SDK no Android

Configuração de extensão do Android

Siga as instruções no portal Adobe Launch

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 extensão

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 project. 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.**{ *; }

Android  Teste  Dispositivos

Adicione "MarketoActivity" a 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) for 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 Android.

Os desenvolvedores de aplicativos do Android agora podem usar diretamente o Firebase Cloud Messaging (FCM) da Google com este SDK.

Adicionar o FCM ao aplicativo

  1. Integre o Marketo Android SDK mais recente ao aplicativo do 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 Adicionar projeto.
      2. Selecione o projeto GCM na lista de projetos existentes do Google Cloud e selecione Adicionar Firebase.
      3. Na tela de boas-vindas do Firebase, selecione Adicionar o Firebase ao seu aplicativo Android.
      4. Forneça o nome do pacote e SHA-1 e selecione Adicionar aplicativo. Um novo arquivo google-services.json para seu aplicativo Firebase está sendo baixado.
      5. Selecione Continuar e siga as instruções detalhadas para adicionar o plug-in do Google Services no Android Studio.
    2. Navegue até Configurações do projeto em Visão geral do projeto

      1. Clique na guia Geral. Baixe o arquivo google-services.json.
      2. Clique na guia Cloud Messaging. Copiar Chave do Servidor e ID do Remetente. Forneça estas 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 de aplicativo do Android

        2. No nível de projeto build.gradle 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. Finalmente, clique em Sincronizar agora na barra que aparece na ID

    4. Editar o manifesto do aplicativo O FCM SDK adiciona automaticamente todas as permissões necessárias e a funcionalidade necessária do receptor. 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>
      

Perguntas frequentes sobre o FCM

Perguntas frequentes sobre o suporte ao Firebase Cloud Messaging.

P: Onde posso encontrar instruções para atualizar para a versão mais recente do MME SDK?As instruções podem ser encontradas no Site do Desenvolvedor do Marketo AQUI.

P: A atualização para a versão mais recente do SDK exigirá que eu publique uma versão atualizada do meu aplicativo Android para meus usuários existentes? Não.

P: Como isso afeta os clientes MME existentes que publicaram aplicativos Android integrados ao Marketo Android SDK? Eles podem migrar um aplicativo cliente GCM existente no Android para o Firebase Cloud Messaging (FCM) da seguinte maneira:

  1. No console Firebase, selecione Adicionar projeto.
  2. Selecione o projeto GCM na lista de projetos existentes do Google Cloud e selecione Adicionar Firebase.
  3. Na tela de boas-vindas do Firebase, selecione Adicionar o Firebase ao seu aplicativo Android.
  4. Forneça o nome do pacote e SHA-1 e selecione Adicionar aplicativo. Um novo arquivo google-services.json para o
  5. O aplicativo Firebase foi baixado.
  6. Selecione Continuar e siga as instruções detalhadas para adicionar o plug-in do Google Services no Android Studio.

P: Podemos segmentar os clientes em potencial criados usando o antigo Marketo SDK que usava o aplicativo GCM? Sim. Todos os clientes potenciais criados com o Marketo SDK podem ser direcionados para envio de notificações por push.

recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59