Passer au contenu principal
La bibliothèque Kotlin de Topsort permet à nos clients d’envoyer facilement des requêtes d’enchères et de suivre les événements au sein des applications Android.
Version Java minimale requise : 17.

Installation

Ajoutez la dépendance à votre fichier build.gradle :
dependencies {
    implementation 'com.topsort:topsort-kt:2.0.0'
}

Configuration

Kotlin

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

class KotlinApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Analytics.setup(
            application = this,
            opaqueUserId = "<VOTRE_OPAQUE_USER_ID>",
            token = "<Token API>"
        )
    }
}

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>", "<Token API>");
    }
}

Signalement des événements

Kotlin

// Achat
fun reportPurchase() {
    val item = PurchasedItem(
        productId = "<ID marketplace pour l'article>",
        unitPrice = 1295,
        quantity = 20
    )
    Analytics.reportPurchase(
        id = "<ID marketplace pour l'achat complet>",
        items = listOf(item),
    )
}

// Clic (promu)
fun reportClickPromoted() {
    val placement = Placement(path = "search_results", location = "position_1")
    Analytics.reportClickPromoted(
        id = "<ID marketplace pour l'article>",
        resolvedBidId = "<L'ID d'enchère du gagnant de l'enchère>",
        placement = placement
    )
}

// Impression (promu)
fun reportImpressionPromoted() {
    val placement = Placement(path = "search_results", location = "position_1")
    Analytics.reportImpressionPromoted(
        id = "<ID marketplace pour l'article>",
        resolvedBidId = "<L'ID d'enchère du gagnant de l'enchère>",
        placement = placement
    )
}

Bannières publicitaires

Ajoutez BannerView à votre XML d’activité :
<com.topsort.analytics.banners.BannerView
    android:id="@+id/bannerView"
    android:layout_width="353dp"
    android:layout_height="103dp" />
Configuration dans votre activité :
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) }
            )
        }
    }
}
Pour la documentation complète, consultez le dépôt GitHub.

Besoin d'aide avec votre intégration Topsort ?

Parlez-nous, l'équipe d'ingénierie des intégrations.Contactez-nous via votre canal de messagerie dédié ou à support@topsort.com.Si vous n'êtes pas encore client, planifiez une démo avec notre équipe de vente.