> For the complete documentation index, see [llms.txt](https://one-admax-organization.gitbook.io/one-admax-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-admax-organization.gitbook.io/one-admax-sdk/05.-flutter-plugin-guide.md).

# 05. Flutter-Plugin Guide

## 개발 버전 <a href="#undefined" id="undefined"></a>

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Flutter</strong></td><td>3.29.0</td><td></td></tr><tr><td><strong>Java SDK (Java 11)</strong></td><td>ONE AdMax SDK v1.2.5</td><td></td></tr></tbody></table>

## APP key 발급 및 적용하기 <a href="#app-key" id="app-key"></a>

앱키를 발급 후 Flutter Android Module의 `AndroidManifest.xml`에 `<meta-data/>`를 설정합니다.&#x20;

```java
<manifest>
    ...
    <application>
        ...
        
        <meta-data android:name="com.oneadmax.global.appkey" android:value="your app key"/>
    </application>
</manifest>
```

## SDK Initialize

광고를 로드하기 전에 앱이 ONEAdMax를 초기화해야 합니다. \
`ONEAdMax.initialize()` 초기화는 최초 한 번만 수행해야 합니다.

```java
class _OneAdDemo extends ConsumerState<HomeDetailScreen> {

  @override
  Widget build(BuildContext context) {
    ONEAdMax.initialize((bool isSuccess) {});
  }
}
```

## 어플리케이션 종료 <a href="#undefined-1" id="undefined-1"></a>

애플리케이션이 종료될 때 메모리에 할당된 리소스( View, Memory )를 해제합니다.

```java
ONEAdMax.dispose();
```

## 로그 설정 <a href="#undefined-2" id="undefined-2"></a>

개발을 위해 ONEAdMax의 자세한 로그를 노출할 수 있습니다. (기본값: false)

```java
ONEAdMax.setLogEnable(true);
```

## GDPR 설정 <a href="#gdpr" id="gdpr"></a>

EU의 GDPR (General Data protection Regulation) 법안에 대응하기 위해 아래 API를 추가합니다. GDPR 동의가 필요한 유저에 한해 아래 API를 호출하시기를 바랍니다. (기본값: true)

```java
ONEAdMax.gdprConsentAvailable(true);
```

## COPPA 설정 <a href="#coppa" id="coppa"></a>

COPPA(Children's Online Privacy Protection Rule)법안에 대응하기 위해 아래 API를 추가합니다. 해당 디바이스에서는 모든 광고 타입의 광고 요청에 대해 No ad 처리됩니다. (기본값: false)

```java
ONEAdMax.tagForChildDirectedTreatment(false)
```

## 광고 형식 선택하기 <a href="#undefined-3" id="undefined-3"></a>

### Reward Video ADs

보상을 제공하는 비디오 광고입니다.\
비디오 광고 종료 시 Complete event callback으로 광고 참여 완료 정보를 전달합니다.

{% content-ref url="/pages/z0CkuVWZ7wgVGwjivoc0" %}
[5-1. 보상형 비디오 광고 for Flutter](/one-admax-sdk/05.-flutter-plugin-guide/5-1.-for-flutter.md)
{% endcontent-ref %}

### Interstitial ADs

&#x20;앱의 화면 전체를 덮는 광고입니다.\
완료되었거나 유저에 의해 중단 되었을 경우 앱의 화면으로 전환됩니다.

{% content-ref url="/pages/Z1qCcv2wrVaZUCUXLuDm" %}
[5-2. 전면 광고 for Flutter](/one-admax-sdk/05.-flutter-plugin-guide/interstitial.md)
{% endcontent-ref %}

### Banner ADs

앱의 일부를 차지하는 직사각형 광고를 표시합니다.\
위치를 설정하고 시간을 설정하여 자동으로 새로고침할 수 있습니다.

{% content-ref url="/pages/3fFmJwLtunHa9t6jTtb4" %}
[5-3. 배너 광고 구현하기](/one-admax-sdk/05.-flutter-plugin-guide/5-3..md)
{% endcontent-ref %}

### Interstitial Video ADs (Non Reward)

비디오 광고와 형태는 동일하지만 리워드가 제공되지 않는 광고 타입입니다.

{% content-ref url="/pages/VfwRQBnEnNiplxZGPsB7" %}
[5-4. 전면 비디오 광고 for Flutter (비보상형)](/one-admax-sdk/05.-flutter-plugin-guide/5-4.-for-flutter.md)
{% endcontent-ref %}