Skip to main content
A biblioteca Kotlin do Topsort permite que nossos clientes enviem facilmente solicitações de leilão e rastreiem eventos dentro de aplicações Android.
Requisitos mínimos: Java 11, Kotlin 2.1, minSdk 24 e compileSdk 36.

Instalação

Adicione a dependência ao seu arquivo build.gradle:

Configuração

Kotlin

UserIdentity.of converte um id nulo ou vazio em UserIdentity.Unidentified; nesse caso, o SDK gera um id e o mantém entre as execuções do aplicativo. Passe seu próprio id sempre que tiver um, com ou sem login.

Java

Reportando Eventos

Renders

Um render registra que um anúncio patrocinado foi inserido na página, separadamente da impressão, que registra quando o anúncio se torna visível. Os renders são exclusivos de anúncios patrocinados, portanto não existe uma variante orgânica.
Para reportar vários renders em um único evento, crie-os com Render.Factory e passe-os para Analytics.reportRenders(list). Render.Factory.build não tem valores padrão para resolvedBidId, placement, occurredAt (um timestamp RFC 3339), opaqueUserId e id, portanto passe-os para cada render, com um id único.

Impressões

Uma impressão registra que um anúncio ou produto ficou visível para o comprador.
Para resultados orgânicos, use Analytics.reportImpressionOrganic com entity = Entity(id = "<product id>", type = EntityType.PRODUCT) em vez de resolvedBidId. Importe Entity e EntityType de com.topsort.analytics.model: o callback de clique do banner usa um EntityType diferente.

Cliques

Um clique registra que o comprador clicou em um anúncio ou produto.
Para resultados orgânicos, use Analytics.reportClickOrganic com uma entity, assim como nas impressões.

Compras

Uma compra registra os produtos que o comprador adquiriu. O Topsort a atribui aos anúncios com os quais o comprador interagiu.

Banners

Adicione BannerView ao XML da sua atividade:
Configure na sua atividade:
O BannerView reporta o render assim que o vencedor é exibido, a impressão quando o banner aparece na tela e o clique quando ele é tocado. Não reporte esses eventos por conta própria para os banners que ele exibe. Para documentação completa, consulte o repositório GitHub.