설치
Marketo Mobile SDK에 대한 설치 지침 아래 단계는 푸시 알림 및/또는 인앱 메시지를 보내는 데 필요합니다.
iOS에 Marketo SDK 설치
필요 조건
- Marketo Admin에서 애플리케이션 추가 (애플리케이션 암호 키 및 Munchkin Id 얻기)
- 푸시 알림 설정 (선택 사항)
CocoaPod를 통해 프레임워크 설치
- CocoaPod를 설치합니다.
$ sudo gem install cocoapods
- 디렉터리를 프로젝트 디렉터리로 변경하고 스마트 기본값으로 Podfile을 만듭니다.
$ pod init
- Podfile을 엽니다.
$ open -a Xcode Podfile
- Podfile에 다음 줄을 추가합니다.
$ pod 'Marketo-iOS-SDK'
- Podfile을 저장하고 닫습니다.
- Marketo iOS SDK를 다운로드하여 설치합니다.
$ pod install
- Xcode에서 작업 영역을 엽니다.
$ open App.xcworkspace
Swift 패키지 관리자를 사용하여 프레임워크 설치
-
Project Navigator에서 프로젝트를 선택하고 "패키지 종속성 추가"에서 아래와 같이 '+'를 클릭합니다.
-
이 보고서에서 Marketo 패키지를 추가합니다. 이 저장소용 URL https://github.com/Marketo/ios-sdk을 추가합니다.
-
리소스 번들을 추가합니다(그림: Locate).
MarketoFramework.XCframework
project navigator에서 를 열고 Finder에서 엽니다. 드래그 앤 드롭MKTResources.bundle
을 클릭하여 번들 리소스를 복사합니다.
Swift 브리징 헤더 설정
-
파일 > 새로 만들기 > 파일로 이동하고 "헤더 파일"을 선택합니다.
-
파일 이름을 "<프로젝트 이름>-Bridging-Header".
-
프로젝트 > Target > 빌드 단계 > Swift 컴파일러 > 코드 생성으로 이동합니다. Objective-Bridging 헤더에 다음 경로를 추가합니다.
$(PODS_ROOT)/<_ProjectName_>-Bridging-Header.h
SDK 초기화
Marketo iOS SDK를 사용하려면 먼저 Munchkin 계정 ID 및 앱 비밀 키로 초기화해야 합니다. Marketo 관리 영역에서 "모바일 앱 및 장치" 아래에 있는 각 앱을 찾을 수 있습니다.
-
AppDelegate.m 파일(Objective-C) 또는 브리징 파일(Swift)을 열고 Marketo.h 헤더 파일을 가져옵니다.
code language-none #import <MarketoFramework/MarketoFramework.h>
-
다음 코드를 내부에 붙여넣기
application:didFinishLaunchingWithOptions
: 함수.네이티브 앱에 대한 프레임워크 유형으로 "native"를 전달해야 합니다.
code language-none |
---|
|
code language-none |
---|
|
- 바꾸기
munkinAccountId
및secretKey
위에서 Marketo에 있는 "Munchkin 계정 ID" 및 "비밀 키"를 사용하여 Admin > Mobile Apps and Devices 섹션.
iOS 테스트 장치
- [프로젝트] > [Target] > [정보] > [URL 유형]을 선택합니다.
- 식별자 추가: $
- URL 체계 설정:
mkto-<Secret Key_>
- 애플리케이션 포함sourceApplication to AppDelegate.m 파일 (Objective-C)
AppDelegate에서 사용자 지정 Url 유형 처리
code language-none |
---|
|
code language-none |
---|
|
Android에서 Marketo SDK를 설치하는 방법
필요 조건
- Marketo Admin에서 애플리케이션 추가 (애플리케이션 암호 키 및 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 클래스를 열고 setContentView나 Application Context에서 Marketo SDK를 활동으로 가져옵니다.
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
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 추가
-
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 서비스 플러그인을 추가하는 방법에 대한 자세한 지침을 따르십시오.
- 다음에서 Firebase 콘솔, 선택
-
프로젝트 개요에서 '프로젝트 설정'으로 이동
- '일반' 탭을 클릭합니다. "google-services.json" 파일을 다운로드합니다.
- '클라우드 메시징' 탭을 클릭합니다. '서버 키' 및 '보낸 사람 ID'를 복사합니다. Marketo에 이러한 '서버 키' 및 '보낸 사람 ID'를 제공하십시오.
-
Android 앱에서 FCM 변경 사항 구성
-
Android Studio의 프로젝트 보기로 전환하여 프로젝트 루트 디렉터리를 확인합니다.
-
다운로드한 'google-services.json' 파일을 Android 앱 모듈 루트 디렉토리로 이동합니다
-
프로젝트 수준 build.gradle에서 다음을 추가합니다.
code language-none buildscript { dependencies { classpath 'com.google.gms:google-services:4.0.0' } }
-
앱 수준 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에 나타나는 막대에서 "지금 동기화"를 클릭합니다
-
-
-
앱의 매니페스트 편집 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>
-