---
title: "Panduan Integrasi Reward dan Interstitial"
description: "Cara mengintegrasikan iklan Reward dan Interstitial AdsGram: instalasi SDK, inisialisasi, menampilkan banner, dan menangani promise respons."
---

# Integrasi Reward dan Interstitial

## Persyaratan
- memiliki [Telegram mini app](https://core.telegram.org/bots/webapps)
- mengetahui tempat menampilkan iklan, jika belum, lihat [Contoh integrasi iklan](./reward-examples)
- memiliki `blockId`, jika belum, lihat [Bagian mendapatkan blockId](./get-block-id)

## Instalasi
Anda memiliki dua opsi untuk mengintegrasikan AdsGram SDK.

#### Menyisipkan skrip
Tempatkan skrip `sad.min.js` di dalam tag `<head>` menggunakan kode ini:
```html
<script src="https://sad.adsgram.ai/js/sad.min.js"></script>
```

#### Instalasi melalui npm untuk React dan Vue.
Informasi lebih lanjut tentang integrasi dari paket dapat dilihat dalam dokumentasi untuk [React](https://www.npmjs.com/package/@adsgram/react#hook) dan [Vue](https://www.npmjs.com/package/@adsgram/vue#composition-api).

::: code-group
```bash [React]
npm install @adsgram/react
```
```bash [Vue]
npm install @adsgram/vue
```
:::

## Inisialisasi AdsGram SDK
```js
const AdController = window.Adsgram.init({ blockId: "your-block-id" });
```
> [!IMPORTANT] PENTING
> Inisialisasi hanya diperlukan untuk format Reward dan Interstitial. Untuk format `Task`, inisialisasi tidak diperlukan.\
> Untuk contoh integrasi format `Task`, lihat [Integrasi Task](./task-integration-example).

Informasi lebih lanjut tentang fungsi `init` dapat Anda temukan di [Bagian Referensi API](./api-reference#init).

`your-block-id` — Anda dapatkan dari akun Anda di https://partner.adsgram.ai\
Instruksi lengkap tentang cara mendapatkan blockId dapat Anda temukan di [Bagian mendapatkan blockId](./get-block-id)
## Menampilkan Banner
- Format **Rewarded**, yang berarti Anda harus memberikan hadiah kepada pengguna setelah menonton iklan hingga selesai.\
Informasi lebih lanjut tentang [persyaratan menampilkan iklan](./reward-examples#persyaratan-menampilkan-iklan).
- Format **Interstitial**, yang berarti pengguna dapat melewatkan iklan sebelum selesai.\
Informasi lebih lanjut tentang [persyaratan menampilkan iklan](./interstitial-examples#persyaratan-menampilkan-iklan).

::: info INFO
Di bawah ini adalah contoh kode untuk format Rewarded. Contoh-contoh ini juga relevan untuk format Interstitial. Satu-satunya perbedaan adalah bahwa promise AdController.show() diselesaikan untuk iklan yang telah ditonton hingga selesai, serta yang telah ditutup. Lihat [contoh kode Interstitial sederhana](./interstitial-examples#contoh-kode-sederhana).
:::

Dalam kebanyakan kasus, kode di bawah ini digunakan di dalam event handler klik.\
Untuk contoh kode dengan vanilla js, React, Unity, lihat [Bagian contoh kode](./reward-interstitial-code-examples).
::: code-group
```js [javascript]
AdController.show().then((result) => {
    // pengguna menonton iklan hingga selesai atau menutupnya dalam format interstitial
    // kode Anda untuk memberikan hadiah kepada pengguna dalam format rewarded
}).catch((result) => {
    // pengguna mendapatkan error saat memutar iklan
    // tidak melakukan apa-apa atau sesuaikan keinginan Anda
})
```
```ts [typescript]
AdController.show().then((result: ShowPromiseResult) => {
    // pengguna menonton iklan hingga selesai atau menutupnya dalam format interstitial
    // kode Anda untuk memberikan hadiah kepada pengguna dalam format rewarded
}).catch((result: ShowPromiseResult) => {
    // pengguna mendapatkan error saat memutar iklan atau melewatkan iklan
    // tidak melakukan apa-apa atau sesuaikan keinginan Anda
})
```
:::
`result` memiliki tipe sebagai berikut:
```ts
interface ShowPromiseResult {
    done: boolean; // true jika pengguna menonton hingga selesai atau menutupnya dalam format interstitial, jika tidak false
    description: string; // deskripsi event
    state: 'load' | 'render' | 'playing' | 'destroy'; // status banner
    error: boolean; // true jika event dipancarkan karena error, jika tidak false
}
```
::: info INFO
`showPromise` menjadi resolved jika pengguna menonton iklan hingga selesai atau menutupnya dalam format interstitial, jika tidak rejected.
:::
::: tip TIPS
Rantai promise dengan `finally` jika Anda perlu menambahkan tindakan tambahan setelah iklan selesai diputar, dilewati, atau mendapatkan error.
:::

**Selamat, Anda baru saja menampilkan iklan pertama Anda menggunakan AdsGram!**

## Informasi Lebih Lanjut
* [Contoh integrasi kode](./reward-interstitial-code-examples) untuk React, Unity, vanilla js
* Jika Anda mengalami masalah dengan integrasi, lihat [Bagian troubleshooting](./troubleshooting)
* Referensi API AdController lanjutan dapat Anda temukan di [Bagian Referensi API](./api-reference)
* Jika Anda menggunakan Typescript, lihat [Bagian Typescript](./typescript)
