Ionic

Marketo Cordova プラグインをIonic アプリと統合します。Ionic Capacitorは現在サポートされていません。

前提条件

  1. Marketo Adminでアプリケーションを追加し、アプリケーションの秘密鍵とMunchkin IDを取得します。
  2. AndroidまたはiOSのプッシュ通知を設定します。
  3. IonicとCordova CLIをインストールします。

インストール手順

Marketo Ionic プラグインの設定

  1. Ionic アプリケーションディレクトリに移動し、次のコマンドを実行してMarketo プラグインを追加します。

    $ ionic plugin add https://github.com/Marketo/PhoneGapPlugin.git --variable APPLICATION_SECRET_KEY="YOUR_APPLICATION_SECRET"

  2. 次のコマンドを実行して、プラグインが追加されたことを確認します。

    $ ionic plugin list com.marketo.plugin 0.X.0 "MarketoPlugin"

新しいバージョンへの移行(オプション)

  1. 既存のプラグインを削除するには、次のコマンドを実行します。

    $ ionic plugin remove com.marketo.plugin

  2. プラグインを再度追加するには、次のコマンドを実行します。

    $ ionic plugin add https://github.com/Marketo/PhoneGapPlugin.git --variable APPLICATION_SECRET_KEY="YOUR_APPLICATION_SECRET"

xCode でプッシュ通知を有効にする

  1. xCode プロジェクトのプッシュ通知機能をオンにします。 通知機能

プッシュ通知のトラッキング

次のコードをに貼り付けます。 application:didFinishLaunchingWithOptions: 関数。

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

[sharedInstance trackPushNotification:launchOptions];
Swift
code language-swift
let sharedInstance: Marketo = Marketo.sharedInstance()

sharedInstance.trackPushNotfication(launchOptions)

Marketo フレームワークの初期化

アプリの起動時にMarketo フレームワークを初期化するには、メインのJavaScript ファイルのonDeviceReady関数に次のコードを追加します。

ionicCordovaをIonic個のCordova アプリのフレームワークタイプとして渡します。

構文

// This method will Initialize the Marketo Framework using Your MunchkinId and Secret Key
marketo.initialize(
  function() { console.log("MarketoSDK Init done."); },
  function(error) { console.log("an error occurred:" + error); },
  'YOUR_MUNCHKIN_ID',
  'YOUR_SECRET_KEY',
  'FRAMEWORK_TYPE'
);

// For session tracking, add following.
marketo.onStart(
  function(){ console.log("onStart."); },
  function(error){ console.log("Failed to report onStart." + error); }
);

パラメーター

  • Success Callback: Marketo フレームワークが正常に初期化された場合に実行する関数。
  • Failure Callback: Marketo フレームワークが初期化に失敗した場合に実行する関数。
  • MUNCHKIN ID:登録時にMarketoから受信したMunchkin ID。
  • 秘密鍵:登録時にMarketoから秘密鍵を受信しました。

Marketo プッシュ通知の初期化

Marketo プッシュ通知を初期化するには、メインのJavaScript ファイルのinitialize関数の後に次のコードを追加します。

構文

// This function will Enable user notifications (prompts the user to accept push notifications in iOS)
marketo.initializeMarketoPush(
    function() { console.log("Marketo push successfully initialized."); },
    function(error) { console.log("an error occurred:" + error); },
    'YOUR_GCM_PROJECT_ID' // This is required for Android and will be ignored in iOS
);

パラメーター

  • Success Callback: Marketo プッシュ通知が正常に初期化された場合に実行する関数。
  • Failure Callback: Marketo プッシュ通知が初期化に失敗した場合に実行する関数。
  • GCM_PROJECT_ID: アプリの作成後、Google Developers ConsoleにGCM プロジェクト IDが見つかりました。

ログアウト時にトークンを登録解除することもできます。

marketo.uninitializeMarketoPush(
  function() { console.log("Marketo push successfully uninitialized."); } ,
  function(error) { console.log("an error occurred:" + error); }
);

