Skip to main content
A biblioteca Swift do Topsort permite que nossos clientes enviem facilmente solicitações de leilão e rastreiem eventos dentro de aplicações iOS.
Requisitos mínimos: toolchain do Swift 6 (Xcode 16) e iOS 15.

Instalação

Instale usando package.swift:

Configuração

Chame Topsort.shared.set(opaqueUserId:) depois de configurar sempre que você tiver seu próprio id para o usuário, com ou sem login. Sem um id, o SDK gera um e o mantém entre as execuções do aplicativo.

Solicitando Leilões

Reportando Eventos

Renders

Um render registra que um anúncio patrocinado foi inserido na hierarquia de views, separadamente da impressão, que registra quando ele se torna visível. Reporte-o assim que o anúncio for colocado na tela, antes da impressão. Os renders são exclusivos de anúncios patrocinados, portanto resolvedBidId é obrigatório. winner é um dos vencedores na resposta do leilão (result.results[i].winners).
Topsort.shared envia apenas o primeiro render e a primeira impressão de cada resolvedBidId para um usuário e descarta qualquer repetição, portanto reportar a partir de onAppear é seguro quando uma view reaparece, por exemplo ao rolar uma lista lazy.

Impressões

Uma impressão registra que um anúncio ou produto ficou visível para o comprador.
Para resultados orgânicos, crie o evento com Event(entity: Entity(type: .product, id: product.id), occurredAt: Date.now).

Cliques

Um clique registra que o comprador clicou em um anúncio ou produto.
Os cliques orgânicos usam o mesmo inicializador Event(entity:occurredAt:) das 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.

Exibindo Banners

O TopsortBanner reporta o render quando o leilão retorna um vencedor, a impressão quando a imagem é carregada e o clique quando o banner é 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.