adPluga

Developers

Integre em 5 minutos. Funciona.

Anúncios no seu site ou app com uma tag ou um SDK, ou pela API se quiser controlo total. Modo de teste, exemplos prontos e referência gerada do OpenAPI.

Uma linha no head, um placeholder

O tag.js descobre os slots, chama /serve, renderiza em iframe sandboxed (anti-XSS) e mede a impressão e o clique. Zero lógica de negócio no cliente.

Test modeOpenAPISDK Web
<!-- in <head> -->
<script async src="https://cdn.adpluga.com/v1/tag.js"
        data-adpluga-key="pk_test_•••"></script>

<!-- wherever the ad should render -->
<div data-adpluga-slot="slot_home_top"></div>

Vários caminhos, o mesmo /serve

  • Tag JS

    Para sites/e-commerce. Cola e funciona.

  • React / SPA

    Elemento adpluga-slot do pacote @adpluga/web, pronto para React.

  • iframe / GTM

    CSP restrito ou via Google Tag Manager.

  • API direta

    Server-to-server, email, AMP, app nativo.

Endpoints principais

MétodoEndpointDescrição
GET/v1/serveDecide e devolve um anúncio + token (nunca vazio)
POST/v1/trackRegista impressão/clique/conversão (assinado)
GET/v1/campaignsLista campanhas do cliente
POST/v1/campaignsCria campanha (orçamento, modelo, targeting)
GET/v1/reports/daily-statsMétricas fatiáveis para BI (suporta ?mode=live|test)
GET/v1/integration/statusEstado de integração do slot (live/test)
GET/v1/integration/eventsÚltimos eventos de integração (impressões/cliques/conversões)
POST/v1/integration/send-test-eventDispara evento sintético is_test=true para validar a integração
POST/v1/sdk-keys/{id}/rotateRoda a chave SDK (revoga a antiga, emite uma nova)

Referência completa gerada do openapi.yaml com try-it. Autenticação por chave publishable (cliente) e secret (servidor).