# 플로팅 배너

플로팅 배너란 [<mark style="color:orange;">\[Client Admin\]</mark>](https://client-admin.bleepy.io/) 에서 프로모션 등록 시 설정할 수 있는 UI 배너 옵션입니다.\
플로팅 배너 링크는 App 기반 서비스, Web 기반 서비스에 따라 차이가 있습니다.

***

## App 기반 서비스

자사 서비스가 App(Native) 기반의 서비스라면 플로팅 배너 링크 설정 시 딥링크 형태로 입력이 되어야 합니다.\
자세한 설명은 아래 메뉴를 참고하시면 도움이 됩니다.

{% content-ref url="/pages/IXd1lwW6AFFfZjBRTBEG" %}
[사전 확인사항](/bleepy-developers/game-promotion/pre-check.md)
{% endcontent-ref %}

<table><thead><tr><th width="184">Type</th><th width="148">Required</th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:orange;"><code>scheme</code></mark></td><td>required</td><td>App에서 사용할 스키마</td></tr><tr><td><mark style="color:orange;"><code>host</code></mark></td><td>required</td><td>플로팅 배너 클릭 시 전환될 화면</td></tr><tr><td><mark style="color:orange;"><code>parameters</code></mark></td><td>optional</td><td>화면 전환 시 필요한 선택적 파라미터</td></tr></tbody></table>

* 딥링크 작성 예시

```
// 기본 구조
{scheme}://{host}?{parameters}

// 예시
bleepy://banner?bannerText=test
```

## Web 기반 서비스

자사 서비스가 Web 기반의 서비스라면 플로팅 배너 링크 설정 시 <mark style="color:blue;">`http`</mark> 또는 <mark style="color:blue;">`https`</mark> 프로토콜 기반의 자사 서비스 도메인 주소를 입력해주세요.

***

App/Web 서비스 모두 플로팅 배너의 사용여부가 <mark style="color:blue;">`ON`</mark> 인 경우 런처에서는 다음과 같은 처리가 이뤄집니다.

* 인앱 게임 내 플로팅 배너가 표시됩니다.
* 플로팅 배너 클릭 시 수행되는 동작
  * 인사이트 내 배너 노출현황 메뉴에 일자별, 배너별 데이터를 집계
  * 딥링크 호출 > 클라이언트의 앱 구동 및 화면 전환을 처리

{% hint style="info" %}
개발에 대한 추가 설명이 더 필요하신가요?

"[<mark style="color:orange;">\[Client Admin\]</mark>](https://client-admin.bleepy.io/login) 로그인 → 오른쪽 하단 채널톡 위젯" 클릭 후 개발 카테고리에 문의 남겨주시면 기술 개발팀에서 확인 후 연락드리겠습니다.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bleepy.gitbook.io/bleepy-developers/game-promotion/addon/floating-banner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
