설명서Marketo 개발자 안내서

이온-

Last update: Fri Aug 01 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자

이 항목에서는 Marketo Cordova 플러그인을 통합하는 방법을 설명합니다. Ionic 커패시터는 현재 지원되지 않습니다.

사전 요구 사항

  1. Marketo 관리자에서 응용 프로그램을 추가​(응용 프로그램 비밀 키 및 Munchkin Id 얻기).
  2. 푸시 알림 설정(iOS | Android ).
  3. Ionic 및 Cordova CLI를 설치합니다.

설치 지침

Marketo Ionic 플러그 인 설정

  1. Cordova CLI가 설치되어 있다고 가정할 경우 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: 함수 내에 다음 코드를 붙여넣습니다.

목표 C
code language-none 
Marketo *sharedInstance = [Marketo sharedInstance];

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

sharedInstance.trackPushNotfication(launchOptions)

Marketo 프레임워크 초기화

앱 시작 시 Marketo 프레임워크가 시작되도록 하려면 기본 JavaScript 파일의 onDeviceReady 함수 아래에 다음 코드를 추가하십시오.

ionicCordova Cordova 앱에 대한 프레임워크 유형으로 Ionic을(를) 전달해야 합니다.

구문

// 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 : 등록 시 Munchkin ID가 Marketo에서 수신되었습니다.
  • 비밀 키 : 등록 시 Marketo에서 받은 비밀 키.

Marketo 푸시 알림 초기화

Marketo 푸시 알림이 시작되었는지 확인하려면 기본 JavaScript 파일에서 초기화된 함수 뒤에 다음 코드를 추가합니다.

구문

// 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 개발자 콘솔에서 GCM 프로젝트 ID를 찾았습니다.

로그아웃 시 토큰의 등록을 취소할 수도 있습니다.

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

리드 연결

associateLead 함수를 호출하여 Marketo Lead 를 생성할 수 있습니다.

구문

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

매개변수

  • Success Callback : Marketo 프레임워크가 리드를 성공적으로 연결하면 실행되는 함수입니다.
  • Failure Callback : 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'
);

매개변수

  • 성공 콜백 : Marketo 프레임워크가 작업을 성공적으로 보고하면 실행할 함수입니다.
  • 실패 콜백 : 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); }
   );
},

리드 생성

하이브리드 앱에서 리드를 만드는 방법에는 세 가지가 있습니다.

  1. MARKETO MME SDK
  2. MARKETO REST API
  3. 양식 제출

사용된 방법에 따라 새로 생성된 리드가 다른 트리거 및 필터에 의해 인식됩니다. MME SDK 또는 REST API를 사용하여 생성된 리드는 "생성된 리드" 트리거 및 필터에 표시됩니다. 양식 제출로 생성된 리드는 "양식 작성" 트리거 및 필터에 표시됩니다.

가장 좋은 방법은 리드를 만들 때 웹 앱에서 사용하는 방법과 일관되게 유지하는 것입니다. 양식 제출을 리드를 만드는 메커니즘으로 사용하는 웹 앱이 이미 있는 경우 하이브리드 앱에서 리드를 만들 때 동일한 메커니즘을 사용합니다. REST API를 리드 생성 메커니즘으로 사용하는 웹 앱이 이미 있는 경우 하이브리드 앱에서 리드를 생성할 때도 이와 동일한 메커니즘을 사용합니다. 양식 제출이나 REST API를 웹 앱에서 리드를 만드는 메커니즘으로 사용하지 않는 경우 MME SDK을 사용하여 Marketo에서 리드를 만드는 것을 고려할 수 있습니다.

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