bokki_exchange #

BOKKi - Shoutout(서로소개) 위젯입니다. 내 앱에서 다른 메이커의 앱·웹 서비스를 소개하고, 그만큼 내 서비스도 다른 사이트·앱에서 소개받습니다.

설치 #

dependencies:
  bokki_exchange: ^1.0.0

또는 flutter pub add bokki_exchange

bokki.dev 대시보드 → Shoutout → 소개 자리 추가 (어디에 넣나요: 앱, 패키지 이름 = 이 앱의 applicationId / Bundle ID)
받은 자리 ID로 위젯을 넣습니다.

import 'package:bokki_exchange/bokki_exchange.dart';

BokkiExchangeView(slotId: '자리ID')

보여줄 카드가 없으면 아무것도 그리지 않습니다.
카드가 화면에 절반 이상 1초 보이고 앱이 앞에 있을 때 노출 1회로 셉니다.
패키지 이름이 자리에 등록한 것과 같아야 카드가 나오고 노출이 인정됩니다. iOS 는 Bundle ID 가 기준이라, Android 패키지와 다르면 iOS 용 자리를 따로 만듭니다.
자리는 운영자 승인 뒤에 카드가 나옵니다. 안 보이면 디버그 콘솔의 [BOKKi Shoutout] 메시지로 이유를 볼 수 있습니다.
카드를 숨기거나 자동으로 누르는 등 부정 노출은 크레딧 취소·이용 정지 대상입니다.

cd example
flutter run --dart-define=CARD=자리ID --dart-define=STRIP=자리ID

어린이 대상 앱에는 넣을 수 없습니다. (Google Play 가족 정책: 인증된 광고 SDK만 허용)
Play Console "광고 포함 = 예", App Store 개인정보 라벨 "제품 상호작용 · 광고 데이터 — 사용자와 연결 안 됨, 추적 안 함".
데이터 보안 신고: 카드 노출·클릭 기록과 앱 패키지 이름을 처리합니다. 광고 ID·기기 ID·위치는 수집하지 않으며, 접속 IP는 서버에서 날짜별 일방향 값으로만 바꿔 씁니다. 전송은 HTTPS 입니다.
카드의 "광고 · BOKKi Shoutout" 표시를 지우거나 가리지 마세요.

VisibilityDetector 가 타이머를 쓰므로 위젯 테스트에서는 다음을 먼저 실행해 주세요.

VisibilityDetectorController.instance.updateInterval = Duration.zero;