DocumentazioneGuida per sviluppatori di Marketo

Installazione dell'estensione Adobe Launch

Ultimo aggiornamento: 2 dicembre 2024
  • Argomenti:
  • Mobile marketing

Creato per:

  • Amministratore

Istruzioni di installazione per l'estensione Marketo Adobe Launch. I passaggi seguenti sono necessari per inviare notifiche push e/o messaggi in-app.

Prerequisiti

  1. Aggiungi un'applicazione in Marketo Admin (ottieni la chiave segreta dell'applicazione e l'ID Munchkin)
  2. Configura la proprietà in Adobe Launch portale
  3. Configurare la chiave segreta dell'applicazione e l'ID Munchkin per la proprietà nel portale Adobe Launch
  4. Imposta notifiche push (facoltativo)

Installare l’estensione Marketo su iOS

Imposta intestazione di bridging Swift

  1. Vai a File > New > File e seleziona Header File.

  2. Denomina il file "<ProjectName>-Bridging-Header".

  3. Vai a Project > Target > Build Settings > Swift Compiler > Code Generation. Aggiungi il seguente percorso all’intestazione "Objective-Bridging" (Ponderazione obiettivo):

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

Inizializza estensione

Obiettivo C

Aggiorna il metodo applicationDidBecomeActive come segue

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

Aggiorna il metodo applicationDidBecomeActive come segue

func applicationDidBecomeActive(_ application: UIApplication)
{
 ALMarketo.sharedInstance().initializeMarketo(nil)
}

Dispositivi di prova iOS

  1. Selezionare Project > Target > Info > URL Types.
  2. Aggiungi identificatore: $
  3. Imposta schemi URL: mkto-<Chiave_segreto_>
  4. Includi da application:openURL:sourceApplication:annotation: a AppDelegate.m file (Objective-C)

Gestire il tipo di URL personalizzato in AppDelegate

Obiettivo C
#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
func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
    return ALMarketo.sharedInstance().application(application, open: url, sourceApplication: nil, annotation: nil)
}

Installare Marketo SDK su Android

Configurazione dell'estensione Android

Segui le istruzioni nel portale Adobe Launch

Configurare le autorizzazioni

Apri AndroidManifest.xml e aggiungi le seguenti autorizzazioni. L'app deve richiedere le autorizzazioni "INTERNET" e "ACCESS_NETWORK_STATE". Se l'app richiede già queste autorizzazioni, salta questo passaggio.

<uses‐permission android:name="android.permission.INTERNET"></uses‐permission>
<uses‐permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses‐permission>

Inizializza estensione

Configurazione ProGuard (opzionale)

Se utilizzi ProGuard per l'app, aggiungi le seguenti righe nel file proguard.cfg. Il file si trova nella cartella project. L’aggiunta di questo codice esclude l’SDK Marketo dal processo di offuscamento.

-dontwarn com.marketo.*
-dontnote com.marketo.*
-keep class com.marketo.**{ *; }

Android  Test  Dispositivi

Aggiungi "MarketoActivity" a AndroidManifest.xml all'interno del tag dell'applicazione.

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

Supporto di Firebase Cloud Messaging

Il Software Development Kit (SDK) MME per Android è stato aggiornato a un framework più moderno, stabile e scalabile che contiene maggiore flessibilità e nuove funzioni di progettazione per lo sviluppatore di app Android.

Gli sviluppatori di app Android ora possono utilizzare direttamente Firebase Cloud Messaging (FCM) di Google con questo SDK.

Aggiunta di FCM all’applicazione

  1. Integra l’SDK Marketo Android più recente nell’app Android.  I passaggi sono disponibili in GitHub.

  2. Configurare l’app Firebase nella console Firebase.

    1. Crea/Aggiungi un progetto nella console 🔗Firebase.

      1. Nella console Firebase, seleziona Add Project.
      2. Selezionare il progetto GCM dall'elenco dei progetti Google Cloud esistenti e selezionare Add Firebase.
      3. Nella schermata di benvenuto di Firebase, seleziona Add Firebase to your Android App.
      4. Specificare il nome del pacchetto e SHA-1 e selezionare Add App. È stato scaricato un nuovo file google-services.json per l'app Firebase.
      5. Selezionare Continue e seguire le istruzioni dettagliate per l'aggiunta del plug-in Google Services in Android Studio.

    2. Passa a Project Settings in Project Overview

      1. Fare clic sulla scheda General. Scarica il file google-services.json.
      2. Fare clic sulla scheda Cloud Messaging. Copia Server Key e Sender ID. Fornisci questi Server Key e Sender ID a Marketo.

    3. Configurare le modifiche FCM nell’app Android

      1. Passa alla vista Progetto in Android Studio per visualizzare la directory principale del progetto

        1. Sposta il file google-services.json scaricato nella directory principale del modulo app Android

        2. Nel livello di progetto build.gradle aggiungere quanto segue:

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

        3. In build.gradle a livello di app, aggiungi quanto segue:

          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. Infine, fai clic su Sync now nella barra visualizzata nell'ID

    4. Modifica il manifesto dell’app L’SDK FCM aggiunge automaticamente tutte le autorizzazioni richieste e la funzionalità di ricezione richiesta. Assicurati di rimuovere i seguenti elementi obsoleti (e potenzialmente dannosi, in quanto potrebbero causare la duplicazione dei messaggi) dal manifesto dell'app:

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

Domande frequenti su FCM

Domande frequenti sul supporto di Firebase Cloud Messaging.

D: dove posso trovare le istruzioni per l'aggiornamento alla versione più recente dell'SDK di MME?Le istruzioni per sono disponibili nel sito Marketo Developer HERE.

D: per eseguire l'aggiornamento alla versione più recente dell'SDK è necessario pubblicare una versione aggiornata dell'applicazione Android per gli utenti esistenti?N.

D: che impatto ha sui clienti MME esistenti che hanno pubblicato app Android integrate con l’SDK di Marketo Android? Gli utenti possono eseguire la migrazione di un'app client GCM esistente da Android a Firebase Cloud Messaging (FCM) come segue:

  1. Nella console Firebase, seleziona Add Project.
  2. Selezionare il progetto GCM dall'elenco dei progetti Google Cloud esistenti e selezionare Add Firebase.
  3. Nella schermata di benvenuto di Firebase, seleziona Add Firebase to your Android App.
  4. Specificare il nome del pacchetto e SHA-1 e selezionare Add App. Un nuovo file google-services.json per il tuo
  5. L'app Firebase viene scaricata.
  6. Selezionare Continue e seguire le istruzioni dettagliate per l'aggiunta del plug-in Google Services in Android Studio.

D: è possibile eseguire il targeting dei lead creati utilizzando il vecchio SDK di Marketo che utilizzava l’app GCM? Sì. Tutti i lead creati con l’SDK di Marketo possono essere oggetto di targeting per l’invio di notifiche push.

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