インストール

Marketo Mobile SDK のインストール手順。 プッシュ通知やアプリ内メッセージを送信するには、次の手順が必要です。

iOSへのMarketo SDK のインストール

前提条件

  1. Marketo管理者でアプリケーションを追加(アプリケーションの秘密鍵と Munchkin ID を取得)
  2. プッシュ通知の設定(オプション)

CocoaPods を介したフレームワークのインストール

  1. CocoaPods をインストールします。$ sudo gem install cocoapods
  2. ディレクトリをプロジェクトディレクトリに変更し、スマートデフォルトを使用してプロファイルを作成します。$ pod init
  3. Podfile を開きます。$ open -a Xcode Podfile
  4. Podfile に次の行を追加します。$ pod 'Marketo-iOS-SDK'
  5. Podfile を保存して閉じます。
  6. Marketo iOS SDK をダウンロードしてインストールします。$ pod install
  7. Xcode でワークスペースを開きます。$ open App.xcworkspace

Swift パッケージマネージャーを使用したフレームワークのインストール

  1. プロジェクトナビゲーターからプロジェクトを選択し、「パッケージの依存関係を追加」の下で「+」をクリックします(下図を参照)。

    依存関係の追加

  2. このリポジトリからMarketo パッケージを追加します。 このリポジトリの URL を追加します:https://github.com/Marketo/ios-sdk。

    リポジトリ URL

  3. 次に示すように、リソースバンドルを追加します。プロジェクトナビゲーターで MarketoFramework.XCframework を見つけて、Finder で開きます。 MKTResources.bundle をドラッグ&ドロップして、バンドルリソースをコピーします。

Swift ブリッジング ヘッダーの設定

  1. ファイル/新規/ファイルに移動し、「ヘッダーファイル」を選択します。

    「ヘッダーファイル」を選択する

  2. ファイルに「<ProjectName>-Bridging-Header」という名前を付けます。

  3. プロジェクト / Target / ビルドフェーズ / Swift コンパイラー/ コード生成に移動します。 Objective-Bridging ヘッダーに次のパスを追加します。

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

    ビルドフェーズ

SDK の初期化

Marketo iOS SDK を使用する前に、Munchkin アカウント ID とアプリ秘密鍵を使用して初期化する必要があります。 これらはそれぞれ、「モバイルアプリとデバイス」の下の「Marketo管理者」領域にあります。

  1. AppDelegate.m ファイル (Objective-C)または Bridging ファイル (Swift)を開き、Marketo.h ヘッダーファイルを読み込みます。

    code language-none
    #import <MarketoFramework/MarketoFramework.h>
    
  2. 次のコードを application:didFinishLaunchingWithOptions:関数内に貼り付けます。

    なお、「native」をネイティブアプリのフレームワークタイプとして渡す必要があります。

目標 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. 「Munchkin アカウント ID」と「秘密鍵」を使用して、上記 munkinAccountIdsecretKey を置き換えます。これらはMarketo 管理者/モバイルアプリとデバイス セクションにあります。

iOS テストデバイス

  1. Project/Target/情報/URL タイプを選択します。
  2. 識別子の追加:$
  3. URL スキームの設定:mkto-<Secret Key_>
  4. applicationsourceApplication を AppDelegate.m ファイルに含める(Objective-C)

AppDelegate でのカスタム Url タイプの処理

目標 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)
    }

AndroidにMarketo SDK をインストールする方法

前提条件

  1. Marketo管理者でアプリケーションを追加(アプリケーションの秘密鍵と Munchkin ID を取得)
  2. プッシュ通知の設定(オプション)
  3. Android用Marketo SDK のダウンロード

Gradle を使用したAndroid SDK のセットアップ

1. アプリケーションレベルの build.gradle ファイルの依存関係セクションの下で、次を追加します。

implementation 'com.marketo:MarketoSDK:0.8.9'

  1. ルートの build.gradle ファイルには、

    code language-none
    buildscript {
        repositories {
            google()
            mavenCentral()
        }
    
  2. プロジェクトと Gradle ファイルの同期

権限の設定

AndroidManifest.xml を開いて、次の権限を追加します。 アプリは、「インターネット」および「ACCESS_NETWORK_STATE」権限をリクエストする必要があります。 アプリがこれらの権限を既にリクエストしている場合は、この手順をスキップします。

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

SDK の初期化

  1. アプリで Application クラスまたは Activity クラスを開き、Marketo SDK をアクティビティに読み込んでから、setContentView または Application Context に設定します。

    code language-java
    // Initialize Marketo
    Marketo marketoSdk = Marketo.getInstance(getApplicationContext());
    marketoSdk.initializeSDK("native","munchkinAccountId","secretKey");
    
  2. ProGuard 構成(オプション)

    アプリに ProGuard を使用している場合は、proguard.cfg ファイルに次の行を追加します。 ファイルは、プロジェクト フォルダ内にあります。 このコードを追加すると、Marketo SDK が不明化プロセスから除外されます。

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

Android テストデバイス

アプリケーションタグ内のファイルに「MarketoActivity」 AndroidManifest.xml 追加します。

<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 サポート

Android用 MME Software Development Kit (SDK)が、より柔軟で安定した、拡張性の高いフレームワークに更新されました。このフレームワークには、Android アプリ開発者向けの新しいエンジニアリング機能が備わっています。

Android アプリ開発者は、この SDK でGoogleFirebase Cloud Messaging (FCM)を直接使用できるようになりました。

アプリケーションへの FCM の追加

  1. Android アプリに最新のMarketo Android SDK を統合します。  手順は、GitHub で確認できます。

  2. Firebase コンソールで Firebase アプリを設定します。

    1. でのプロジェクトの作成/追加 🔗Firebase コンソール。

      1. Firebase コンソールで、「Add Project」を選択します。
      2. 既存のGoogle Cloud プロジェクトのリストから GCM プロジェクトを選択し、「Add Firebase」を選択します。
      3. Firebase のスタートアップスクリーンで、「Add Firebase to your Android App」を選択します。
      4. パッケージ名と SHA-1 を指定し、「Add App」を選択します。 新品 google-services.json firebase アプリのファイルがダウンロードされます。
      5. Continue を選択し、Android Studio にGoogle Services プラグインを追加するための詳細な手順に従います。
    2. プロジェクトの概要の「プロジェクト設定」に移動する

      1. 「一般」タブをクリックします。 「google-services.json」ファイルをダウンロードします。
      2. 「Cloud Messaging」タブをクリックします。 「サーバーキー」と「送信者 ID」をコピーします。 これらの「サーバーキー」と「送信者 ID」をMarketoに指定します。
    3. Android アプリでの FCM の変更

      1. Android Studio のプロジェクトビューに切り替えて、プロジェクトのルートディレクトリを表示します

        1. ダウンロードした「google-services.json」ファイルをAndroid アプリモジュールのルートディレクトリに移動します

        2. プロジェクトレベルの build.gradle で、以下を追加します。

          code language-none
          buildscript {
            dependencies {
              classpath 'com.google.gms:google-services:4.0.0'
            }
          }
          
        3. App-level build.gradle で、以下を追加します。

          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. 最後に、ID に表示されるバーの「Sync now」をクリックします

    4. アプリのマニフェストの編集 FCM SDK は、必要なすべての権限と必要なレシーバー機能を自動的に追加します。 次の古い(有害な可能性がある)要素は、アプリのマニフェストから削除してください。

      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