¿Necesitas ayuda con tu integración de Topsort?
Habla con nosotros, el equipo de ingeniería de integraciones.
Contáctanos a través de tu canal de mensajería dedicado o en{" "}
support@topsort.com.
Si aún no eres cliente,{" "}
agenda una demo con nuestro
equipo de ventas.
;
};
La [biblioteca Swift de Topsort](https://github.com/Topsort/topsort.swift) permite a nuestros clientes enviar fácilmente solicitudes de subastas y rastrear eventos dentro de aplicaciones iOS.
## Instalación
Instala usando package.swift:
```swift theme={null}
let package = Package(
dependencies: [
.package(url: "https://github.com/Topsort/topsort.swift.git", from: "1.0.0"),
]
)
```
## Configuración
```swift theme={null}
import SwiftUI
import Topsort
@main
struct MyApp: App {
init() {
Topsort.shared.configure(apiKey: "your-api-key", url: "https://api.topsort.com")
}
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
```
## Solicitando Subastas
```swift theme={null}
import Topsort
let products = AuctionProducts(ids: ["p_dsad", "p_dvra", "p_oplf"])
let category = AuctionCategory(id: "c_fdfa")
let auctions = [
Auction(type: "banners", slots: 1, slotId: "home-banner", device: "mobile", category: category),
Auction(type: "listings", slots: 2, device: "mobile", products: products)
]
let result: AuctionResponse = await Topsort.shared.executeAuctions(auctions: auctions)
```
## Reportando Eventos
### Impresiones y Clics
```swift theme={null}
var body: some View {
VStack {
AsyncImage(url: self.product.image_url)
Text(self.product.name)
}
.onAppear {
Topsort.shared.track(impression: self.event())
}
.onTapGesture {
Topsort.shared.track(click: self.event())
}
}
```
### Compras
```swift theme={null}
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)
}
```
## Mostrando Banners
```swift theme={null}
import TopsortBanners
struct 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()
}
}
```
Para la documentación completa, consulta el [repositorio de GitHub](https://github.com/Topsort/topsort.swift).
