La biblioteca Kotlin de Topsort permite a nuestros clientes enviar fácilmente solicitudes de subastas y rastrear eventos dentro de aplicaciones Android.
Versión mínima de Java requerida: 17.
Instalación
Agrega la dependencia a tu archivo build.gradle:
dependencies {
implementation 'com.topsort:topsort-kt:2.0.0'
}
Configuración
Kotlin
import android.app.Application
import com.topsort.analytics.Analytics
class KotlinApplication : Application() {
override fun onCreate() {
super.onCreate()
Analytics.setup(
application = this,
opaqueUserId = "<YOUR_OPAQUE_USER_ID>",
token = "<API token>"
)
}
}
Java
import android.app.Application;
import com.topsort.analytics.Analytics;
public class JavaApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
Analytics.INSTANCE.setup(this, "<opaqueUserId>", "<API token>");
}
}
Reportando Eventos
Kotlin
// Purchase
fun reportPurchase() {
val item = PurchasedItem(
productId = "<Marketplace id for the item>",
unitPrice = 1295,
quantity = 20
)
Analytics.reportPurchase(
id = "<Marketplace id for the entire purchase>",
items = listOf(item),
)
}
// Click (promoted)
fun reportClickPromoted() {
val placement = Placement(path = "search_results", location = "position_1")
Analytics.reportClickPromoted(
id = "<Marketplace id for the item>",
resolvedBidId = "<The bid id from the auction winner>",
placement = placement
)
}
// Impression (promoted)
fun reportImpressionPromoted() {
val placement = Placement(path = "search_results", location = "position_1")
Analytics.reportImpressionPromoted(
id = "<Marketplace id for the item>",
resolvedBidId = "<The bid id from the auction winner>",
placement = placement
)
}
Anuncios de Banner
Agrega BannerView a tu XML de actividad:
<com.topsort.analytics.banners.BannerView
android:id="@+id/bannerView"
android:layout_width="353dp"
android:layout_height="103dp" />
Configura en tu actividad:
class SampleActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.sample_activity)
this.lifecycleScope.launch {
val bannerView = findViewById<BannerView>(R.id.bannerView)
val bannerConfig = BannerConfig.CategorySingle(slotId = "slot", category = "category")
bannerView.setup(
bannerConfig = bannerConfig,
screenName = "sample_activity",
onClick = { id, entityType -> onBannerClick(id, entityType) }
)
}
}
}
Para la documentación completa, consulta el repositorio de GitHub.
¿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.