Android

La biblioteca Kotlin de Topsort permite a nuestros clientes enviar fácilmente solicitudes de subastas y rastrear eventos dentro de aplicaciones Android.

Requisitos mínimos: Java 11, Kotlin 2.1, minSdk 24 y compileSdk 36.

Instalación

Agrega la dependencia a tu archivo build.gradle:

dependencies {
    implementation 'com.topsort:topsort-kt:4.1.0'
}

Configuración

Kotlin

import android.app.Application
import com.topsort.analytics.Analytics
import com.topsort.analytics.UserIdentity

class KotlinApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Analytics.setup(
            application = this,
            identity = UserIdentity.of("<YOUR_OPAQUE_USER_ID>"),
            token = "<API token>"
        )
    }
}

UserIdentity.of convierte un id nulo o en blanco en UserIdentity.Unidentified; en ese caso, el SDK genera un id y lo conserva entre ejecuciones de la aplicación. Pasa tu propio id siempre que lo tengas, con o sin sesión iniciada.

Java

import android.app.Application;
import com.topsort.analytics.Analytics;
import com.topsort.analytics.UserIdentity;

public class JavaApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        Analytics.INSTANCE.setup(this, UserIdentity.of("<opaqueUserId>"), "<API token>");
    }
}

Reportando Eventos

Renders

Un render registra que un anuncio patrocinado fue insertado en la página, por separado de la impresión, que registra cuándo el anuncio se vuelve visible. Los renders son solo para anuncios patrocinados, por lo que no existe una variante orgánica.

import com.topsort.analytics.Analytics
import com.topsort.analytics.model.Placement

Analytics.reportRender(
    resolvedBidId = "<The bid id from the auction winner>",
    placement = Placement(path = "search_results", position = 1)
)

Para reportar varios renders en un solo evento, constrúyelos con Render.Factory y pásalos a Analytics.reportRenders(list). Render.Factory.build no tiene valores predeterminados para resolvedBidId, placement, occurredAt (una marca de tiempo RFC 3339), opaqueUserId e id, así que pásalos en cada render, con un id único.

Impresiones

Una impresión registra que un anuncio o producto se volvió visible para el comprador.

Analytics.reportImpressionPromoted(
    resolvedBidId = "<The bid id from the auction winner>",
    placement = Placement(path = "search_results", position = 1)
)

Para resultados orgánicos, usa Analytics.reportImpressionOrganic con entity = Entity(id = "<product id>", type = EntityType.PRODUCT) en lugar de resolvedBidId. Importa Entity y EntityType desde com.topsort.analytics.model: el callback de clic de banners usa un EntityType diferente.

Clics

Un clic registra que el comprador hizo clic en un anuncio o producto.

Analytics.reportClickPromoted(
    resolvedBidId = "<The bid id from the auction winner>",
    placement = Placement(path = "search_results", position = 1)
)

Para resultados orgánicos, usa Analytics.reportClickOrganic con un entity, igual que en las impresiones.

Compras

Una compra registra los productos que adquirió el comprador. Topsort la atribuye a los anuncios con los que el comprador interactuó.

import com.topsort.analytics.model.PurchasedItem

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),
)

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(
                config = bannerConfig,
                path = "sample_activity",
                location = "hero-banner"
            ) { id, entityType -> onBannerClick(id, entityType) }
        }
    }
}

BannerView reporta el render apenas se muestra el ganador, la impresión una vez que el banner está en pantalla, y el clic cuando se toca. No reportes estos eventos por tu cuenta para los banners que muestra. Para la documentación completa, consulta el repositorio de GitHub.

Resumen

Plataforma de Anuncios

Servidor de Anuncios

Toppie

Integraciones Avanzadas

API

Instalación

Configuración

Kotlin

Java

Reportando Eventos

Renders

Impresiones

Clics

Compras

Anuncios de Banner

​Instalación

​Configuración

​Kotlin

​Java

​Reportando Eventos

​Renders

​Impresiones

​Clics

​Compras

​Anuncios de Banner

Instalación

Configuración

Kotlin

Java

Reportando Eventos

Renders

Impresiones

Clics

Compras

Anuncios de Banner