リードの関連付け

associateLead関数を呼び出して、Marketo リードを作成します。

構文

marketo.associateLead(
  function(){ console.log("MarketoSDK : Lead Added"); },
  function(error){ console.log("an error occurred:" + error); },
  'Lead_Data_JSON_String'
);

パラメーター

  • Success Callback: Marketo フレームワークがリードを正常に関連付ける場合に実行する関数。
  • 失敗コールバック:Marketo フレームワークがリードの関連付けに失敗した場合に実行する関数。
  • リードデータ:JSON文字列形式のリードデータ。

例

// First create a lead as shown below
var lead = {};
lead[marketo.KEY_FIRST_NAME] = "Ionic";
lead[marketo.KEY_LAST_NAME] = "App";
lead[marketo.KEY_EMAIL] = email;
lead[marketo.KEY_ADDRESS] = "demo address";
lead[marketo.KEY_CITY] = "city";
lead[marketo.KEY_STATE] = "state";
lead[marketo.KEY_COUNTRY] = "country";
lead[marketo.KEY_POSTAL_CODE] = "postalCode";
lead[marketo.KEY_GENDER] = "gender";

// Use associateLead function to associate it.
marketo.associateLead(
  function() { console.log("MarketoSDK : Lead Associated"); },
  function(error) { console.log("an error occurred:" + error); },
  JSON.stringify(lead)
);

報告書アクション

reportaction関数を呼び出して、ユーザーアクションを報告します。

構文

marketo.reportaction(
  function(){ console.log("MarketoSDK : New event sent "); },
  function(error){ console.log("an error occurred:" + error); },
  'Action_Name',
  'Action_Data_JSON_String'
);

パラメーター

  • Success Callback: Marketo フレームワークがアクションを正常に報告した場合に実行する関数。
  • Failure Callback: Marketo フレームワークがアクションのレポートに失敗した場合に実行する関数。
  • アクション名:アクション名。
  • アクションデータ:JSON文字列形式のアクションデータ。

例

// First create an event as below
var event = {
    "Action Type":"Add To Cart",
    "Action Details":"Adding Product in cart",
    "Action Metric":"10",
    "Action Length":"1"
}

marketo.reportaction(
    function(){ console.log("Reported action successfully."); },
    function(error){ console.log("Failed to report action." + error); },
    "Add To Cart",
    JSON.stringify(event)
);

セッションレポート

「一時停止」および「再開」イベントタイプをバインドして、開始イベントと停止イベントを報告します。 これらのイベントは、モバイルアプリケーションで費やした時間を追跡し、Androidで必要です。

//Add the following code in your www/js/index.js

bindEvents: function() {
   document.addEventListener('pause', this.onStop, false);
   document.addEventListener('resume', this.onStart, false);
},
onStop: function() {
   marketo.onStop(
       function(){ console.log("onStop"); },
       function(error){ console.log("Failed to report onStop." + error); }
   );
},
onStart: function() {
   marketo.onStart(
       function(){ console.log("onStart."); },
       function(error){console.log( "Failed to report onStart." + error); }
   );
},

リードの作成

ハイブリッドアプリからリードを作成する方法は 3 つあります。

  1. MARKETO MME SDK
  2. MARKETO REST API
  3. フォーム送信

新しいリードを識別するトリガーとフィルターは、作成方法によって異なります。

  • MME SDKまたはREST APIで作成されたリードは、「作成されたリード」トリガーおよびフィルターに表示されます。
  • フォーム送信によって作成されたリードは、「フォームに入力」トリガーとフィルターに表示されます。

ハイブリッドアプリとweb アプリでも、同様のリード作成方法を使用できます。 Web アプリでフォーム送信またはREST APIを使用する場合は、ハイブリッドアプリでそのメソッドを使用します。 Web アプリでどちらのメソッドも使用しない場合は、MME SDKを使用してMarketoでリードを作成することを検討してください。

recommendation-more-help
marketo-developer-help