DocumentazioneMarketo Guida per gli sviluppatori

Installazione

Last update: Thu May 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

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. Aggiungere un’applicazione in Marketo Admin (ottieni la chiave segreta dell'applicazione e l'ID Munchkin)
  2. Configurare le 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. Scarica e installa 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 in navigatore progetti e aprirlo 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".

    Seleziona File di intestazione

  2. Denomina il file "<NomeProgetto>-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. Incolla il seguente codice all'interno del application:didFinishLaunchingWithOptions: funzione.

    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 di cui sopra utilizzando i valori "ID account Munchkin" e "Chiave segreta" presenti in Marketo Admin > Mobile Apps and Devices sezione.

Dispositivi di prova iOS

  1. Seleziona Progetto > Target > Informazioni > Tipi di URL.
  2. Aggiungi identificatore: $
  3. Impostare gli 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. Aggiungere un’applicazione in Marketo Admin (ottieni la chiave segreta dell'applicazione e l'ID Munchkin)
  2. Configurare le 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. La radice build.gradle il file 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 la tua app, aggiungi le seguenti righe nella proguard.cfg file. 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" 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.

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

Aggiunta di FCM all’applicazione

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

  2. Configurare l’app Firebase nella console Firebase.

    1. Crea/Aggiungi un progetto su 🔗Console Firebase.

      1. In Console Firebase, seleziona Add Project.
      2. Seleziona il progetto GCM dall’elenco dei progetti Google Cloud esistenti, quindi seleziona Add Firebase.
      3. Nella schermata di benvenuto di Firebase, seleziona Add Firebase to your Android App.
      4. Specifica il nome del pacchetto e SHA-1, quindi seleziona Add App. Una nuova google-services.json per la tua app Firebase viene scaricato.
      5. Seleziona Continue e segui 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