インストール
Marketo Mobile SDK のインストール手順。 プッシュ通知やアプリ内メッセージを送信するには、次の手順が必要です。
iOSへのMarketo SDK のインストール
前提条件
- Marketo管理者でアプリケーションを追加(アプリケーションの秘密鍵と Munchkin ID を取得)
- プッシュ通知の設定(オプション)
CocoaPods を介したフレームワークのインストール
- CocoaPods をインストールします。
$ sudo gem install cocoapods
- ディレクトリをプロジェクトディレクトリに変更し、スマートデフォルトを使用してプロファイルを作成します。
$ pod init
- Podfile を開きます。
$ open -a Xcode Podfile
- Podfile に次の行を追加します。
$ pod 'Marketo-iOS-SDK'
- Podfile を保存して閉じます。
- Marketo iOS SDK をダウンロードしてインストールします。
$ pod install
- Xcode でワークスペースを開きます。
$ open App.xcworkspace
Swift パッケージマネージャーを使用したフレームワークのインストール
-
プロジェクトナビゲーターからプロジェクトを選択し、「パッケージの依存関係を追加」の下で「+」をクリックします(下図を参照)。
-
このリポジトリからMarketo パッケージを追加します。 このリポジトリの URL を追加します:https://github.com/Marketo/ios-sdk。
-
次に示すように、リソースバンドルを追加します。プロジェクトナビゲーターで
MarketoFramework.XCframework
を見つけて、Finder で開きます。MKTResources.bundle
をドラッグ&ドロップして、バンドルリソースをコピーします。
Swift ブリッジング ヘッダーの設定
-
ファイル/新規/ファイルに移動し、「ヘッダーファイル」を選択します。
-
ファイルに「<ProjectName>-Bridging-Header」という名前を付けます。
-
プロジェクト / Target / ビルドフェーズ / Swift コンパイラー/ コード生成に移動します。 Objective-Bridging ヘッダーに次のパスを追加します。
$(PODS_ROOT)/<_ProjectName_>-Bridging-Header.h
SDK の初期化
Marketo iOS SDK を使用する前に、Munchkin アカウント ID とアプリ秘密鍵を使用して初期化する必要があります。 これらはそれぞれ、「モバイルアプリとデバイス」の下の「Marketo管理者」領域にあります。
-
AppDelegate.m ファイル (Objective-C)または Bridging ファイル (Swift)を開き、Marketo.h ヘッダーファイルを読み込みます。
code language-none #import <MarketoFramework/MarketoFramework.h>
-
次のコードを
application:didFinishLaunchingWithOptions
:関数内に貼り付けます。なお、「native」をネイティブアプリのフレームワークタイプとして渡す必要があります。
code language-none |
---|
|
code language-none |
---|
|
- 「Munchkin アカウント ID」と「秘密鍵」を使用して、上記
munkinAccountId
とsecretKey
を置き換えます。これらはMarketo 管理者/モバイルアプリとデバイス セクションにあります。
iOS テストデバイス
- Project/Target/情報/URL タイプを選択します。
- 識別子の追加:$
- URL スキームの設定:
mkto-<Secret Key_>
- applicationsourceApplication を AppDelegate.m ファイルに含める(Objective-C)
AppDelegate でのカスタム Url タイプの処理
code language-none |
---|
|
code language-none |
---|
|
AndroidにMarketo SDK をインストールする方法
前提条件
- Marketo管理者でアプリケーションを追加(アプリケーションの秘密鍵と Munchkin ID を取得)
- プッシュ通知の設定(オプション)
- Android用Marketo SDK のダウンロード
Gradle を使用したAndroid SDK のセットアップ
1. アプリケーションレベルの build.gradle ファイルの依存関係セクションの下で、次を追加します。
implementation 'com.marketo:MarketoSDK:0.8.9'
-
ルートの
build.gradle
ファイルには、code language-none buildscript { repositories { google() mavenCentral() }
-
プロジェクトと 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 の初期化
-
アプリで Application クラスまたは Activity クラスを開き、Marketo SDK をアクティビティに読み込んでから、setContentView または Application Context に設定します。
code language-java // Initialize Marketo Marketo marketoSdk = Marketo.getInstance(getApplicationContext()); marketoSdk.initializeSDK("native","munchkinAccountId","secretKey");
-
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 の追加
-
Android アプリに最新のMarketo Android SDK を統合します。 手順は、GitHub で確認できます。
-
Firebase コンソールで Firebase アプリを設定します。
-
でのプロジェクトの作成/追加 🔗Firebase コンソール。
- Firebase コンソールで、「
Add Project
」を選択します。 - 既存のGoogle Cloud プロジェクトのリストから GCM プロジェクトを選択し、「
Add Firebase
」を選択します。 - Firebase のスタートアップスクリーンで、「
Add Firebase to your Android App
」を選択します。 - パッケージ名と SHA-1 を指定し、「
Add App
」を選択します。 新品google-services.json
firebase アプリのファイルがダウンロードされます。 Continue
を選択し、Android Studio にGoogle Services プラグインを追加するための詳細な手順に従います。
- Firebase コンソールで、「
-
プロジェクトの概要の「プロジェクト設定」に移動する
- 「一般」タブをクリックします。 「google-services.json」ファイルをダウンロードします。
- 「Cloud Messaging」タブをクリックします。 「サーバーキー」と「送信者 ID」をコピーします。 これらの「サーバーキー」と「送信者 ID」をMarketoに指定します。
-
Android アプリでの FCM の変更
-
Android Studio のプロジェクトビューに切り替えて、プロジェクトのルートディレクトリを表示します
-
ダウンロードした「google-services.json」ファイルをAndroid アプリモジュールのルートディレクトリに移動します
-
プロジェクトレベルの build.gradle で、以下を追加します。
code language-none buildscript { dependencies { classpath 'com.google.gms:google-services:4.0.0' } }
-
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'
-
最後に、ID に表示されるバーの「Sync now」をクリックします
-
-
-
アプリのマニフェストの編集 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>
-