Service

회원을 모으면서, 수익까지 생기는 세계 유일의 앱플랫폼

SDK 설치
요구사항

- API 19: Android 4.4(KitKat) 이상

- Java 8 이상

어플리케이션 생성

1. MyPage(관리콘솔)에 로그인 합니다.

2. [모든앱] 에서 어플리케이션을 등록 합니다.

3. [모든앱] 에서 등록한 어플리케이션을 선택 합니다.

4. [설정] - [기본 설정] 에서 클라이언트 키어플 키를 확인 합니다.

SDK 설치

1. Gradle 설정하기

[build.gradle(Project:)]

멀티앱크로스의 SDK는 https://repo.multiappcross.kr/repository/maven/ 저장소에 배포 됩니다.

maven { url "https://repo.multiappcross.kr/repository/maven/" }

2. Dependencies 설정하기

[build.gradle(Module:)]

멀티앱크로스의 SDK에 대한 의존성을 설정 합니다.

implementation 'mc.kr.cross.sdk:sdk:0.1.1'

3. Manifest 퍼미션

인터넷 사용 권한 설정하기

서버와 통신하기 위해 앱에 인터넷 사용 권한이 필요 합니다. AndroidManifest.xml에 다음과 같이 인터넷 사용 권한을 설정합니다.

<uses-permission android:name="android.permission.INTERNET"/>

4. 코드삽입 예시 코드 입니다. 각 앱의 상황에 맞게 설정하세요.

프로젝트 MainActivity의 onCreate 메서드에 삽입

SDK 사용을 위해 가장 먼저 초기화가 이루어 져야 합니다.

import mc.kr.cross.sdk.CrossSdk; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); CrossSdk.INSTANCE.init(this, "{클라이언트 키}", "{어플 키}"); } }
import mc.kr.cross.sdk.CrossSdk class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) CrossSdk.init(this, "{클라이언트 키}", "{어플 키}") } }

 

팝업 오픈 코드 삽입

원하는 위치에 팝업 오픈 코드를 삽입 합니다.

정상적인 크로스 진행 중 일경우 상대방의 광고용 이미지가 랜덤하게 노출 됩니다.

import mc.kr.cross.sdk.CrossSdk; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { ... CrossSdk.INSTANCE.openPopup(this); ... } }
import mc.kr.cross.sdk.CrossSdk class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { ... CrossSdk.openPopup(this) ... } }

 

팝업 종료 코드 삽입

팝업을 종료하여야 하는 위치에 삽입니다.

ex) onPause(), onDestroy(), onStop()

import mc.kr.cross.sdk.CrossSdk; public class MainActivity extends AppCompatActivity { @Override protected void onPause(Bundle savedInstanceState) { ... CrossSdk.INSTANCE.closePopup(); ... } }
import mc.kr.cross.sdk.CrossSdk class MainActivity : AppCompatActivity() { override fun onPause(savedInstanceState: Bundle?) { ... CrossSdk.closePopup() ... } }

 

회원 가입 완료 코드 삽입

회원 가입 완료시 해당 코드 삽입으로 가입이 완료 되었음을 전달합니다

※ 다운로드형일 경우 해당 코드는 삽입 하지 않습니다.

import mc.kr.cross.sdk.CrossSdk; public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { ... CrossSdk.INSTANCE.join({가입 아이디}); ... or ... if(CrossSdk.INSTANCE.isViaMultiAppCross()){ // 멀티앱크로스를 통한 가입여부 확인 CrossSdk.INSTANCE.join({가입 아이디}); } ... } }
import mc.kr.cross.sdk.CrossSdk class MainActivity : AppCompatActivity() { override fun onCreate(savedInstanceState: Bundle?) { ... CrossSdk.join({가입 아이디}) ... or ... if(CrossSdk.isViaMultiAppCross()){ // 멀티앱크로스를 통한 가입여부 확인 CrossSdk.join({가입 아이디}); } ... } }
사용된 Dependencies

멀티앱크로스의 SDK는 아래 버전의 의존성이 포함 되었습니다.

 

- com.android.installreferrer:installreferrer:2.2

- com.squareup.retrofit2:retrofit:2.9.0

- com.squareup.retrofit2:converter-gson:2.9.0

- com.google.android.gms:play-services-ads-identifier:17.0.0

- org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.9

- com.github.bumptech.glide:glide:4.12.0

 

어플리케이션 생성

1. MyPage(관리콘솔)에 로그인 합니다.

2. [모든앱] 에서 어플리케이션을 등록 합니다.

3. [모든앱] 에서 등록한 어플리케이션을 선택 합니다.

4. [설정] - [기본 설정] 에서 클라이언트 키어플 키를 확인 합니다.

SDK 설치

1. SDK 삽입

[CDN] 이용시

아래의 JavaScript SDK를 웹 페이지에 삽입 합니다.

<script src="https://cdn.multiappcross.kr/sdk/js/multi.min.js"> </script>

[NPM] 이용시

아래의 명령어로 SDK를 설치 합니다.

npm i cross-sdk-web

SDK를 불러 옵니다.

import * as CrossSdk from 'cross-sdk-web';

2. 초기화

SDK 사용을 위해 가장 먼저 초기화가 이루어 져야 합니다.

CrossSdk.init("{클라이언트 키}", "{어플 키}")

3. 팝업 오픈

[팝업은 모달 형태로 오픈 됩니다]

원하는 페이지에 팝업 오픈 코드를 삽입 합니다.

정상적인 크로스 진행 중 일경우 상대방의 광고용 이미지가 랜덤하게 노출 됩니다.

옵션이 지정되지 않을 경우 화면 중앙에 모달 형태로 보여지게 됩니다.

CrossSdk.openModal({options});

[예제]

<div id="mc_web_modal_container"> <div id="mc_web_modal_banner"> </div> </div> <script src="https://cdn.multiappcross.kr/sdk/js/multi.min.js"> </script> <script> CrossSdk.openModal({ width: 400, // positionX: 300, // positionY: 200, // closeBtn: false, // modal: false, // clickRefresh: true, // clickClose: true }); </script>

[모달 옵션]

옵션명 형식 설명
width
필수 입력!
number 모달창의 가로 너비를 설정 합니다.
positionX number 모달창의 X 위치를 설정 합니다.
positionY number 모달창의 Y 위치를 설정 합니다.
closeBtn boolean 모달창 우측 상단에 닫기 버튼의 표시 여부를 설정 합니다.
modal boolean 모달 여부를 설정 합니다.
clickRefresh boolean 클릭 후 새로운 광고 이미지 전환 여부를 설정 합니다.
clickClose boolean 클릭 후 해당 모달 창의 닫힘 여부를 설정 합니다.

4. 가입 완료

회원 가입 완료시 해당 코드 삽입으로 가입이 완료 되었음을 전달합니다

CrossSdk.join("{가입 아이디}");

예제파일 다운로드
SDK 설치문의

SDK설치에 문제가 있으신 회원사는 고객센터 기술파트로 문의(sdk@mc7network.com)하시면 설치를 도와드립니다.