Integração de Reward e Interstitial
Requisitos
- ter um Telegram mini app
- saber onde exibir o anúncio, caso contrário, veja Exemplos de integração de anúncios
- ter
blockId, caso contrário, veja a seção Obter blockId
Instalação
Você tem duas opções para integrar o SDK do AdsGram.
Inserir script
Coloque o script sad.min.js na tag <head> usando este código:
<script src="https://sad.adsgram.ai/js/sad.min.js"></script>Instalar via npm para React e Vue.
Mais informações sobre a integração a partir de pacotes veja na documentação para React e Vue.
npm install @adsgram/reactnpm install @adsgram/vueInicializar o SDK do AdsGram
const AdController = window.Adsgram.init({ blockId: "your-block-id" });IMPORTANTE
A inicialização é necessária apenas para os formatos Rewarded e Interstitial. Para o formato Task, não é necessária inicialização.
Para exemplos de integração do formato Task, veja Integração de Task.
Mais informações sobre a função init você pode encontrar na seção Referência de API.
your-block-id — você obtém da sua conta em https://partner.adsgram.ai
Instrução detalhada sobre como obter o blockId você pode encontrar na seção Obter blockId
Exibir banner
- Formato Rewarded, o que significa que você deve dar ao usuário uma recompensa quando ele vir o anúncio até o final.
Mais informações sobre requisitos para exibição de anúncio. - Formato Interstitial, o que significa que o usuário pode pular um anúncio antes do final.
Mais informações sobre requisitos para exibição de anúncio.
Informação:
Abaixo estão exemplos de código para o formato Rewarded. Estes exemplos também são relevantes para o formato Interstitial. A única diferença é que a promessa AdController.show() é resolvida para anúncios que foram vistos até o final, assim como os que foram fechados. Um exemplo simples você pode encontrar aqui
Na maioria dos casos, o código abaixo é usado dentro do manipulador de cliques.
Para exemplos de código com vanilla js, React, Unity verifique a seção de exemplos de código.
AdController.show().then((result) => {
// o usuário vê o anúncio até o final ou o fecha no formato interstitial
// seu código para recompensar o usuário no formato rewarded
}).catch((result) => {
// o usuário obtém um erro durante a reprodução do anúncio
// não fazer nada ou o que quiser
})AdController.show().then((result: ShowPromiseResult) => {
// o usuário vê o anúncio até o final ou o fecha no formato interstitial
// seu código para recompensar o usuário no formato rewarded
}).catch((result: ShowPromiseResult) => {
// o usuário obtém um erro durante a reprodução do anúncio ou pula o anúncio
// não fazer nada ou o que quiser
})result tem os seguintes tipos:
interface ShowPromiseResult {
done: boolean; // true se o usuário vê até o final ou o fecha no formato interstitial, caso contrário false
description: string; // descrição do evento
state: 'load' | 'render' | 'playing' | 'destroy'; // estado do banner
error: boolean; // true se o evento foi emitido devido a um erro, caso contrário false
}Informação:
showPromise é resolvida se o usuário vir o anúncio até o final ou o fechar no formato interstitial, caso contrário é rejeitada.
Dica:
Encadeie a promessa com finally se você precisar adicionar alguma ação adicional após o anúncio terminar de reproduzir, ser pulado ou obter um erro.
Parabéns, você acabou de exibir seu primeiro anúncio usando o AdsGram!
Mais informações
- Exemplos de integração de código para React, Unity, vanilla js
- Se você tiver problemas com a integração verifique a seção Solução de problemas
- Referência avançada da API do AdController você pode encontrar na seção Referência de API
- Se você usa Typescript verifique a seção Typescript