Testamos juntos usando o catálogo de sandbox antes de emitir uma chave de produção. O que precisa passar:
| Verificação | Esperado |
|---|---|
| Intenção | Consulta comercial ("melhor mochila para notebook barata") → card. Consulta informativa ("como funcionam os transformers") → ad: null, chat inalterado. |
| Renderização | Card e rótulo "Sponsored" aparecem; imagens carregam (CSP img-src OK); layout responsivo em mobile e desktop. |
| Clique | /c/{token} retorna 302 para o link de rastreamento; uma conversão de teste é atribuída ao seu ID de publisher. |
| Geo | Valores diferentes de geo → inventário diferente (por exemplo, MY vs BR). |
| Resiliência | 429 e um timeout forçado → a resposta do assistente ainda é exibida, sem card, sem erro para o usuário. |
| Logging | Você registra o nosso request_id a cada chamada para que incidentes possam ser rastreados. |
Da sua parte durante os testes: acesso ao staging para nós, registro do request_id, alguém que possa ajustar o código do cliente no mesmo dia.
Entrada em produção: após os testes passarem, emitimos a chave de produção + URL e combinamos o throughput por chave com base no volume informado por você. Você troca a chave/URL nos segredos e faz o release. Monitore os primeiros dias: percentual de turnos com card, CTR, quantidade de 429 — fazemos o mesmo do nosso lado.
Problemas comuns: imagens em branco → CSP img-src; o card nunca aparece → verifique se o geo está sendo enviado e se a chave é a de sandbox; o link do card abre o seu domínio → você está envolvendo o click_url; o chat trava em erros → falta fail-soft/timeout.
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo