> For the complete documentation index, see [llms.txt](https://adpopcornssp.gitbook.io/offerwall/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://adpopcornssp.gitbook.io/offerwall/advertiser/campaign/timefit-landing.md).

# 타임핏 랜딩형 연동

광고주가 운영하는 웹페이지에 사용자가 접속했을 때, 지정한 조건에 따라 체류 시간을 측정하고 조건이 충족되면 자동으로 리워드를 지급하는 광고 상품의 연동 방법을 안내해요.

> 캠페인 운영 전 담당 사업실(<reward@adpopcorn.com>)을 통해 협의 후 적용돼요.

***

### 전체 흐름 <a href="#full-flow" id="full-flow"></a>

<table><thead><tr><th width="128">단계</th><th>내용</th><th>소요 시간</th></tr></thead><tbody><tr><td>Step 1</td><td>스크립트 삽입 (필수)</td><td>약 5분</td></tr><tr><td>Step 2</td><td>고급 활용 설정 (선택)</td><td>약 5분</td></tr></tbody></table>

***

### Step 1. 스크립트 삽입 (필수) <a href="#step1" id="step1"></a>

이벤트 페이지 로딩 완료 후 아래 스크립트를 삽입하고 `AdPopcornTimer.Run()`을 호출하여 타이머 카운트를 시작해 주세요.

```html
<script src="https://webapi.adpopcorn.com/offerwall/postback/adpopcorn-timefit.min.js"></script>
<script>
    AdPopcornTimer.run();
</script>
```

#### 타이머 설정 옵션

<table><thead><tr><th width="150">항목</th><th>설명</th></tr></thead><tbody><tr><td>타이머 시작 방식</td><td>1) 페이지 진입 시 즉시 실행 또는 2) 사용자 스크롤 이후 실행 (협의)</td></tr><tr><td>텍스트</td><td>광고주 요청에 따라 변경 가능</td></tr><tr><td>카운트 시간</td><td>10초 / 20초 / 30초 등 광고주 요청에 따라 조정 가능</td></tr></tbody></table>

***

### Step 2. 고급 활용 설정 (선택) <a href="#step2" id="step2"></a>

#### 타이머 완료 시 특정 동작 실행 (콜백 함수)

사용자에게 안내 메시지를 띄우는 등 특정 동작을 실행하고 싶은 경우 활용할 수 있어요.

```html
<script>
  function callback() {
    // 원하는 동작 설정
  }

  AdPopcornTimer.run(callback);
</script>
```

#### 페이지 이탈 시 리워드 지급 여부 확인

페이지에서 벗어나는 순간 리워드 조건 달성 여부를 확인하려면 아래 함수를 사용해 주세요. 반환값은 `boolean` 타입이며, 조건 충족 실패 시 `false` 를 반환해요.

```javascript
AdPopcornTimer.isFinished();
```

> 사용자가 보상을 받지 않고 이탈할 경우 알림 처리 등에 사용할 수 있어요.

***

### 연동 시 주의사항 <a href="#notes" id="notes"></a>

<table><thead><tr><th width="140">항목</th><th>내용</th></tr></thead><tbody><tr><td>실행 시점</td><td><code>AdPopcornTimer.run()</code>은 반드시 <strong>페이지 로딩 완료 이후</strong>에 실행해야 해요.</td></tr><tr><td>중복 호출</td><td>동일 페이지 내에서 r<code>un()</code>을 중복 호출하지 않도록 주의해 주세요.</td></tr><tr><td>리워드 조건</td><td>광고주와 사전에 협의된 조건(트리거 및 카운트 시간)을 기준으로 동작해요.</td></tr></tbody></table>

***

### 문의 <a href="#support" id="support"></a>

* 연동 문의: <reward@adpopcorn.com>