adPluga

Developers

Integre em 2 minutos. Funciona.

Uma tag e um espaço — ou a API, se quiser controlo total. Docs claras, exemplos prontos, test mode e referência gerada do OpenAPI.

Uma linha no , 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 React
<!-- 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

    Componente '<PlugaSlot>' do pacote @adpluga/react.

  • iframe / GTM

    CSP restrito ou via Google Tag Manager.

  • API direta

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

Abrir integraçãoVer status da API

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/ad-campaignsLista campanhas do cliente
POST/v1/ad-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).

Abrir referência completa