DocumentationGuide de developpement Marketo

Installation

Dernière mise à jour : 13 mai 2026

Créé pour :

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

Installez et initialisez Marketo Mobile SDK pour envoyer des notifications push, des messages in-app, ou les deux.

Installation de Marketo SDK sur iOS

Conditions préalables

  1. Ajoutez une application dans Marketo Admin et obtenez la clé secrète de l’application et l’ID Munchkin.
  2. Facultatif : Configurer des notifications push.

Installation de Framework via CocoaPods

  1. Installez CocoaPods. $ sudo gem install cocoapods
  2. Remplacez le répertoire par le répertoire de votre projet et créez un fichier PDF avec des valeurs par défaut intelligentes. $ pod init
  3. Ouvrez votre fichier PDF. $ open -a Xcode Podfile
  4. Ajoutez la ligne suivante à votre fichier PDF. $ pod 'Marketo-iOS-SDK'
  5. Enregistrez et fermez votre fichier PDF.
  6. Télécharger et installer Marketo iOS SDK. $ pod install
  7. Ouvrez l’espace de travail dans Xcode. $ open App.xcworkspace

Installer Framework à l’aide du gestionnaire de packages Swift

  1. Sélectionnez votre projet dans le navigateur de projets. Sous « Ajouter une dépendance de package », sélectionnez « + ».

    Ajouter une dépendance

  2. Ajoutez le package Marketo à partir de l’https://github.com/Marketo/ios-sdk .

    ​ URL du référentiel ​

  3. Ajoutez le lot de ressources. Recherchez MarketoFramework.XCframework dans le navigateur de projets et ouvrez-le dans le Finder. Faire glisser MKTResources.bundle pour copier les ressources du bundle.

Configurer l’en-tête de pontage Swift

  1. Accédez à Fichier > Nouveau > Fichier et sélectionnez « Fichier d’en-tête ».

    Sélectionnez « Fichier d’en-tête »

  2. Nommez le fichier « <ProjectName>-Bridging-Header ».

  3. Accédez à Projet > Cible > Phases de création > Compilateur Swift > Génération de code. Ajoutez le chemin suivant à l’en-tête de pontage d’objectifs :

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

    Phases de création

Initialiser SDK

Initialisez le SDK Marketo iOS avec votre ID de compte Munchkin et la clé secrète de l’application. Recherchez les deux valeurs sous « Applications mobiles et appareils » dans Marketo Admin.

  1. Ouvrez le fichier AppDelegate.m pour Objective-C ou le fichier Bridging pour Swift. Importez le fichier d’en-tête Marketo.h.

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

  2. Collez le code suivant dans la fonction application:didFinishLaunchingWithOptions : .

    Transmettez « natif » comme type de framework pour les applications natives.

Objectif C
code language-objectivec 
Marketo *sharedInstance = [Marketo sharedInstance];

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

sharedInstance.initialize(withMunchkinID: "munchkinAccountId", appSecret: "secretKey", mobileFrameworkType: "native", launchOptions: launchOptions)
  1. Remplacez munkinAccountId et secretKey par l’« ID de compte Munchkin » et la « Clé secrète » de Marketo Admin > Applications et appareils mobiles.

Appareils de test iOS

  1. Sélectionnez Projet > Cible > Informations > Types d’URL.
  2. Ajoutez l’identifiant ${PRODUCT_NAME}.
  3. Définissez les schémas d’URL sur mkto-<Secret Key_>.
  4. Ajoutez applicationsourceApplication au fichier AppDelegate.m pour Objective-C.

Gérer le type d’URL personnalisé dans AppDelegate

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

    return [[Marketo sharedInstance] application:app
                                         openURL:url
                                         options:options];
}
Swift
code language-swift 
private func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool
    {
        return Marketo.sharedInstance().application(app, open: url, options: options)
    }

Installation de Marketo SDK sur Android

Conditions préalables

  1. Ajoutez une application dans Marketo Admin et obtenez la clé secrète de l’application et l’ID Munchkin.
  2. Facultatif : Configurer des notifications push.
  3. Télécharger Marketo SDK pour Android

Configuration d’Android SDK avec Gradle

  1. Dans le fichier build.gradle de niveau application, ajoutez la dépendance sous la section dependencies.

    implementation 'com.marketo:MarketoSDK:0.8.9'

  2. Ajoutez la configuration suivante au fichier de build.gradle racine.

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

  3. Synchronisez le projet avec les fichiers Gradle.

Configurer les autorisations

Ouvrez AndroidManifest.xml et ajoutez les autorisations suivantes. Votre application doit demander les autorisations « INTERNET » et « ACCESS_NETWORK_STATE ». Ignorez cette étape si l’application le demande déjà.

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

Initialiser SDK

  1. Ouvrez la classe Application ou Activity . Importez le SDK Marketo dans l’activité avant setContentView ou dans le contexte de l’application.

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

  2. Configuration de ProGuard (en option)

    Si votre application utilise ProGuard, ajoutez les lignes suivantes au fichier proguard.cfg dans le dossier du projet. Cette configuration exclut le SDK Marketo de l’obscurcissement.

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

Appareils de test Android

Ajoutez « MarketoActivity » à AndroidManifest.xml dans la balise de l’application.

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

Prise en charge de Firebase Cloud Messaging

MME SDK pour Android prend en charge l’utilisation directe de Google Firebase Cloud Messaging (FCM).

Ajout de FCM à votre application

  1. Intégrez la dernière version de Marketo Android SDK dans l’application Android. Voir les étapes sur GitHub.

  2. Configurez l’application Firebase dans la console Firebase.

    1. Créez/ajoutez un projet sur la console 🔗Firebase).

      1. Dans la console Firebase, sélectionnez Add Project.
      2. Sélectionnez votre projet GCM dans la liste des projets Google Cloud existants, puis sélectionnez Add Firebase.
      3. Dans l’écran d’accueil de Firebase, sélectionnez Add Firebase to your Android App.
      4. Indiquez le nom de votre package et SHA-1, puis sélectionnez Add App. Un nouveau fichier google-services.json pour votre application Firebase est téléchargé.
      5. Sélectionnez Continue et suivez les instructions détaillées pour ajouter le plug-in Google Services dans Android Studio.

    2. Accédez aux « Paramètres du projet » dans la Présentation du projet

      1. Cliquez sur l’onglet « Général ». Téléchargez le fichier « google-services.json ».
      2. Cliquez sur l’onglet « Cloud Messaging ». Copiez « Clé du serveur » et « Identifiant de l’expéditeur ». Fournissez ces champs « Clé du serveur » et « ID de l’expéditeur » à Marketo.

    3. Configurez FCM dans l’application Android.

      1. Basculez vers la vue Projet dans Android Studio pour afficher le répertoire racine du projet

        1. Déplacez le fichier « google-services.json » téléchargé dans le répertoire racine du module d’application Android

        2. Dans le fichier build.gradle au niveau du projet, ajoutez ce qui suit :

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

        3. Dans le fichier build.gradle de niveau application, ajoutez ce qui suit :

          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. Enfin, sélectionnez Synchroniser maintenant dans la barre qui s’affiche dans l’ID

    4. Modifiez le manifeste de l’application. Le SDK FCM ajoute automatiquement les autorisations requises et la fonctionnalité de récepteur. Supprimez les éléments obsolètes suivants, qui peuvent entraîner la duplication des messages :

      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
marketo-developer-help