Integre a biblioteca Swift do Topsort para solicitações de leilão e rastreamento de eventos em aplicações móveis
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:
dependencies: [ .package(url: "https://github.com/Topsort/topsort.swift.git", from: "1.4.1"),],targets: [ .target( name: "YourApp", dependencies: [ .product(name: "Topsort", package: "topsort.swift"), .product(name: "TopsortBanners", package: "topsort.swift"), // Only if you display banners ] ),]
Configuração
import SwiftUIimport Topsort@mainstruct MyApp: App { init() { do { try Topsort.shared.configure(Configuration(apiKey: "your-api-key")) } catch { print("Topsort not configured: \(error.localizedDescription)") } } var body: some Scene { WindowGroup { ContentView() } }}
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.
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).
let render = RenderEvent(resolvedBidId: winner.resolvedBidId, occurredAt: Date.now)Topsort.shared.track(render: render)
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.
var body: some View { VStack { AsyncImage(url: self.product.imageURL) Text(self.product.name) } .onAppear { Topsort.shared.track(impression: Event(resolvedBidId: self.winner.resolvedBidId, occurredAt: Date.now)) }}
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.
var body: some View { VStack { AsyncImage(url: self.product.imageURL) Text(self.product.name) } .onTapGesture { Topsort.shared.track(click: Event(resolvedBidId: self.winner.resolvedBidId, occurredAt: Date.now)) }}
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.
Button("Purchase me!") { let item = PurchaseItem(productId: myProduct.id, unitPrice: myProduct.price) let event = PurchaseEvent(items: [item], occurredAt: Date.now) Topsort.shared.track(purchase: event)}
Exibindo Banners
import SwiftUIimport TopsortBannersstruct ContentView: View { var body: some View { TopsortBanner(bannerAuctionBuilder: .init(slotId: "slotId", deviceType: "device")) .contentMode(.fill) .onNoWinners({ }) .onError({ error in }) .onImageLoad({ }) .buttonClickedAction({ response in }) .frame(maxHeight: 50) .clipped() }}
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.
Esta página foi útil?
Assistant
Responses are generated using AI and may contain mistakes.