설명서Marketo 개발자 안내서

설치

Last update: Tue Aug 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자

Marketo Mobile SDK 설치 지침 아래 단계는 푸시 알림 및/또는 인앱 메시지를 보내는 데 필요합니다.

iOS에 Marketo SDK 설치

사전 요구 사항

  1. Marketo 관리자에서 응용 프로그램을 추가​(응용 프로그램 비밀 키 및 Munchkin ID 얻기)
  2. 푸시 알림 설정(선택 사항)

CocoaPod를 통해 프레임워크 설치

  1. CocoaPod를 설치합니다. $ sudo gem install cocoapods
  2. 디렉터리를 프로젝트 디렉터리로 변경하고 스마트 기본값으로 Podfile을 만듭니다. $ 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. Project Navigator에서 프로젝트를 선택하고 "패키지 종속성 추가"에서 아래와 같이 '+'를 클릭합니다.

    종속성 추가

  2. 이 보고서에서 Marketo 패키지를 추가합니다. 이 저장소 https://github.com/Marketo/ios-sdk에 대한 URL을 추가하십시오.

    저장소 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) 또는 브리징 파일(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. Marketo munkinAccountId > secretKey 섹션에 있는 "Munchkin 계정 ID" 및 "비밀 키"를 사용하여 위의 Admin 및 Mobile Apps and Devices ​을(를) 바꾸십시오.

iOS 테스트 장치

  1. [프로젝트] > [Target] > [정보] > [URL 유형]을 선택합니다.
  2. 식별자 추가: $
  3. URL 체계 설정: mkto-<Secret Key_>
  4. AppDelegate.m 파일에 applicationsourceApplication 포함(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 클래스를 열고 setContentView나 Application Context에서 Marketo SDK을 Activity로 가져옵니다.

    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 테스트 장치

응용 프로그램 태그 내의 AndroidManifest.xml 파일에 "MarketoActivity"를 추가합니다.

<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 클라우드 메시징 지원

Android용 MME 소프트웨어 개발 키트(SDK)가 Android 앱 개발자를 위한 유연성과 새로운 엔지니어링 기능을 포함하는 보다 현대적이고 안정적이며 확장 가능한 프레임워크로 업데이트되었습니다.

이제 Android 앱 개발자는 이 SDK에서 Google의 Firebase 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을(를) 선택하십시오. Firebase 앱에 대한 새 google-services.json 파일이 다운로드되었습니다.
      5. Continue을(를) 선택하고 Android Studio에서 Google 서비스 플러그인을 추가하는 자세한 지침을 따릅니다.

    2. 프로젝트 개요에서 '프로젝트 설정'으로 이동

      1. '일반' 탭을 클릭합니다. "google-services.json" 파일을 다운로드합니다.
      2. '클라우드 메시징' 탭을 클릭합니다. '서버 키' 및 '보낸 사람 ID'를 복사합니다. Marketo에 이러한 '서버 키' 및 '보낸 사람 ID'를 제공하십시오.

    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. 앱 수준 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에 나타나는 막대에서 "지금 동기화"를 클릭합니다

    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