내가 만든 앱과 웹,
다른 메이커의 화면에서도 소개하세요

웹사이트

카드를 보여줄 곳에 붙여 넣으세요. 등록한 도메인(과 하위 도메인)에서만 카드가 보이고 소개가 인정돼요. 운영자 승인 전에는 보이지 않으니 코드는 미리 넣어 두셔도 돼요.

<div data-bokki-x data-slot="자리ID"></div>
<script src="https://bokki.dev/ads/loader.js" defer></script>

React·Vue 같은 SPA 에서 화면을 바꾼 뒤 새 자리를 채우려면 window.BokkiAds && window.BokkiAds.render() 를 불러 주세요. 카드가 안 보이면 브라우저 개발자 도구 콘솔에서 [BOKKi Shoutout] 메시지로 이유를 볼 수 있어요. CSP 를 쓰는 사이트는 script-src·connect-src 에 https://bokki.dev, img-src 에 https: 를 허용해 주세요.

안드로이드 (Kotlin · Java)

외부 라이브러리 없이 동작하는 가벼운 SDK예요(kotlin-stdlib 만 함께). Android 5.0 이상. 자리에 등록한 패키지 이름과 앱의 applicationId 가 같아야 카드가 나와요 — 디버그 빌드에 applicationIdSuffix 가 붙으면 안 나오니 주의하세요(Logcat 의 BokkiShoutout 에서 이유 확인). 어린이 대상 앱에는 넣을 수 없어요. 앱을 Play에 올릴 때는 Play Console "데이터 보안"에 이 SDK가 처리하는 정보(카드 노출·클릭 기록, 접속 IP로 만든 일방향 값)를 함께 신고해 주세요.

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://bokki.dev/maven")   // Groovy: maven { url "https://bokki.dev/maven" }
    }
}

// app/build.gradle(.kts)
dependencies {
    implementation("dev.bokki:exchange:1.0.0")
}

<!-- 레이아웃 맨 위 태그에 xmlns:app="http://schemas.android.com/apk/res-auto" -->
<dev.bokki.exchange.BokkiExchangeView
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:bokkiSlot="자리ID" />

// Jetpack Compose
AndroidView(factory = { BokkiExchangeView(it).apply { slotId = "자리ID" } })

Flutter (Android · iOS)

pub.dev 에 공개된 bokki_exchange 패키지예요. 소개 1회를 그대로 1회로 계산해요. Flutter 3.16 이상. 자리에 등록한 패키지 이름(iOS 는 Bundle ID)과 앱이 같아야 카드가 나와요 — Android 와 iOS 의 ID 가 다르면 자리를 따로 만들어 주세요. 카드가 안 보이면 디버그 콘솔의 [BOKKi Shoutout] 메시지에서 이유를 볼 수 있어요.

# 터미널
flutter pub add bokki_exchange

# 또는 pubspec.yaml
dependencies:
  bokki_exchange: ^1.0.0

import 'package:bokki_exchange/bokki_exchange.dart';

BokkiExchangeView(slotId: '자리ID')

그 밖의 앱 (웹뷰)

앱 안 웹뷰로 아래 주소를 열어 주세요. 높이는 카드형 약 180px, 띠형 약 100px. 소개 1회를 0.5회로 계산해요. 웹뷰는 JavaScript 를 켜고, 카드를 눌러 bokki.dev 밖으로 가는 이동(스토어·웹)은 앱 밖 브라우저로 넘겨 주세요. 그래야 작은 웹뷰 안에서 스토어가 열리지 않아요.

https://bokki.dev/x/embed?slot=자리ID

// iOS (WKNavigationDelegate)
func webView(_ w: WKWebView, decidePolicyFor a: WKNavigationAction,
             decisionHandler: @escaping (WKNavigationActionPolicy) -> Void) {
    if let url = a.request.url, !(url.host == "bokki.dev" && url.path.hasPrefix("/x/")) {
        UIApplication.shared.open(url); decisionHandler(.cancel); return
    }
    decisionHandler(.allow)
}

// Android (WebView)
webView.settings.javaScriptEnabled = true
webView.settings.domStorageEnabled = true
webView.webViewClient = object : WebViewClient() {
    override fun shouldOverrideUrlLoading(v: WebView, r: WebResourceRequest): Boolean {
        if (r.url.host == "bokki.dev" && r.url.path?.startsWith("/x/") == true) return false
        v.context.startActivity(Intent(Intent.ACTION_VIEW, r.url)); return true
    }
}