DocumentationMarketo Developer Guide

Adobe Launch Extension Installation

Last update: Tue Aug 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Admin

Installation instructions for Adobe Launch Marketo extension. The steps below are required to send Push Notifications and/or In-App Messages.

Prerequisites

  1. Add an application in Marketo Admin (obtain your application Secret Key and Munchkin Id)
  2. Configure the property in Adobe Launch portal
  3. Configure application secret key & Munchkin ID for the property in the Adobe Launch portal
  4. Setup Push Notifications (optional)

How to Install Marketo Extension on iOS

Setup Swift Bridging Header

  1. Go to File > New > File and Select Header File.

  2. Name the file “<ProjectName>-Bridging-Header”.

  3. Go to Project > Target > Build Settings > Swift Compiler > Code Generation. Add the following path to the “Objective-Bridging” Header:

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

Initialize Extension

Objective C

Update the applicationDidBecomeActive method like below

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

Update the applicationDidBecomeActive method like below

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

iOS Test Devices

  1. Select Project > Target > Info > URL Types.
  2. Add identifier: $
  3. Set URL Schemes: mkto-<S_ecret Key_>
  4. Include application:openURL:sourceApplication:annotation: to AppDelegate.m file (Objective-C)

Handle Custom Url Type in AppDelegate

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

How to Install Marketo SDK on Android

Android Extension Setup

Follow instructions in Adobe Launch portal

Configure Permissions

Open AndroidManifest.xml and add following permissions. Your app must request the “INTERNET” and “ACCESS_NETWORK_STATE” permissions. If your app already requests these permissions, then skip this step.

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

Initialize Extension

ProGuard Configuration (Optional)

If you are using ProGuard for your app, then add the following lines in your proguard.cfg file. The file is located within your project folder. Adding this code excludes the Marketo SDK from the obfuscation process.

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

Android  Test  Devices

Add “MarketoActivity” to AndroidManifest.xml inside the application tag.

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

Firebase Cloud Messaging Support

The MME Software Development Kit (SDK) for Android has been updated to a more modern, stable, and scalable framework that contains more flexibility and new engineering features for your Android app developer.

Android app developers can now directly use Google’s Firebase Cloud Messaging (FCM) with this SDK.

Adding FCM to your Application

  1. Integrate latest Marketo Android SDK in Android App.  Steps are available at GitHub.

  2. Configure Firebase App on Firebase Console.

    1. Create/Add a Project on Firebase Console.

      1. In the Firebase console, select  Add Project.
      2. Select your GCM project from the list of existing Google Cloud projects, and select  Add Firebase.
      3. In the Firebase welcome screen, select  Add Firebase to your Android App.
      4. Provide your package name and SHA-1, and select  Add App. A new google-services.json file for your Firebase app is downloaded.
      5. Select  Continue  and follow the detailed instructions for adding the Google Services plugin in Android Studio.

    2. Navigate to Project Settings in Project Overview

      1. Click General tab. Download the google-services.json file.
      2. Click on Cloud Messaging tab. Copy Server Key & Sender ID. Provide these Server Key & Sender ID to Marketo.

    3. Configure FCM changes in Android App

      1. Switch to the Project view in Android Studio to see your project root directory

        1. Move the downloaded google-services.json file into your Android app module root directory

        2. In Project-level build.gradle add the following:

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

        3. In App-level build.gradle, add the following:

          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. Finally, click on Sync now in the bar that appears in the ID

    4. Edit your app’s manifest The FCM SDK automatically adds all required permissions and the required receiver functionality. Make sure to remove the following obsolete (and potentially harmful, as they may cause message duplication) elements from your app’s manifest:

      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>

FCM FAQ

Frequently asked questions regarding Firebase Cloud Messaging support.

Q: Where can I find instructions to update to the latest version of the MME SDK? Instructions can be found on the Marketo Developer Site HERE.

Q: Will updating to the latest version of the SDK require me to publish an updated version of my Android Application to my existing users? No.

Q: How does it impact the existing MME customers that have published Android Apps integrated with Marketo Android SDK? They can migrate an existing GCM client app on Android to Firebase Cloud Messaging (FCM) as follows:

  1. In the Firebase console, select Add Project.
  2. Select your GCM project from the list of existing Google Cloud projects, and select Add Firebase.
  3. In the Firebase welcome screen, select Add Firebase to your Android App.
  4. Provide your package name and SHA-1, and select Add App. A new google-services.json file for your
  5. Firebase app is downloaded.
  6. Select Continue and follow the detailed instructions for adding the Google Services plugin in Android Studio.

Q: Can we target the leads created using the old Marketo SDK which used GCM App ? Yes. All the leads created using Marketo SDK can be targeted for sending the push notifications.

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