DocumentatieMarketo Handleiding voor ontwikkelaars

Installatie

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

Gemaakt voor:

  • Admin

Installatie-instructies voor de Marketo Mobile SDK. De onderstaande stappen zijn vereist voor het verzenden van pushberichten en/of In-App-berichten.

Marketo SDK installeren op iOS

Vereisten

  1. Een toepassing toevoegen in Marketo Admin (verkrijg uw toepassing Geheime Sleutel en identiteitskaart Munchkin)
  2. Pushmeldingen instellen (optioneel)

Framework installeren via CocoaPods

  1. CocoaPods installeren. $ sudo gem install cocoapods
  2. Wijzig de map in de projectmap en maak een podbestand met de standaardwaarden. $ pod init
  3. Open het podbestand. $ open -a Xcode Podfile
  4. Voeg de volgende regel toe aan het podbestand. $ pod 'Marketo-iOS-SDK'
  5. Sla het bestand op en sluit het.
  6. Download en installeer Marketo iOS SDK. $ pod install
  7. De werkruimte openen in Xcode. $ open App.xcworkspace

Framework installeren met Swift Package Manager

  1. Selecteer uw project van de Navigator van het Project en onder "voeg de Afhankelijkheid van het Pakket"toe, klik '+' zoals hieronder getoond:

    Afhankelijkheid toevoegen

  2. Voeg Marketo-pakket van deze repo toe. Voeg deze URL voor deze gegevensopslagruimte toe: https://github.com/Marketo/ios-sdk.

    Repo-URL

  3. Voeg nu de bundel van het Middel toe zoals getoond: Bepaal MarketoFramework.XCframework in projectnavigator en open het in Vinder. Slepen en slepen MKTResources.bundle om bundelbronnen te kopiëren.

Snelle overbruggingsheader instellen

  1. Ga naar Bestand > Nieuw > Bestand en selecteer Koptekstbestand.

    Koptekstbestand selecteren

  2. Geef het bestand de naam "<ProjectName>-Bridging-header".

  3. Ga naar Project > Doel > de Fasen van de Bouwstijl > de Verschuivende Compiler > de Generatie van de Code. Voeg het volgende pad toe aan Objectoverbruggingskoptekst:

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

    Fasen samenstellen

SDK initialiseren

Voordat u de SDK van Marketo iOS kunt gebruiken, moet u deze initialiseren met uw Munchkin-account-id en toepassingsbeveiligingssleutel. U vindt deze allemaal in het gebied Marketo Admin onder "Mobiele apps en apparaten".

  1. Open uw bestand AppDelegate.m (doelstelling-C) of Bridging (SWIFT) en importeer het headerbestand Marketo.h.

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

  2. Plak de volgende code in de application:didFinishLaunchingWithOptions: functie.

    Merk op dat wij "inheems"als kadertype voor Inheemse Apps moeten overgaan.

Doelstelling 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. Vervangen munkinAccountId en secretKey hierboven gebruikt u de ''Munchkin-account-id'' en ''Geheime sleutel'' in de Marketo Admin > Mobile Apps and Devices sectie.

iOS-testapparaten

  1. Selecteer Project > Doel > Info > URL-typen.
  2. Id toevoegen: $
  3. URL-schema's instellen: mkto-<Secret Key_>
  4. Inclusief toepassingsourceApplication naar bestand AppDelegate.m (doelstelling-C)

Type aangepaste URL afhandelen in AppDelegate

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

Marketo SDK installeren op Android

Vereisten

  1. Een toepassing toevoegen in Marketo Admin (verkrijg uw toepassing Geheime Sleutel en identiteitskaart Munchkin)
  2. Pushmeldingen instellen (optioneel)
  3. Marketo SDK voor Android downloaden

Instellen van Android SDK met verloopgebied

1. Voeg onder de sectie Afhankelijkheden in het bestand build.gradle op toepassingsniveau toe

implementation 'com.marketo:MarketoSDK:0.8.9'

  1. De basis build.gradle bestand moet

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

  2. Uw project synchroniseren met verloopbestanden

Machtigingen configureren

Openen AndroidManifest.xml en voeg de volgende machtigingen toe. Uw app moet om de toestemmingen "INTERNET"en "ACCESS_NETWORK_STATE"verzoeken. Als uw toepassing al om deze machtigingen vraagt, slaat u deze stap over.

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

SDK initialiseren

  1. Open de klasse Application of Activity in uw app en importeer de SDK van Marketo in uw Activiteit vóór setContentView of in Application Context.

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

  2. ProGuard-configuratie (optioneel)

    Als u ProGuard gebruikt voor uw app, voegt u de volgende regels toe in uw proguard.cfg bestand. Het bestand bevindt zich in uw projectmap. Als u deze code toevoegt, wordt de Marketo SDK uitgesloten van het verduisteringsproces.

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

Android-testapparaten

"MarketoActivity" toevoegen aan AndroidManifest.xml bestand in toepassingstag.

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

Ondersteuning voor Firebase Cloud Messaging

De MME Software Development Kit (SDK) voor Android is bijgewerkt naar een modern, stabieler en schaalbaar framework dat meer flexibiliteit en nieuwe technische functies voor uw ontwikkelaar van Android-apps bevat.

Ontwikkelaars van Android-apps kunnen nu direct Google gebruiken Firebase Cloud Messaging (FCM) met deze SDK.

FCM toevoegen aan uw toepassing

  1. De nieuwste Marketo Android-SDK integreren in Android App.  Stappen zijn beschikbaar op GitHub.

  2. Firebase-app configureren op Firebase-console.

    1. Een project maken/toevoegen op 🔗Firebase Console.

      1. In de Firebase-console, selecteert u Add Project.
      2. Selecteer uw GCM-project in de lijst met bestaande Google Cloud-projecten en selecteer Add Firebase.
      3. Selecteer in het welkomstscherm van Firebase de optie Add Firebase to your Android App.
      4. Geef uw pakketnaam en SHA-1 op en selecteer Add App. Een nieuwe google-services.json bestand voor uw Firebase-app wordt gedownload.
      5. Selecteren Continue en volg de gedetailleerde instructies voor het toevoegen van de Google Services-plug-in in Android Studio.

    2. Navigeer naar 'Projectinstellingen' in projectoverzicht

      1. Klik op het tabblad Algemeen. Download het bestand 'google-services.json'.
      2. Klik op het tabblad Cloud Messaging. Kopieer 'Server-sleutel' en 'Afzender-id'. Geef deze 'Server Key' en 'Sender ID' op aan Marketo.

    3. FCM-wijzigingen configureren in Android-app

      1. Schakel naar de projectweergave in Android Studio om de hoofdmap van uw project te bekijken

        1. Verplaats het gedownloade bestand 'google-services.json' naar de hoofdmap van de Android-toepassingsmodule

        2. Voeg het volgende toe in build.gradle op projectniveau:

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

        3. Voeg het volgende toe in build.gradle op toepassingsniveau:

          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. Klik ten slotte op "Nu synchroniseren" in de balk die wordt weergegeven in de id

    4. Bewerk manifest van uw app De FCM SDK voegt automatisch alle vereiste machtigingen en de vereiste ontvangerfunctionaliteit toe. Zorg ervoor dat u de volgende verouderde (en mogelijk schadelijke) elementen uit het manifest van uw app verwijdert:

      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