설명서Marketo 개발자 안내서

설치

Last update: Thu May 30 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자

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

iOS에 Marketo SDK 설치

필요 조건

  1. Marketo Admin에서 애플리케이션 추가 (애플리케이션 암호 키 및 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 패키지를 추가합니다. 이 저장소용 URL https://github.com/Marketo/ios-sdk을 추가합니다.

    저장소 URL

  3. 리소스 번들을 추가합니다(그림: Locate). MarketoFramework.XCframework project navigator에서 를 열고 Finder에서 엽니다. 드래그 앤 드롭 MKTResources.bundle 을 클릭하여 번들 리소스를 복사합니다.

Swift 브리징 헤더 설정

  1. 파일 > 새로 만들기 > 파일로 이동하고 "헤더 파일"을 선택합니다.

    헤더 파일 선택

  2. 파일 이름을 "<프로젝트 이름>-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. 바꾸기 munkinAccountId 및 secretKey 위에서 Marketo에 있는 "Munchkin 계정 ID" 및 "비밀 키"를 사용하여 Admin > Mobile Apps and Devices 섹션.

iOS 테스트 장치

  1. [프로젝트] > [Target] > [정보] > [URL 유형]을 선택합니다.
  2. 식별자 추가: $
  3. URL 체계 설정: mkto-<Secret Key_>
  4. 애플리케이션 포함sourceApplication to 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 Admin에서 애플리케이션 추가 (애플리케이션 암호 키 및 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를 활동으로 가져옵니다.

    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 application 태그 내에 있는 파일입니다.

<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 앱 개발자가 Google Firebase 클라우드 메시징 (FCM) 이 SDK를 사용합니다.

애플리케이션에 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 서비스 플러그인을 추가하는 방법에 대한 자세한 지침을 따르십시오.

    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