DocumentazioneMarketo Guida per gli sviluppatori

Installazione

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Amministratore

Istruzioni di installazione per l’SDK di Marketo Mobile. I passaggi seguenti sono necessari per inviare notifiche push e/o messaggi in-app.

Installare Marketo SDK su iOS

Prerequisiti

  1. Aggiungi un'applicazione in Marketo Admin (ottieni la chiave segreta dell'applicazione e l'ID Munchkin)
  2. Imposta notifiche push (facoltativo)

Installare Framework tramite CocoaPods

  1. Installare CocoaPods. $ sudo gem install cocoapods
  2. Cambia la directory nella directory del progetto e crea un Podfile con impostazioni avanzate. $ pod init
  3. Apri il Podfile. $ open -a Xcode Podfile
  4. Aggiungi la seguente riga al tuo Podfile. $ pod 'Marketo-iOS-SDK'
  5. Salva e chiudi il Podfile.
  6. Scaricare e installare Marketo iOS SDK. $ pod install
  7. Apri l’area di lavoro in Xcode. $ open App.xcworkspace

Installare Framework con Gestione pacchetti Swift

  1. Seleziona il progetto da Navigatore progetti e in "Aggiungi dipendenza pacchetto" fai clic su "+" come mostrato di seguito:

    Aggiungi dipendenza

  2. Aggiungi il pacchetto Marketo da questo archivio. Aggiungi questo URL per questo archivio: https://github.com/Marketo/ios-sdk.

    URL archivio

  3. Ora aggiungi il bundle di risorse come mostrato: Individua MarketoFramework.XCframework nel navigatore progetti e aprilo nel Finder. Trascina MKTResources.bundle per copiare le risorse del bundle.

Imposta intestazione di bridging Swift

  1. Selezionare File > Nuovo > File e selezionare "Header File".

    Selezionare File di intestazione

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

  3. Vai a Progetto > Target > Fasi build > Compilatore Swift > Generazione del codice. Aggiungi il seguente percorso a Objective-Bridging Header:

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

    Fasi build

Inizializza SDK

Prima di poter utilizzare l'SDK di Marketo iOS, è necessario inizializzarlo con l'ID account Munchkin e la chiave segreta dell'app. Puoi trovare ciascuno di questi elementi nell’area di amministrazione di Marketo sotto "App e dispositivi mobili".

  1. Apri il file AppDelegate.m (Objective-C) o Bridging (Swift) e importa il file di intestazione Marketo.h.

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

  2. Incollare il codice seguente nella funzione application:didFinishLaunchingWithOptions:.

    Tieni presente che dobbiamo passare "nativo" come tipo di framework per le app native.

Obiettivo 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. Sostituisci munkinAccountId e secretKey in alto utilizzando i tuoi "ID account Munchkin" e "Chiave segreta" che si trovano nella sezione Marketo Admin > Mobile Apps and Devices.

Dispositivi di prova iOS

  1. Seleziona Progetto > Target > Informazioni > Tipi di URL.
  2. Aggiungi identificatore: $
  3. Imposta schemi URL: mkto-<Secret Key_>
  4. Includi applicazionesourceApplication nel file AppDelegate.m (Objective-C)

Gestire il tipo di URL personalizzato in AppDelegate

Obiettivo 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)
    }

Installare Marketo SDK su Android

Prerequisiti

  1. Aggiungi un'applicazione in Marketo Admin (ottieni la chiave segreta dell'applicazione e l'ID Munchkin)
  2. Imposta notifiche push (facoltativo)
  3. Scarica Marketo SDK per Android

Configurazione dell’SDK Android con Gradle

1. Nel file build.gradle a livello di applicazione, nella sezione dipendenze, aggiungi

implementation 'com.marketo:MarketoSDK:0.8.9'

  1. Il file radice build.gradle deve avere

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

  2. Sincronizza il progetto con file Gradle

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 SDK

  1. Apri la classe Application o Activity nell'app e importa l'SDK di Marketo nell'attività prima di setContentView o in Application Context.

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

  2. Configurazione ProGuard (opzionale)

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

    code language-none 
    -dontwarn com.marketo.*
-dontnote com.marketo.*
-keep class com.marketo.`{ *; }

Dispositivi di prova Android

Aggiungi "MarketoActivity" al file 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. Vai a "Impostazioni progetto" in Panoramica progetto

      1. Fare clic sulla scheda Generale. Scarica il file "google-services.json".
      2. Fai clic sulla scheda "Messaggistica cloud". Copia "Chiave server" e "ID mittente". 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 scaricato "google-services.json" nella directory principale del modulo app Android

        2. In build.gradle a livello di progetto, aggiungi quanto segue:

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

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

          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. Infine, fai clic su "Sincronizza ora" 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:

      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