UserIdentity.of turns a null or blank id into UserIdentity.Unidentified, in which case the SDK generates an id and keeps it across launches. Pass your own id whenever you have one, logged in or not. When a user logs in, call Analytics.setup again with UserIdentity.of(<their id>) so events are reported under your own id. A generated id does not match your audiences.
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>"); }}
Reporting Events
Renders
A render records that a sponsored ad was inserted into the page, separately from the impression, which records when the ad becomes visible. Renders are sponsored-only, so there is no organic variant.
import com.topsort.analytics.Analyticsimport com.topsort.analytics.model.PlacementAnalytics.reportRender( resolvedBidId = "<The bid id from the auction winner>", placement = Placement(path = "search_results", position = 1))
To report several renders in one event, build them with Render.Factory and pass them to Analytics.reportRenders(list). Render.Factory.build has no defaults for resolvedBidId, placement, occurredAt (an RFC 3339 timestamp), opaqueUserId and id, so pass them for each render, with a unique id.
Impressions
An impression records that an ad or product became visible to the shopper.
Analytics.reportImpressionPromoted( resolvedBidId = "<The bid id from the auction winner>", placement = Placement(path = "search_results", position = 1))
For organic results, use Analytics.reportImpressionOrganic with entity = Entity(id = "<product id>", type = EntityType.PRODUCT) instead of resolvedBidId. Import Entity and EntityType from com.topsort.analytics.model: the banner click callback uses a different EntityType.
Clicks
A click records that the shopper clicked an ad or product.
Analytics.reportClickPromoted( resolvedBidId = "<The bid id from the auction winner>", placement = Placement(path = "search_results", position = 1))
For organic results, use Analytics.reportClickOrganic with an entity, as for impressions.
Purchases
A purchase records the products a shopper bought. Topsort attributes it to the ads the shopper interacted with.
import com.topsort.analytics.model.PurchasedItemval item = PurchasedItem( productId = "<Marketplace id for the item>", unitPrice = 13, quantity = 20)Analytics.reportPurchase( id = "<Marketplace id for the entire purchase>", items = listOf(item),)
unitPrice is required. It is the price of a single item in major units of your marketplace currency (13 means 13.00), not cents. In version 4.1.0 it is an Int, so only whole amounts can be sent.
Page Views
A page view records that the shopper navigated to a page. The API requires a pageId.
Reported events are stored on the device and sent in the background. They are retried after failures and across app launches. The SDK drops an event only if the API rejects it with a 4xx error (429 and 408 are retried), if the cache grows past 5,000 events and the oldest are evicted, or if a stored event can no longer be read. To count dropped events, register a listener:
The listener runs on the SDK’s worker thread, so keep it quick.
Sponsored Listings Auctions
Run an auction for products, a category or a search keyword, then report events with the resolvedBidId of each winner.
import com.topsort.analytics.model.auctions.Auctionimport com.topsort.analytics.model.auctions.AuctionConfigimport com.topsort.analytics.model.auctions.AuctionErrorimport com.topsort.analytics.model.auctions.AuctionRequestimport com.topsort.analytics.service.TopsortAuctionsHttpServiceval config = AuctionConfig.ProductIds( numSlots = 3, ids = listOf("<product id 1>", "<product id 2>", "<product id 3>"))val request = AuctionRequest(listOf(Auction.fromConfig(config)))try { val response = TopsortAuctionsHttpService.runAuctions(request) // suspend function response.results.forEach { result -> result.winners.forEach { winner -> // winner.id is the product id, winner.resolvedBidId goes on impressions and clicks } }} catch (e: AuctionError) { // HttpError, DeserializationError, EmptyResponse, SerializationError or InvalidNumberAuctions}
Other configs are AuctionConfig.CategorySingle, CategoryMultiple, CategoryDisjunctions and Keyword. All of them accept opaqueUserId and placementId (1 to 8).
BannerView reports the render as soon as the winner is displayed, the impression once the banner is on screen, and the click when it is tapped. Do not report these events yourself for banners it displays.For full documentation, see the GitHub repository.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Topsort Documentation","colors":{"primary":"#0074F7","light":"#8280ff","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/topsort/FdGgIIxdnNXimeCi/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=FdGgIIxdnNXimeCi\u0026q=85\u0026s=52335392d5233f0542050e8af5c24ef4","dark":"https://mintcdn.com/topsort/FdGgIIxdnNXimeCi/assets/logo-dark.svg?fit=max\u0026auto=format\u0026n=FdGgIIxdnNXimeCi\u0026q=85\u0026s=075f4c9f1ab9d40efecad5a644f360c0"},"favicon":"https://mintcdn.com/topsort/FdGgIIxdnNXimeCi/assets/favicon.png?fit=max\u0026auto=format\u0026n=FdGgIIxdnNXimeCi\u0026q=85\u0026s=ce9becb0a815ae7e2538a5f52f46517d","fonts":{"heading":{"family":"Circular","weight":700,"source":"fonts/CircularStd-Bold.woff2","format":"woff2"},"body":{"family":"Inter"}},"integrations":{"posthog":{"apiKey":"phc_xhC57kj0jUKFieH7EO1GEKaUQixVcPXguqJN4ep6UoQ","apiHost":"https://us.i.posthog.com","sessionRecording":true}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","href":"en/api-reference/introduction"},{"language":"es","href":"es/api-reference/introduction"},{"language":"pt","href":"pt/api-reference/introduction"},{"language":"fr","href":"fr/api-reference/introduction"},{"language":"de","href":"de/api-reference/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"topsort","hasAudioNarration":false,"actualSubdomain":"topsort","customDomains":["docs.topsort.com"],"gitSource":{"type":"github","owner":"topsort","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"issues":false,"edits":false,"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00916117f59536ae326e4e","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"API Reference","count":186},{"language":"de","tag":"API-Referenz","count":184},{"language":"es","tag":"Referencia de API","count":184},{"language":"fr","tag":"Référence API","count":184},{"language":"pt","tag":"Referência da API","count":184},{"language":"en","tag":"Changelog","count":164},{"language":"de","tag":"Wissensdatenbank","count":132},{"language":"de","tag":"Dokumentation","count":132},{"language":"en","tag":"Knowledge Base","count":132},{"language":"en","tag":"Documentation","count":132},{"language":"es","tag":"Base de Conocimientos","count":132},{"language":"es","tag":"Documentación","count":132},{"language":"fr","tag":"Base de connaissances","count":132},{"language":"fr","tag":"Documentation","count":132},{"language":"pt","tag":"Base de Conhecimento","count":132},{"language":"pt","tag":"Documentação","count":132},{"language":"de","tag":"Werbeplattform","count":82},{"language":"en","tag":"Ad Platform","count":82},{"language":"es","tag":"Plataforma de Anuncios","count":82},{"language":"fr","tag":"Plateforme Publicitaire","count":82},{"language":"pt","tag":"Plataforma de Anúncios","count":82},{"language":"en","tag":"2026","count":63},{"language":"en","tag":"2025","count":54},{"language":"en","tag":"Integration Guide","count":46},{"language":"de","tag":"Integrationshandbuch","count":44},{"language":"es","tag":"Guía de Integración","count":44},{"language":"fr","tag":"Guide d'Intégration","count":44},{"language":"pt","tag":"Guia de Integração","count":44},{"language":"de","tag":"Campaign API","count":41},{"language":"en","tag":"Campaign API","count":41},{"language":"es","tag":"Campaign API","count":41},{"language":"fr","tag":"Campaign API","count":41},{"language":"pt","tag":"Campaign API","count":41},{"language":"en","tag":"Ad Server","count":39},{"language":"de","tag":"Werbeserver","count":37},{"language":"es","tag":"Servidor de Anuncios","count":37},{"language":"fr","tag":"Serveur Publicitaire","count":37},{"language":"pt","tag":"Servidor de Anúncios","count":37},{"language":"de","tag":"Changelog","count":33},{"language":"de","tag":"2026","count":33},{"language":"es","tag":"Registro de Cambios","count":33},{"language":"es","tag":"2026","count":33},{"language":"fr","tag":"Journal des modifications","count":33},{"language":"fr","tag":"2026","count":33},{"language":"pt","tag":"Registro de alterações","count":33},{"language":"pt","tag":"2026","count":33},{"language":"de","tag":"Übersicht","count":16},{"language":"es","tag":"Offsite Ads API","count":16},{"language":"fr","tag":"Aperçu","count":16},{"language":"pt","tag":"Visão Geral","count":16}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","href":"/_mintlify/custom/topsort/e3e827d70a3d0a94/style.css"},{"filePath":"styles/base.css","content":"body{opacity:0;transition:opacity 0.2s ease-in}body.loaded{opacity:1}@font-face{font-family:Circular;font-style:normal;font-weight:bold;font-display:swap;src:url(\"/fonts/CircularStd-Bold.woff2\") format(\"woff2\")}@font-face{font-family:Circular;font-style:italic;font-weight:bold;font-display:swap;src:url(\"/fonts/CircularStd-BoldItalic.woff2\") format(\"woff2\")}h1,h2,h3,h4,h5,h6{font-family:Circular, ui-sans-serif, sans-serif}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0, 0, 0, 0);white-space:nowrap;border-width:0}"},{"filePath":"styles/changelog.css","content":"body[data-page=\"/en/changelog\"] #sidebar,body[data-page=\"/en/changelog/\"] #sidebar{display:none!important}body[data-page=\"/en/changelog\"] main,body[data-page=\"/en/changelog/\"] main{margin-left:0!important;max-width:100%!important}body[data-page=\"/en/changelog\"] [class*=\"TableOfContents\"],body[data-page=\"/en/changelog/\"] [class*=\"TableOfContents\"]{display:none!important}[data-theme=\"dark\"] img[src$=\".svg\"]{filter:invert(1) hue-rotate(180deg)}[data-theme=\"dark\"] img[src*=\"logo\"],[data-theme=\"dark\"] img[src*=\"icon\"]{filter:none}img{transition:filter 0.3s ease}article hr,main hr{border:none;height:4px;background:linear-gradient(\n\t\tto right,\n\t\ttransparent,\n\t\t#00ff88 20%,\n\t\t#00d4ff 40%,\n\t\t#8280ff 60%,\n\t\t#ff6b9d 80%,\n\t\ttransparent\n\t);margin:3rem 0;opacity:0.7;border-radius:2px}[data-theme=\"dark\"] article hr,[data-theme=\"dark\"] main hr{opacity:0.9}.last-updated-component{background-color:rgba(0, 0, 0, 0.05);border:1px solid rgba(0, 0, 0, 0.12);color:rgba(0, 0, 0, 0.75)}.last-updated-component svg{stroke:currentColor}.dark .last-updated-component{background-color:#3a3a3a!important;border:2px solid #888888!important;color:#ffffff!important}.dark .last-updated-component svg{stroke:#ffffff!important;opacity:1!important}.dark .last-updated-component strong,.dark .last-updated-component time{color:#ffffff!important}#navigation-items a[href*=\"/changelog/\"]{font-size:14px!important;line-height:20px!important;white-space:normal!important;overflow:visible!important;text-overflow:clip!important;display:block!important}#navigation-items ul{transition:max-height 0.2s ease-out,\n\t\topacity 0.2s ease-out;overflow:hidden}#navigation-items button[aria-expanded]{transition:background-color 0.15s ease}#navigation-items button[aria-expanded]:hover{background-color:rgba(99, 102, 241, 0.1)}"},{"filePath":"styles/feedback.css","content":"#feedback-toast{position:fixed;bottom:24px;left:50%;transform:translateX(-50%) translateY(100px);background:rgba(255, 255, 255, 0.85);backdrop-filter:blur(12px);-webkit-backdrop-filter:blur(12px);border:1px solid rgba(0, 0, 0, 0.1);border-radius:12px;padding:12px 20px;box-shadow:0 2px 8px rgba(0, 0, 0, 0.08);display:flex;align-items:center;gap:14px;z-index:9999;opacity:0;transition:all 0.4s cubic-bezier(0.16, 1, 0.3, 1);pointer-events:none}#feedback-toast.visible{opacity:1;transform:translateX(-50%) translateY(0);pointer-events:auto}.dark #feedback-toast{background:rgba(31, 41, 55, 0.9);border-color:rgba(255, 255, 255, 0.15);box-shadow:0 2px 8px rgba(0, 0, 0, 0.2)}#feedback-toast .toast-text{color:#374151;font-size:14px;font-weight:500}.dark #feedback-toast .toast-text{color:#e5e7eb}#feedback-toast .toast-submit-btn{background:#0074f7;color:white;border:none;border-radius:8px;padding:8px 14px;font-size:13px;font-weight:600;cursor:pointer;transition:all 0.2s ease}#feedback-toast .toast-submit-btn:hover{background:#01193a}.dark #feedback-toast .toast-submit-btn{background:#8280ff}.dark #feedback-toast .toast-submit-btn:hover{background:#6e6ce6}#feedback-toast .toast-close-btn{background:rgba(0, 0, 0, 0.05);border:none;color:#6b7280;cursor:pointer;font-size:18px;padding:4px 8px;line-height:1;border-radius:6px;transition:all 0.2s ease}#feedback-toast .toast-close-btn:hover{background:rgba(0, 0, 0, 0.1);color:#374151}.dark #feedback-toast .toast-close-btn{background:rgba(255, 255, 255, 0.05);color:#9ca3af}.dark #feedback-toast .toast-close-btn:hover{background:rgba(255, 255, 255, 0.1);color:#e5e7eb}#feedback-dialog{position:fixed;top:0;left:0;width:100%;height:100%;background:rgba(0, 0, 0, 0.3);backdrop-filter:blur(2px);-webkit-backdrop-filter:blur(2px);display:flex;align-items:center;justify-content:center;z-index:10000;opacity:0;pointer-events:none;transition:opacity 0.3s ease}#feedback-dialog.visible{opacity:1;pointer-events:auto}.dark #feedback-dialog{background:rgba(0, 0, 0, 0.5)}.feedback-dialog-content{background:rgba(255, 255, 255, 0.95);backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);border:1px solid rgba(0, 0, 0, 0.1);border-radius:16px;padding:28px;max-width:520px;width:90%;max-height:80vh;overflow-y:auto;box-shadow:0 4px 16px rgba(0, 0, 0, 0.1);transform:scale(0.95) translateY(10px);transition:all 0.4s cubic-bezier(0.16, 1, 0.3, 1)}#feedback-dialog.visible .feedback-dialog-content{transform:scale(1) translateY(0)}.dark .feedback-dialog-content{background:rgba(31, 41, 55, 0.95);border-color:rgba(255, 255, 255, 0.1);box-shadow:0 4px 16px rgba(0, 0, 0, 0.3)}.feedback-dialog-header{display:flex;justify-content:space-between;align-items:center;margin-bottom:28px}.feedback-dialog-header h2{margin:0;font-size:22px;font-weight:600;color:#111827;letter-spacing:-0.02em}.dark .feedback-dialog-header h2{color:#f9fafb}.dialog-close-btn{background:rgba(0, 0, 0, 0.05);border:none;font-size:20px;color:#6b7280;cursor:pointer;padding:0;width:36px;height:36px;line-height:36px;border-radius:10px;transition:all 0.2s ease}.dialog-close-btn:hover{background:rgba(0, 0, 0, 0.1);color:#374151}.dark .dialog-close-btn{background:rgba(255, 255, 255, 0.05)}.dark .dialog-close-btn:hover{background:rgba(255, 255, 255, 0.1);color:#e5e7eb}.feedback-page-context{display:flex;align-items:center;gap:8px;padding:10px 14px;background:rgba(0, 0, 0, 0.03);border-radius:8px;margin-bottom:20px;font-size:13px;color:#6b7280}.feedback-page-context svg{flex-shrink:0;opacity:0.6}.feedback-page-context .page-context-text{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;cursor:help}.dark .feedback-page-context{background:rgba(255, 255, 255, 0.05);color:#9ca3af}.selected-text-preview{display:none;background:rgba(0, 116, 247, 0.04);border-left:3px solid #0074f7;padding:14px 18px;margin-bottom:24px;border-radius:0 12px 12px 0}.dark .selected-text-preview{background:rgba(130, 128, 255, 0.1);border-left-color:#8280ff}.selected-text-preview .preview-label{margin:0 0 8px 0;font-size:11px;color:#0074f7;font-weight:600;text-transform:uppercase;letter-spacing:0.08em}.dark .selected-text-preview .preview-label{color:#a5a3ff}.selected-text-preview .selected-text-content{margin:0;font-size:14px;color:#374151;font-style:italic;max-height:100px;overflow-y:auto;line-height:1.6}.dark .selected-text-preview .selected-text-content{color:#d1d5db}#feedback-form .form-group{margin-bottom:22px}#feedback-form label{display:block;margin-bottom:10px;font-size:13px;font-weight:600;color:#374151;letter-spacing:0.01em}.dark #feedback-form label{color:#d1d5db}#feedback-form textarea,#feedback-form input[type=\"email\"]{width:100%;padding:14px 16px;border:1px solid rgba(0, 0, 0, 0.1);border-radius:12px;font-size:14px;font-family:inherit;box-sizing:border-box;background:rgba(255, 255, 255, 0.6);color:#111827;transition:all 0.2s ease}.dark #feedback-form textarea,.dark #feedback-form input[type=\"email\"]{background:rgba(55, 65, 81, 0.5);border-color:rgba(255, 255, 255, 0.1);color:#f3f4f6}#feedback-form textarea{min-height:130px;resize:vertical;line-height:1.6}#feedback-form textarea:focus,#feedback-form input[type=\"email\"]:focus{outline:none;border-color:#0074f7;background:rgba(255, 255, 255, 0.95)}.dark #feedback-form textarea:focus,.dark #feedback-form input[type=\"email\"]:focus{background:rgba(55, 65, 81, 0.8);border-color:#8280ff}#feedback-form textarea::placeholder,#feedback-form input[type=\"email\"]::placeholder{color:#9ca3af}.form-actions{display:flex;gap:12px;justify-content:flex-end;margin-top:28px}.btn-cancel{padding:12px 22px;border:1px solid rgba(0, 0, 0, 0.1);background:rgba(255, 255, 255, 0.5);border-radius:12px;font-size:14px;font-weight:600;cursor:pointer;color:#374151;transition:all 0.2s ease}.btn-cancel:hover{background:rgba(255, 255, 255, 0.8);border-color:rgba(0, 0, 0, 0.15)}.dark .btn-cancel{background:rgba(55, 65, 81, 0.5);border-color:rgba(255, 255, 255, 0.1);color:#d1d5db}.dark .btn-cancel:hover{background:rgba(55, 65, 81, 0.8)}.btn-submit{padding:10px 20px;border:none;background:#0074f7;color:white;border-radius:8px;font-size:14px;font-weight:600;cursor:pointer;transition:all 0.2s ease}.btn-submit:hover{background:#01193a}.dark .btn-submit{background:#8280ff}.dark .btn-submit:hover{background:#6e6ce6}.btn-submit:disabled{background:#9ca3af;box-shadow:none;cursor:not-allowed;transform:none}.form-status{margin-top:16px;padding:12px 16px;border-radius:10px;display:none;font-size:13px;font-weight:500;text-align:center;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.form-status.success{background:rgba(16, 185, 129, 0.12);color:#059669;border:1px solid rgba(16, 185, 129, 0.25)}.dark .form-status.success{background:rgba(16, 185, 129, 0.18);color:#6ee7b7;border-color:rgba(16, 185, 129, 0.35)}.form-status.error{background:rgba(239, 68, 68, 0.12);color:#dc2626;border:1px solid rgba(239, 68, 68, 0.25)}.dark .form-status.error{background:rgba(239, 68, 68, 0.18);color:#fca5a5;border-color:rgba(239, 68, 68, 0.35)}"},{"filePath":"styles/goodies.css","content":".goodies-container{position:fixed;bottom:24px;left:24px;z-index:9998;display:flex;flex-direction:column;align-items:flex-start;gap:12px}.goodies-trigger{background:#0074f7;color:white;border:none;border-radius:50%;width:32px;height:32px;display:flex;align-items:center;justify-content:center;cursor:pointer;box-shadow:0 1px 2px rgba(0, 0, 0, 0.1);transition:all 0.2s ease;position:relative;padding:0}.goodies-trigger:hover{background:#01193a}.goodies-trigger:active{transform:scale(0.95)}.dark .goodies-trigger{background:#8280ff;box-shadow:0 1px 3px rgba(0, 0, 0, 0.2)}.dark .goodies-trigger:hover{background:#6e6ce6}.goodies-trigger .goodies-icon-heart,.goodies-trigger .goodies-icon-close{position:absolute;top:50%;left:50%;transform-origin:center;transition:all 0.3s cubic-bezier(0.16, 1, 0.3, 1)}.goodies-trigger .goodies-icon-heart{opacity:1;transform:translate(-50%, -50%) scale(1) rotate(0deg)}.goodies-trigger .goodies-icon-close{opacity:0;transform:translate(-50%, -50%) scale(0.5) rotate(-90deg)}.goodies-container.open .goodies-trigger .goodies-icon-heart{opacity:0;transform:translate(-50%, -50%) scale(0.5) rotate(90deg)}.goodies-container.open .goodies-trigger .goodies-icon-close{opacity:1;transform:translate(-50%, -50%) scale(1) rotate(0deg)}.goodies-menu{display:flex;flex-direction:column;gap:8px;opacity:0;transform:translateY(10px) scale(0.95);pointer-events:none;transition:all 0.3s cubic-bezier(0.16, 1, 0.3, 1)}.goodies-container.open .goodies-menu{opacity:1;transform:translateY(0) scale(1);pointer-events:auto}.goodies-menu-item{display:flex;align-items:center;gap:10px;padding:12px 16px;background:rgba(255, 255, 255, 0.95);backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);border:1px solid rgba(0, 0, 0, 0.08);border-radius:12px;color:#374151;font-size:14px;font-weight:500;cursor:pointer;white-space:nowrap;box-shadow:0 2px 8px rgba(0, 0, 0, 0.08);transition:all 0.2s ease;text-decoration:none}.goodies-menu-item:hover{background:rgba(255, 255, 255, 1);transform:translateX(4px);box-shadow:0 4px 12px rgba(0, 0, 0, 0.1)}.goodies-menu-item svg{color:#0074f7;flex-shrink:0}.dark .goodies-menu-item{background:rgba(31, 41, 55, 0.95);border-color:rgba(255, 255, 255, 0.1);color:#e5e7eb;box-shadow:0 2px 8px rgba(0, 0, 0, 0.2)}.dark .goodies-menu-item:hover{background:rgba(55, 65, 81, 0.98);box-shadow:0 4px 12px rgba(0, 0, 0, 0.3)}.dark .goodies-menu-item svg{color:#8280ff}@media (max-width: 640px){#feedback-toast{top:72px;bottom:auto;left:16px;right:16px;transform:translateX(0) translateY(-100px);width:auto;border-radius:14px;padding:12px 18px}#feedback-toast.visible{transform:translateX(0) translateY(0)}.feedback-dialog-content{padding:24px;margin:16px;width:calc(100% - 32px);border-radius:20px}.goodies-container{top:76px;bottom:auto;right:16px;left:auto;align-items:flex-end}.goodies-container{flex-direction:column-reverse}.goodies-menu{transform:translateY(-10px) scale(0.95)}.goodies-container.open .goodies-menu{transform:translateY(0) scale(1)}.goodies-trigger{width:30px;height:30px;border-radius:50%}.goodies-trigger svg{width:14px;height:16px}.goodies-menu-item{padding:10px 14px;font-size:13px}.form-actions{flex-direction:column}.btn-cancel,.btn-submit{width:100%;justify-content:center}.form-status{font-size:11px;padding:10px 14px;margin-top:12px;white-space:normal;line-height:1.4;text-align:center}}button[type=\"submit\"][class*=\"bg-primary\"],button[aria-label*=\"submit\"][class*=\"bg-primary\"],form button[class*=\"rounded-full\"][class*=\"bg-\"],[data-testid=\"chat-input\"] button,.chat-input button[type=\"submit\"],button[class*=\"bg-primary\"][class*=\"rounded-full\"]{background:#0074f7!important}button[type=\"submit\"][class*=\"bg-primary\"]:hover,button[aria-label*=\"submit\"][class*=\"bg-primary\"]:hover,form button[class*=\"rounded-full\"][class*=\"bg-\"]:hover,[data-testid=\"chat-input\"] button:hover,.chat-input button[type=\"submit\"]:hover,button[class*=\"bg-primary\"][class*=\"rounded-full\"]:hover{background:#01193a!important}.dark button[type=\"submit\"][class*=\"bg-primary\"],.dark button[aria-label*=\"submit\"][class*=\"bg-primary\"],.dark form button[class*=\"rounded-full\"][class*=\"bg-\"],.dark [data-testid=\"chat-input\"] button,.dark .chat-input button[type=\"submit\"],.dark button[class*=\"bg-primary\"][class*=\"rounded-full\"]{background:#8280ff!important}.dark button[type=\"submit\"][class*=\"bg-primary\"]:hover,.dark button[aria-label*=\"submit\"][class*=\"bg-primary\"]:hover,.dark form button[class*=\"rounded-full\"][class*=\"bg-\"]:hover,.dark [data-testid=\"chat-input\"] button:hover,.dark .chat-input button[type=\"submit\"]:hover,.dark button[class*=\"bg-primary\"][class*=\"rounded-full\"]:hover{background:#6e6ce6!important}"},{"filePath":"styles/homepage.css","content":"body[data-page=\"/\"] #header,body[data-page=\"\"] #header{display:none!important;visibility:hidden!important;height:0!important;overflow:hidden!important}body[data-page=\"/\"] .hero-gradient,body[data-page=\"\"] .hero-gradient{padding-top:2rem!important;padding-bottom:2rem!important;position:relative;z-index:2}@media (min-width: 768px){body[data-page=\"/\"] .hero-gradient,body[data-page=\"\"] .hero-gradient{padding-top:3rem!important;padding-bottom:3rem!important}}@media (min-width: 1024px){body[data-page=\"/\"] .hero-gradient,body[data-page=\"\"] .hero-gradient{padding-top:5rem!important;padding-bottom:5rem!important}}body[data-page=\"/\"] .hero-gradient h1,body[data-page=\"\"] .hero-gradient h1,body[data-page=\"/\"] .hero-gradient h1 *,body[data-page=\"\"] .hero-gradient h1 *,body[data-page=\"/\"] .hero-gradient div h1,body[data-page=\"\"] .hero-gradient div h1{text-align:center!important;width:100%!important}body[data-page=\"/\"] .hero-gradient p,body[data-page=\"\"] .hero-gradient p,body[data-page=\"/\"] .hero-gradient div p,body[data-page=\"\"] .hero-gradient div p{text-align:center!important;width:100%!important}body[data-page=\"/\"] .hero-gradient h1 a,body[data-page=\"\"] .hero-gradient h1 a,body[data-page=\"/\"] .hero-gradient h1 a img,body[data-page=\"\"] .hero-gradient h1 a img{display:none!important}body[data-page=\"/\"] .hero-gradient h1,body[data-page=\"\"] .hero-gradient h1{margin-bottom:1rem!important}body[data-page=\"/\"] .hero-gradient p,body[data-page=\"\"] .hero-gradient p{margin-bottom:2rem!important}@media (min-width: 1280px){body[data-page=\"/\"] .hero-gradient h1,body[data-page=\"\"] .hero-gradient h1,body[data-page=\"/\"] .hero-gradient h1 *,body[data-page=\"\"] .hero-gradient h1 *,body[data-page=\"/\"] .hero-gradient div h1,body[data-page=\"\"] .hero-gradient div h1{text-align:center!important}body[data-page=\"/\"] .hero-gradient p,body[data-page=\"\"] .hero-gradient p,body[data-page=\"/\"] .hero-gradient div p,body[data-page=\"\"] .hero-gradient div p{text-align:center!important;width:fit-content!important;position:relative!important;left:50%!important;transform:translateX(-50%)!important;white-space:nowrap!important}}body[data-page=\"/\"] #toppie-container,body[data-page=\"\"] #toppie-container{max-width:280px!important;width:100%!important;margin-bottom:1.5rem;position:relative;z-index:2}@media (min-width: 640px){body[data-page=\"/\"] #toppie-container,body[data-page=\"\"] #toppie-container{max-width:320px!important}}@media (min-width: 768px){body[data-page=\"/\"] #toppie-container,body[data-page=\"\"] #toppie-container{max-width:350px!important;margin-bottom:2rem}}@media (min-width: 1280px){body[data-page=\"/\"] #toppie-container,body[data-page=\"\"] #toppie-container{max-width:320px!important;margin-bottom:0}}body[data-page=\"/\"] main h2,body[data-page=\"\"] main h2,body[data-page=\"/\"] article h2,body[data-page=\"\"] article h2,body[data-page=\"/\"] .mdx-content>h2,body[data-page=\"\"] .mdx-content>h2,body[data-page=\"/\"] main h2 *,body[data-page=\"\"] main h2 *,body[data-page=\"/\"] article h2 *,body[data-page=\"\"] article h2 *,body[data-page=\"/\"] .mdx-content>h2 *,body[data-page=\"\"] .mdx-content>h2 *,body[data-page=\"/\"] h2.text-center,body[data-page=\"\"] h2.text-center{text-align:center!important;margin-left:auto!important;margin-right:auto!important}body[data-page=\"/\"] .mdx-content>p,body[data-page=\"\"] .mdx-content>p,body[data-page=\"/\"] .mdx-content p:not([class]),body[data-page=\"\"] .mdx-content p:not([class]),body[data-page=\"/\"] .prose>p,body[data-page=\"\"] .prose>p,body[data-page=\"/\"] .mdx-content>div>p,body[data-page=\"\"] .mdx-content>div>p{text-align:center!important;margin-left:auto!important;margin-right:auto!important}body[data-page=\"/\"] a[href*=\"bannersjs\"] *,body[data-page=\"\"] a[href*=\"bannersjs\"] *{text-align:left!important;hyphens:none!important;text-justify:none!important}body[data-page=\"/\"] main h2 a[href^=\"#\"],body[data-page=\"\"] main h2 a[href^=\"#\"],body[data-page=\"/\"] article h2 a[href^=\"#\"],body[data-page=\"\"] article h2 a[href^=\"#\"],body[data-page=\"/\"] .mdx-content>h2 a[href^=\"#\"],body[data-page=\"\"] .mdx-content>h2 a[href^=\"#\"],body[data-page=\"/\"] main h2 a img,body[data-page=\"\"] main h2 a img,body[data-page=\"/\"] .mdx-content>h2 a img,body[data-page=\"\"] .mdx-content>h2 a img,body[data-page=\"/\"] article h2 a img,body[data-page=\"\"] article h2 a img{display:none!important}body[data-page=\"/\"] main>h2,body[data-page=\"\"] main>h2{margin-top:4rem!important;margin-bottom:2rem!important}@media (min-width: 768px){body[data-page=\"/\"] main>h2,body[data-page=\"\"] main>h2{margin-top:5rem!important;margin-bottom:2.5rem!important}}body[data-page=\"/\"] #sidebar,body[data-page=\"\"] #sidebar{display:none!important}body[data-page=\"/\"] main,body[data-page=\"\"] main{margin-left:0!important;max-width:100%!important;position:relative;z-index:2}body[data-page=\"/\"] .mdx-content,body[data-page=\"\"] .mdx-content{max-width:900px!important;margin-left:auto!important;margin-right:auto!important;position:relative;z-index:2}body[data-page=\"/\"] [class*=\"TableOfContents\"],body[data-page=\"\"] [class*=\"TableOfContents\"]{display:none!important}body[data-page=\"/\"] #page-context-menu-button,body[data-page=\"\"] #page-context-menu-button,body[data-page=\"/\"] button[aria-label=\"Copy page\"],body[data-page=\"\"] button[aria-label=\"Copy page\"],body[data-page=\"/\"] button[aria-label=\"More actions\"],body[data-page=\"\"] button[aria-label=\"More actions\"]{display:none!important}#bg-video{position:fixed!important;top:0!important;left:0!important;width:100vw!important;height:100vh!important;object-fit:cover!important;z-index:-1!important;opacity:0.2!important;pointer-events:none!important}.persistent-bg-video{position:fixed!important;top:0!important;left:0!important;width:100vw!important;height:100vh!important;object-fit:cover!important;object-position:center top!important;z-index:-1!important;pointer-events:none!important}body[data-page=\"/\"] #bg-video,body[data-page=\"\"] #bg-video{display:none!important}body[data-page=\"/\"] .nav-tabs-item,body[data-page=\"\"] .nav-tabs-item{color:rgb(107, 114, 128)!important;text-shadow:none!important}body[data-page=\"/\"] .nav-tabs-item>div.absolute,body[data-page=\"\"] .nav-tabs-item>div.absolute,body[data-page=\"/\"] .nav-tabs-item>.bg-primary,body[data-page=\"\"] .nav-tabs-item>.bg-primary{display:none!important}body[data-page=\"/\"] .nav-tabs-item:hover,body[data-page=\"\"] .nav-tabs-item:hover{color:rgb(55, 65, 81)!important}.dark body[data-page=\"/\"] .nav-tabs-item,.dark body[data-page=\"\"] .nav-tabs-item,body.dark[data-page=\"/\"] .nav-tabs-item,body.dark[data-page=\"\"] .nav-tabs-item{color:rgb(156, 163, 175)!important}.dark body[data-page=\"/\"] .nav-tabs-item:hover,.dark body[data-page=\"\"] .nav-tabs-item:hover,body.dark[data-page=\"/\"] .nav-tabs-item:hover,body.dark[data-page=\"\"] .nav-tabs-item:hover{color:rgb(209, 213, 219)!important}.whats-new-banner{display:inline-flex;align-items:center;gap:8px;margin:0 auto 32px auto;padding:6px 14px 6px 6px;background:rgba(255, 255, 255, 0.5);backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);border:1px solid rgba(0, 0, 0, 0.06);border-radius:9999px;text-decoration:none;transition:all 0.25s cubic-bezier(0.4, 0, 0.2, 1);font-size:13px;box-shadow:0 1px 3px rgba(0, 0, 0, 0.03)}.whats-new-banner:hover{background:rgba(255, 255, 255, 0.8);border-color:rgba(0, 0, 0, 0.1);transform:translateY(-1px);box-shadow:0 4px 12px rgba(0, 0, 0, 0.06)}.dark .whats-new-banner,body.dark .whats-new-banner{background:rgba(255, 255, 255, 0.04);border-color:rgba(255, 255, 255, 0.08);box-shadow:0 1px 3px rgba(0, 0, 0, 0.3)}.dark .whats-new-banner:hover,body.dark .whats-new-banner:hover{background:rgba(255, 255, 255, 0.08);border-color:rgba(255, 255, 255, 0.12);box-shadow:0 4px 12px rgba(0, 0, 0, 0.4)}.whats-new-badge{display:inline-flex;align-items:center;justify-content:center;padding:3px 8px;background:linear-gradient(135deg, #10b981 0%, #059669 100%);color:white;font-size:10px;font-weight:700;letter-spacing:0.06em;border-radius:9999px;text-transform:uppercase;box-shadow:0 1px 2px rgba(16, 185, 129, 0.3)}.whats-new-text{color:#1f2937;font-weight:500;letter-spacing:-0.01em}.dark .whats-new-text,body.dark .whats-new-text{color:#f3f4f6}.whats-new-arrow{color:#9ca3af;font-size:14px;transition:transform 0.25s cubic-bezier(0.4, 0, 0.2, 1);opacity:0.7}.whats-new-banner:hover .whats-new-arrow{transform:translateX(2px);opacity:1}.dark .whats-new-arrow,body.dark .whats-new-arrow{color:#9ca3af}body[data-page=\"/\"] .whats-new-banner,body[data-page=\"\"] .whats-new-banner{display:flex;width:fit-content}@media (max-width: 640px){.whats-new-banner{padding:5px 12px 5px 5px;gap:6px;font-size:12px;margin-bottom:24px}.whats-new-badge{padding:2px 7px;font-size:9px}.whats-new-text{max-width:180px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.whats-new-arrow{font-size:12px}}.hero-mascot-overlay{position:fixed;top:0;left:0;right:0;bottom:0;width:100%;height:100%;display:flex;align-items:center;justify-content:center;pointer-events:none;z-index:0;overflow:hidden}.hero-mascot-overlay .hero-mascot-light,.hero-mascot-overlay .hero-mascot-dark{width:100%;height:100%;object-fit:cover;object-position:center top;transition:all 0.5s ease}.hero-mascot-overlay .hero-mascot-light{display:block;opacity:0.06}.hero-mascot-overlay .hero-mascot-dark{display:none}.dark .hero-mascot-overlay .hero-mascot-light,body.dark .hero-mascot-overlay .hero-mascot-light{display:none}.dark .hero-mascot-overlay .hero-mascot-dark,body.dark .hero-mascot-overlay .hero-mascot-dark{display:block;opacity:0.4;filter:drop-shadow(0 0 100px rgba(59, 130, 246, 0.6))\n\t\tdrop-shadow(0 0 200px rgba(139, 92, 246, 0.4))\n\t\tdrop-shadow(0 0 300px rgba(59, 130, 246, 0.3))}.dark .hero-mascot-overlay::before,body.dark .hero-mascot-overlay::before{content:\"\";position:absolute;top:50%;left:50%;transform:translate(-50%, -50%);width:150%;height:150%;background:radial-gradient(\n\t\tellipse at center,\n\t\trgba(59, 130, 246, 0.2) 0%,\n\t\trgba(139, 92, 246, 0.1) 25%,\n\t\trgba(59, 130, 246, 0.05) 40%,\n\t\ttransparent 60%\n\t);z-index:-1;animation:pulseGlow 8s ease-in-out infinite}@keyframes pulseGlow{0%,100%{opacity:1;transform:translate(-50%, -50%) scale(1)}50%{opacity:0.7;transform:translate(-50%, -50%) scale(1.05)}}@media (max-width: 640px){.hero-mascot-overlay .hero-mascot-light{opacity:0.05}.dark .hero-mascot-overlay .hero-mascot-dark,body.dark .hero-mascot-overlay .hero-mascot-dark{opacity:0.3}.hero-mascot-overlay .hero-mascot-light,.hero-mascot-overlay .hero-mascot-dark{-webkit-mask-image:radial-gradient(\n\t\t\tellipse 80% 80% at center,\n\t\t\tblack 40%,\n\t\t\ttransparent 70%\n\t\t);mask-image:radial-gradient(\n\t\t\tellipse 80% 80% at center,\n\t\t\tblack 40%,\n\t\t\ttransparent 70%\n\t\t)}}.dark .hero-mascot-overlay::after,body.dark .hero-mascot-overlay::after{content:\"\";position:absolute;top:0;left:0;right:0;bottom:0;background:rgba(0, 0, 0, 0.4);z-index:1;pointer-events:none}"},{"filePath":"styles/layout.css","content":"#navbar a[href=\"/\"] img,#navbar a[href=\"/\"] img{max-width:180px}@media (max-width: 1023px){#navbar button>div:last-child,#navbar button span,#navbar [aria-label=\"Open navigation\"]~div,#navbar [aria-label=\"Open navigation\"]~span,#navbar>div>div>button>div:not(:first-child),#navbar>.max-w-8xl button>div:not(:has(svg)):not(:first-child){display:none!important}#navbar button svg,#navbar button>div:first-child:has(svg){display:block!important}}#navbar>.max-w-8xl nav{display:none}@media screen and (min-width: 1024px){#navbar>.max-w-8xl nav{display:flex}}#navbar>.max-w-8xl>div>div>div>div{justify-content:end}#navbar>.max-w-8xl>div>div>div>div>.ml-auto{margin-left:0}#navbar>.max-w-8xl>div>div>div>div>.mx-px{width:25%;min-width:120px}#navbar>.max-w-8xl>div>div>div>div>div:first-child{margin-right:auto}#navigation-items h5{text-transform:uppercase;font-weight:normal;letter-spacing:0.05em;font-size:0.75rem;font-family:Inter, ui-sans-serif, sans-serif;color:rgb(134, 140, 152)}.no-hyphenate,.no-justify,.hero-gradient,.hero-gradient *,.hero-gradient h1,.hero-gradient p,.hero-gradient span,.hero-gradient div{hyphens:none!important;-webkit-hyphens:none!important;-moz-hyphens:none!important;-ms-hyphens:none!important;word-break:normal!important;overflow-wrap:normal!important;text-align:left!important;white-space:normal!important}.hero-gradient h1{word-break:keep-all!important;white-space:normal!important}@media (min-width: 768px) and (max-width: 1279px){.hero-gradient .flex-1{min-width:60%!important}}body[data-page=\"/\"] .hero-gradient *,body[data-page=\"\"] .hero-gradient *,body[data-page=\"/\"] .hero-gradient h1,body[data-page=\"\"] .hero-gradient h1,body[data-page=\"/\"] .hero-gradient p,body[data-page=\"\"] .hero-gradient p{text-align:left!important;hyphens:none!important;-webkit-hyphens:none!important;-moz-hyphens:none!important;-ms-hyphens:none!important;word-break:normal!important;overflow-wrap:normal!important;white-space:normal!important;text-justify:none!important}@media (min-width: 1280px){#toppie-container{max-width:320px!important;width:320px!important}}[class*=\"Card\"] p,[class*=\"card\"] p,pre,pre *,code,code *,table,table *,th,td{text-align:left!important;hyphens:none!important}"}]}
{"page":{"pagePath":"en/ad-platform/sdks/android","slug":"/en/ad-platform/sdks/android","pageMetadata":{"title":"Android","description":"Overview of Topsort's Kotlin library for auction requests and event tracking in Android applications","icon":"android","href":"/en/ad-platform/sdks/android"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Overview of Topsort’s Kotlin library for auction requests and event tracking in Android applications\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const IntegrationsCard1A=()=>{return _jsxs(_Fragment,{children:[_jsx(`style`,{children:`\n .integrations-card-1a {\n display: flex;\n flex-direction: column;\n background-color: #f0f2f4;\n border: 1px solid rgba(0, 0, 0, 0.08);\n border-radius: 12px;\n padding: 1.25rem 1.5rem;\n gap: 0.25rem;\n color: #25253b;\n box-shadow: 0 1px 3px rgba(0, 0, 0, 0.02);\n transition: box-shadow 0.2s ease, border-color 0.2s ease, transform 0.2s ease;\n margin-top: 2rem;\n }\n\n .integrations-card-1a:hover {\n box-shadow: 0 4px 12px rgba(0, 0, 0, 0.06);\n border-color: rgba(0, 0, 0, 0.12);\n }\n\n .dark .integrations-card-1a {\n background-color: #25253b;\n color: #f6f8fa;\n border-color: rgba(255, 255, 255, 0.08);\n box-shadow: 0 1px 3px rgba(0, 0, 0, 0.1);\n }\n\n .dark .integrations-card-1a:hover {\n box-shadow: 0 4px 12px rgba(0, 0, 0, 0.2);\n border-color: rgba(255, 255, 255, 0.12);\n }\n\n .integrations-card-1a-avatar-row {\n display: flex;\n margin-left: 14px;\n flex-wrap: nowrap;\n }\n\n .integrations-card-1a-avatar {\n width: 44px;\n height: 44px;\n border-radius: 50%;\n border: 2px solid #f0f2f4;\n margin-left: -14px;\n object-fit: cover;\n box-shadow: 0 2px 6px rgba(0, 0, 0, 0.08);\n pointer-events: none;\n cursor: default;\n }\n\n .dark .integrations-card-1a-avatar {\n border-color: #25253b;\n box-shadow: 0 2px 8px rgba(0, 0, 0, 0.2);\n }\n\n .integrations-card-1a h2 {\n margin: 0;\n line-height: 1.25;\n font-size: clamp(1.25rem, calc(0.875rem + 1.25vw), 1.75rem);\n font-weight: 700;\n letter-spacing: -0.025em;\n color: #111827;\n }\n\n .dark .integrations-card-1a h2 {\n color: #f9fafb;\n }\n\n .integrations-card-1a-subtitle {\n font-size: 0.9375rem;\n font-weight: 500;\n line-height: 1.5;\n color: #4b5563;\n margin: 0;\n }\n\n .dark .integrations-card-1a-subtitle {\n color: #d1d5db;\n }\n\n .integrations-card-1a p {\n margin: 0;\n line-height: 1.5;\n font-size: 0.875rem;\n color: #374151;\n }\n\n .dark .integrations-card-1a p {\n color: #d1d5db;\n }\n\n .integrations-card-1a a {\n color: #0074F7;\n text-decoration: none;\n font-weight: 500;\n transition: color 0.15s ease;\n }\n\n .integrations-card-1a a:hover {\n color: #01193A;\n }\n\n .dark .integrations-card-1a a {\n color: #8280ff;\n }\n\n .dark .integrations-card-1a a:hover {\n color: #a19fff;\n }\n\n @media (max-width: 640px) {\n .integrations-card-1a-avatar {\n width: 38px;\n height: 38px;\n margin-left: -12px;\n }\n\n .integrations-card-1a-avatar-row {\n margin-left: 12px;\n }\n }\n\n @media (min-width: 1280px) {\n .integrations-card-1a p {\n font-size: 0.6875rem;\n line-height: 1.4;\n letter-spacing: -0.01em;\n }\n\n .integrations-card-1a h2 {\n font-size: clamp(1rem, calc(0.75rem + 1vw), 1.25rem);\n }\n\n .integrations-card-1a-subtitle {\n font-size: 0.75rem;\n }\n }\n `}),_jsxs(`div`,{className:`integrations-card-1a`,children:[_jsxs(`div`,{className:`integrations-card-1a-avatar-row`,children:[_jsx(`img`,{src:`/images/integration-team/agustin.webp`,alt:`Agustin - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/amelia.webp`,alt:`Amelia - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/anais.webp`,alt:`Anais - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/bernardita.webp`,alt:`Bernardita - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/felipe.webp`,alt:`Felipe - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/gui.webp`,alt:`Gui - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/javiera.webp`,alt:`Javiera - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/linn.webp`,alt:`Linn - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/marc.webp`,alt:`Marc - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/marcio.webp`,alt:`Marcio - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/max.webp`,alt:`Max - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/natalie.webp`,alt:`Natalie - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/rodrigo.webp`,alt:`Rodrigo - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`}),_jsx(`img`,{src:`/images/integration-team/tomas.webp`,alt:`Tomás - Integrations Team Member`,loading:`lazy`,className:`integrations-card-1a-avatar`})]}),_jsx(`h2`,{children:`Need help with your Topsort integration?`}),_jsx(`p`,{className:`integrations-card-1a-subtitle`,children:`Talk to us, the integrations engineering team.`}),_jsxs(`p`,{children:[`Reach us via `,_jsx(`strong`,{children:`your dedicated messaging channel`}),` or at`,` `,_jsx(`a`,{href:`mailto:support@topsort.com`,children:`support@topsort.com`}),`.`]}),_jsxs(`p`,{children:[`If you're not a customer yet,`,` `,_jsx(`a`,{href:`https://www.topsort.com/book-a-demo`,children:`book a demo`}),` with our sales team instead.`]})]})]})};function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Topsort’s `,_jsx(_components.a,{href:`https://github.com/Topsort/topsort.kt`,children:`Kotlin library`}),` enables our clients to easily send auction requests and track events within Android applications.`]}),`\n`,_jsxs(Warning,{children:[`Minimum requirements: Java 11, Kotlin 2.1, `,_jsx(_components.code,{children:`minSdk`}),` 24 and `,_jsx(_components.code,{children:`compileSdk`}),` 36.`]}),`\n`,_jsx(Heading,{level:`2`,id:`installation`,children:`Installation`}),`\n`,_jsx(_components.p,{children:`Add the dependency to your build.gradle file:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`groovy`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`groovy`,children:_jsxs(_components.code,{language:`groovy`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`dependencies {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` implementation `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'com.topsort:topsort-kt:4.1.0'`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`setup`,children:`Setup`}),`\n`,_jsx(Heading,{level:`3`,id:`kotlin`,children:`Kotlin`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` android.app.Application`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.Analytics`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.UserIdentity`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` KotlinApplication`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` : `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`Application`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` override`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` fun`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` onCreate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` super`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`onCreate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Analytics.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`setup`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` application `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` this`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` identity `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` UserIdentity.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`of`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cYOUR_OPAQUE_USER_ID>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`),`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` token `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cAPI token>\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` )`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`UserIdentity.of`}),` turns a null or blank id into `,_jsx(_components.code,{children:`UserIdentity.Unidentified`}),`, in which case the SDK generates an id and keeps it across launches. Pass your own id whenever you have one, logged in or not. When a user logs in, call `,_jsx(_components.code,{children:`Analytics.setup`}),` again with `,_jsx(_components.code,{children:`UserIdentity.of(\u003ctheir id>)`}),` so events are reported under your own id. A generated id does not match your audiences.`]}),`\n`,_jsx(Heading,{level:`3`,id:`java`,children:`Java`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`java`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`java`,children:_jsxs(_components.code,{language:`java`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` android.app.Application;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.Analytics;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.UserIdentity;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`public`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` class`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` JavaApplication`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` extends`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4EC9B0`},children:` Application`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` @`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#4EC9B0`},children:`Override`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` public`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#4EC9B0`},children:` void`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` onCreate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` super`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`onCreate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` Analytics`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`INSTANCE`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`setup`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`this`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`UserIdentity`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`of`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003copaqueUserId>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`), `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cAPI token>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`reporting-events`,children:`Reporting Events`}),`\n`,_jsx(Heading,{level:`3`,id:`renders`,children:`Renders`}),`\n`,_jsx(_components.p,{children:`A render records that a sponsored ad was inserted into the page, separately from the impression, which records when the ad becomes visible. Renders are sponsored-only, so there is no organic variant.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.Analytics`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.Placement`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Analytics.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`reportRender`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` resolvedBidId `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cThe bid id from the auction winner>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` placement `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Placement`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(path `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"search_results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, position `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`To report several renders in one event, build them with `,_jsx(_components.code,{children:`Render.Factory`}),` and pass them to `,_jsx(_components.code,{children:`Analytics.reportRenders(list)`}),`. `,_jsx(_components.code,{children:`Render.Factory.build`}),` has no defaults for `,_jsx(_components.code,{children:`resolvedBidId`}),`, `,_jsx(_components.code,{children:`placement`}),`, `,_jsx(_components.code,{children:`occurredAt`}),` (an RFC 3339 timestamp), `,_jsx(_components.code,{children:`opaqueUserId`}),` and `,_jsx(_components.code,{children:`id`}),`, so pass them for each render, with a unique `,_jsx(_components.code,{children:`id`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`impressions`,children:`Impressions`}),`\n`,_jsx(_components.p,{children:`An impression records that an ad or product became visible to the shopper.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Analytics.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`reportImpressionPromoted`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` resolvedBidId `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cThe bid id from the auction winner>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` placement `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Placement`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(path `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"search_results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, position `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`For organic results, use `,_jsx(_components.code,{children:`Analytics.reportImpressionOrganic`}),` with `,_jsx(_components.code,{children:`entity = Entity(id = \"\u003cproduct id>\", type = EntityType.PRODUCT)`}),` instead of `,_jsx(_components.code,{children:`resolvedBidId`}),`. Import `,_jsx(_components.code,{children:`Entity`}),` and `,_jsx(_components.code,{children:`EntityType`}),` from `,_jsx(_components.code,{children:`com.topsort.analytics.model`}),`: the banner click callback uses a different `,_jsx(_components.code,{children:`EntityType`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`clicks`,children:`Clicks`}),`\n`,_jsx(_components.p,{children:`A click records that the shopper clicked an ad or product.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Analytics.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`reportClickPromoted`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` resolvedBidId `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cThe bid id from the auction winner>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` placement `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` Placement`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(path `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"search_results\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, position `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`For organic results, use `,_jsx(_components.code,{children:`Analytics.reportClickOrganic`}),` with an `,_jsx(_components.code,{children:`entity`}),`, as for impressions.`]}),`\n`,_jsx(Heading,{level:`3`,id:`purchases`,children:`Purchases`}),`\n`,_jsx(_components.p,{children:`A purchase records the products a shopper bought. Topsort attributes it to the ads the shopper interacted with.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.PurchasedItem`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`val`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` item `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` PurchasedItem`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` productId `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cMarketplace id for the item>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` unitPrice `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 13`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` quantity `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 20`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Analytics.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`reportPurchase`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` id `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"\u003cMarketplace id for the entire purchase>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` items `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` listOf`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(item),`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`unitPrice`}),` is required. It is the price of a single item in major units of your marketplace currency (`,_jsx(_components.code,{children:`13`}),` means 13.00), not cents. In version 4.1.0 it is an `,_jsx(_components.code,{children:`Int`}),`, so only whole amounts can be sent.`]}),`\n`,_jsx(Heading,{level:`3`,id:`page-views`,children:`Page Views`}),`\n`,_jsxs(_components.p,{children:[`A page view records that the shopper navigated to a page. The API requires a `,_jsx(_components.code,{children:`pageId`}),`.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.Page`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.PageType`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Analytics.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`reportPageView`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Page.Factory.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`buildWithId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(PageType.PDP, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cproduct id>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`event-delivery`,children:`Event delivery`}),`\n`,_jsx(_components.p,{children:`Reported events are stored on the device and sent in the background. They are retried after failures and across app launches. The SDK drops an event only if the API rejects it with a 4xx error (429 and 408 are retried), if the cache grows past 5,000 events and the oldest are evicted, or if a stored event can no longer be read. To count dropped events, register a listener:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.EventDiscardListener`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`Analytics.eventDiscardListener `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` EventDiscardListener`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { reason, count `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`->`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` Log.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`w`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Topsort\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Discarded `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:`$count`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` events: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`reason.name`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The listener runs on the SDK’s worker thread, so keep it quick.`}),`\n`,_jsx(Heading,{level:`2`,id:`sponsored-listings-auctions`,children:`Sponsored Listings Auctions`}),`\n`,_jsxs(_components.p,{children:[`Run an auction for products, a category or a search keyword, then report events with the `,_jsx(_components.code,{children:`resolvedBidId`}),` of each winner.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`22`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`22`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.auctions.Auction`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.auctions.AuctionConfig`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.auctions.AuctionError`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.model.auctions.AuctionRequest`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`import`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#D4D4D4`},children:` com.topsort.analytics.service.TopsortAuctionsHttpService`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`val`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` config `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` AuctionConfig.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`ProductIds`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` numSlots `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ids `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` listOf`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cproduct id 1>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cproduct id 2>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cproduct id 3>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`val`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` request `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` AuctionRequest`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`listOf`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(Auction.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`fromConfig`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(config)))`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`try`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` val`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` TopsortAuctionsHttpService.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`runAuctions`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(request) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// suspend function`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` response.results.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`forEach`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { result `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`->`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` result.winners.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`forEach`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { winner `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`->`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // winner.id is the product id, winner.resolvedBidId goes on impressions and clicks`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`} `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`catch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (e: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`AuctionError`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) {`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` // HttpError, DeserializationError, EmptyResponse, SerializationError or InvalidNumberAuctions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Other configs are `,_jsx(_components.code,{children:`AuctionConfig.CategorySingle`}),`, `,_jsx(_components.code,{children:`CategoryMultiple`}),`, `,_jsx(_components.code,{children:`CategoryDisjunctions`}),` and `,_jsx(_components.code,{children:`Keyword`}),`. All of them accept `,_jsx(_components.code,{children:`opaqueUserId`}),` and `,_jsx(_components.code,{children:`placementId`}),` (1 to 8).`]}),`\n`,_jsx(Heading,{level:`2`,id:`banner-ads`,children:`Banner Ads`}),`\n`,_jsx(_components.p,{children:`Add BannerView to your activity XML:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`xml`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`xml`,children:_jsxs(_components.code,{language:`xml`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`com.topsort.analytics.banners.BannerView`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` android:id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"@+id/bannerView\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` android:layout_width`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"353dp\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#9CDCFE`},children:` android:layout_height`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"103dp\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#808080`},children:` />`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Setup in your activity:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`17`,language:`kotlin`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`kotlin`,children:_jsxs(_components.code,{language:`kotlin`,numberOfLines:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`class`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:` SampleActivity`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` : `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`AppCompatActivity`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`() {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` override`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` fun`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` onCreate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(savedInstanceState: `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`Bundle`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?) {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` super`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`onCreate`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(savedInstanceState)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` setContentView`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(R.layout.sample_activity)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` this`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.lifecycleScope.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`launch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` val`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` bannerView `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` findViewById`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`\u003c`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#4EC9B0`},children:`BannerView`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`>(R.id.bannerView)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` val`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` bannerConfig `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` BannerConfig.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`CategorySingle`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(slotId `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"slot\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, category `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"category\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` bannerView.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`setup`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` config `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` bannerConfig,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` path `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sample_activity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` location `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"hero-banner\"`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ) { id, entityType `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`->`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` onBannerClick`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(id, entityType) }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`BannerView`}),` reports the render as soon as the winner is displayed, the impression once the banner is on screen, and the click when it is tapped. Do not report these events yourself for banners it displays.`]}),`\n`,_jsxs(_components.p,{children:[`For full documentation, see the `,_jsx(_components.a,{href:`https://github.com/Topsort/topsort.kt`,children:`GitHub repository`}),`.`]}),`\n`,_jsx(_MdxComponentBoundary,{name:`IntegrationsCard1A`,children:_jsx(IntegrationsCard1A,{})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{IntegrationsCard1A,default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Android","description":"Overview of Topsort's Kotlin library for auction requests and event tracking in Android applications","icon":"android","href":"/en/ad-platform/sdks/android"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[157,6561,"null;function _creat"]]},"mdxExtracts":{"tableOfContents":[{"title":"Installation","slug":"installation","depth":2,"children":[]},{"title":"Setup","slug":"setup","depth":2,"children":[{"title":"Kotlin","slug":"kotlin","depth":3,"children":[]},{"title":"Java","slug":"java","depth":3,"children":[]}]},{"title":"Reporting Events","slug":"reporting-events","depth":2,"children":[{"title":"Renders","slug":"renders","depth":3,"children":[]},{"title":"Impressions","slug":"impressions","depth":3,"children":[]},{"title":"Clicks","slug":"clicks","depth":3,"children":[]},{"title":"Purchases","slug":"purchases","depth":3,"children":[]},{"title":"Page Views","slug":"page-views","depth":3,"children":[]},{"title":"Event delivery","slug":"event-delivery","depth":3,"children":[]}]},{"title":"Sponsored Listings Auctions","slug":"sponsored-listings-auctions","depth":2,"children":[]},{"title":"Banner Ads","slug":"banner-ads","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/topsort/09718a6f70d44fb9/script.js","/_mintlify/custom/topsort/a2737410d4bd3017/scripts/changelog.js","/_mintlify/custom/topsort/c221a91f929cbe9b/scripts/feedback.js","/_mintlify/custom/topsort/33370d8ce5a05e5f/scripts/navigation.js","/_mintlify/custom/topsort/9cf111fe133b8824/scripts/posthog.js","/_mintlify/custom/topsort/94892506942e7b4b/scripts/text-justification.js","/_mintlify/custom/topsort/b4af3c4b8b4bddb8/scripts/video-background.js","/_mintlify/custom/topsort/46198aa544856623/scripts/vibrate-mode.js","/_mintlify/custom/topsort/d6941d8316377689/scripts/config/shared-config.js","/_mintlify/custom/topsort/26f120bf7d7a509e/scripts/core/constants.js","/_mintlify/custom/topsort/6e2a33614b4731db/scripts/core/events.js","/_mintlify/custom/topsort/ca947aeeddcda685/scripts/core/logger.js","/_mintlify/custom/topsort/65cfa18e15b22281/scripts/custom-branding.js","/_mintlify/custom/topsort/f1cb191933428051/scripts/goodies-menu.js","/_mintlify/custom/topsort/a7b559fc1810dccf/scripts/toppie.js"],"subdomain":"topsort","siteName":"Topsort Documentation","title":"Android - Topsort Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/ad-platform/sdks/android","matchLevel":0},"es":{"href":"/es/ad-platform/sdks/android","matchLevel":1},"pt":{"href":"/pt/ad-platform/sdks/android","matchLevel":1},"fr":{"href":"/fr/ad-platform/sdks/android","matchLevel":1},"de":{"href":"/de/ad-platform/sdks/android","matchLevel":1}}},"lastModified":"2026-11-18T21:48:54.662Z","originalFileLocation":"en/ad-platform/sdks/android.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Overview of Topsort\u0026#x27;s Kotlin library for auction requests and event tracking in Android applications\">\u003cmeta data-mint-head name=\"application-name\" content=\"Topsort Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Android - Topsort Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Overview of Topsort\u0026#x27;s Kotlin library for auction requests and event tracking in Android applications\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Topsort Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.topsort.com/en/ad-platform/sdks/android\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://topsort.mintlify.site/_mintlify/api/og/v2?division=SDKs\u0026amp;title=Android\u0026amp;description=Overview+of+Topsort%27s+Kotlin+library+for+auction+requests+and+event+tracking+in+Android+applications\u0026amp;theme=ec0cb5145d1faab01b0dda03\u0026amp;signature=5e2db79882b56c5e44158f15d254f3f081a182743ed579e45b6d13dddb0e60ee\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Android - Topsort Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Overview of Topsort\u0026#x27;s Kotlin library for auction requests and event tracking in Android applications\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://topsort.mintlify.site/_mintlify/api/og/v2?division=SDKs\u0026amp;title=Android\u0026amp;description=Overview+of+Topsort%27s+Kotlin+library+for+auction+requests+and+event+tracking+in+Android+applications\u0026amp;theme=ec0cb5145d1faab01b0dda03\u0026amp;signature=5e2db79882b56c5e44158f15d254f3f081a182743ed579e45b6d13dddb0e60ee\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/topsort/TELuk3ooLLcs9DrZ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Topsort Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0074F7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.topsort.com/en/ad-platform/sdks/android\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/ad-platform/sdks/android.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.topsort.com/en/ad-platform/sdks/android\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.topsort.com/es/ad-platform/sdks/android\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.topsort.com/pt/ad-platform/sdks/android\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.topsort.com/fr/ad-platform/sdks/android\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.topsort.com/de/ad-platform/sdks/android\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.topsort.com/en/ad-platform/sdks/android\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.topsort.com/#organization\",\"name\":\"Topsort Documentation\",\"url\":\"https://docs.topsort.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/topsort/FdGgIIxdnNXimeCi/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=FdGgIIxdnNXimeCi\u0026q=85\u0026s=52335392d5233f0542050e8af5c24ef4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.topsort.com#website\",\"name\":\"Topsort Documentation\",\"url\":\"https://docs.topsort.com\",\"publisher\":{\"@id\":\"https://docs.topsort.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.topsort.com/en/ad-platform/sdks/android#webpage\",\"url\":\"https://docs.topsort.com/en/ad-platform/sdks/android\",\"name\":\"Android\",\"description\":\"Overview of Topsort's Kotlin library for auction requests and event tracking in Android applications\",\"dateModified\":\"2026-11-18T21:48:54.662Z\",\"isPartOf\":{\"@id\":\"https://docs.topsort.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.topsort.com/en/ad-platform/sdks/android#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.topsort.com/en/ad-platform/sdks/android#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ad Platform\",\"item\":\"https://docs.topsort.com/en/ad-platform\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"SDKs\",\"item\":\"https://docs.topsort.com/en/ad-platform/sdks/javascript-sdk\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Android\",\"item\":\"https://docs.topsort.com/en/ad-platform/sdks/android\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.topsort.com/en/ad-platform/sdks/android#article\",\"headline\":\"Android\",\"name\":\"Android\",\"description\":\"Overview of Topsort's Kotlin library for auction requests and event tracking in Android applications\",\"url\":\"https://docs.topsort.com/en/ad-platform/sdks/android\",\"mainEntityOfPage\":{\"@id\":\"https://docs.topsort.com/en/ad-platform/sdks/android#webpage\"},\"dateModified\":\"2026-11-18T21:48:54.662Z\",\"publisher\":{\"@id\":\"https://docs.topsort.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.topsort.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Topsort Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Topsort Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/ad-platform/sdks/android.md","siteName":"Topsort Documentation","nav":{"global":null,"languages":[{"language":"en","tabs":[{"tab":"API Reference","icon":"square-terminal","pages":[{"title":"API Reference","href":"/en/api-reference/introduction"}]},{"tab":"Integration Guide","icon":"plug","groups":[{"group":"Overview","icon":"eye","pages":[{"title":"Welcome to Topsort","icon":"house","href":"/en/overview"},{"title":"Integration Overview","icon":"map","href":"/en/overview/integration-overview"},{"title":"Pick an integration path","icon":"route","href":"/en/overview/pick-an-integration-path"},{"title":"Getting Started","icon":"rocket","href":"/en/overview/getting-started"},{"title":"Going Live","icon":"circle-check","href":"/en/overview/going-live"},{"title":"Glossary","icon":"book","href":"/en/overview/glossary"}]},{"group":"Ad Platform","icon":"rectangle-ad","pages":[{"title":"Ad Platform | Standard Integration","icon":"book-open","href":"/en/ad-platform/index"},{"group":"Banners","icon":"flag","pages":[{"title":"Banners.js","icon":"code","href":"/en/ad-platform/banners/bannersjs"},{"title":"Third-party verification helper library","icon":"code","href":"/en/ad-platform/banners/third-party-verification"},{"title":"Google Tag Manager (GTM)","icon":"tag","href":"/en/ad-platform/banners/google-tag-manager"}]},{"group":"Listings","icon":"list","pages":[{"title":"Product Feed","icon":"rss","href":"/en/ad-platform/listings/product-feed"},{"title":"Topsort Proxy","icon":"bolt","href":"/en/ad-platform/listings/topsort-proxy"},{"title":"Analytics.js","icon":"code","href":"/en/ad-platform/listings/analytics-js"}]},{"group":"SDKs","icon":"code","pages":[{"title":"JavaScript SDK","icon":"code","href":"/en/ad-platform/sdks/javascript-sdk"},{"title":"iOS","description":"Integrate Topsort's Swift library for auction requests and event tracking in mobile applications","icon":"apple","href":"/en/ad-platform/sdks/ios"},{"title":"Android","icon":"android","href":"/en/ad-platform/sdks/android"},{"title":"Topsort.php","description":"A PHP Software Development Kit for interacting with the auctions and events endpoints","icon":"php","href":"/en/ad-platform/sdks/topsort-php"}]},{"group":"Plugins","icon":"plug","pages":[{"title":"VTEX","icon":"plug","href":"/en/ad-platform/plugins/vtex"},{"title":"Salesforce","icon":"cloud","href":"/en/ad-platform/plugins/salesforce"}]}]},{"group":"Ad Server","icon":"server","pages":[{"title":"Ad Server | Full API Integration","icon":"book-open","href":"/en/ad-server/index"},{"title":"End-to-End API Example","icon":"file-code","href":"/en/ad-server/e2e-api-example"},{"group":"Catalog","icon":"box","pages":[{"title":"Catalog Integration","icon":"box","href":"/en/ad-server/catalog/index"},{"title":"Product Feed","icon":"rss","href":"/en/ad-server/catalog/product-feed"}]},{"group":"Auctions","icon":"gavel","pages":[{"title":"Auctions API","icon":"gavel","href":"/en/ad-server/auctions/auctions-api"},{"title":"Algolia","icon":"database","href":"/en/ad-server/auctions/algolia"}]},{"group":"Events","icon":"chart-line","pages":[{"title":"Events API","icon":"chart-line","href":"/en/ad-server/events/events-api"},{"title":"RudderStack","icon":"database","href":"/en/ad-server/events/rudderstack"},{"title":"Twilio Segment","icon":"database","href":"/en/ad-server/events/twilio-segment"}]},{"group":"Additional APIs","icon":"puzzle-piece","pages":[{"title":"Assets API","icon":"images","href":"/en/ad-server/additional-apis/assets-api"},{"title":"Billing API","icon":"credit-card","href":"/en/ad-server/additional-apis/billing"},{"title":"Digital Services Act (DSA) Setup","icon":"scale-balanced","href":"/en/ad-server/additional-apis/digital-services-act"},{"title":"Campaign API","icon":"megaphone","href":"/en/ad-server/additional-apis/campaign-api"},{"title":"Invitation API","icon":"envelope","href":"/en/ad-server/additional-apis/invitation-api"},{"title":"Offsite Ads API","icon":"globe","href":"/en/ad-server/additional-apis/offsite"},{"title":"Reporting API","icon":"chart-bar","href":"/en/ad-server/additional-apis/reporting-api"},{"title":"Asynchronous Exports","icon":"download","href":"/en/ad-server/additional-apis/export-api"},{"title":"Segments API","icon":"layer-group","href":"/en/ad-server/additional-apis/segments-api"},{"title":"User API","icon":"user","href":"/en/ad-server/additional-apis/user-api"},{"title":"Webhooks API","icon":"webhook","href":"/en/ad-server/additional-apis/webhooks-api"}]}]},{"group":"Toppie","icon":"chart-network","pages":[{"title":"About Toppie","icon":"chart-network","href":"/en/toppie/index"},{"title":"Getting Access","icon":"key","href":"/en/toppie/getting-access"},{"title":"Creating a Campaign","icon":"rocket","href":"/en/toppie/creating-a-campaign"},{"title":"Toppie API","icon":"code","href":"/en/toppie/toppie-api"}]},{"group":"Advanced Integrations","icon":"flask","pages":[{"title":"Fallback and A/B Testing","icon":"flask","href":"/en/advanced-integrations/index"}]},{"group":"API","icon":"code","pages":[{"title":"Documentation MCP Server","icon":"robot","href":"/en/api/mcp"},{"title":"Analytics MCP Server","icon":"chart-line","href":"/en/api/mcp-analytics"}]}]},{"tab":"Knowledge Base","icon":"book-open","pages":[{"title":"Knowledge Base","href":"/en/knowledge-base"}]},{"tab":"Changelog","icon":"clock","pages":[{"title":"Changelog","href":"/en/changelog"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/ad-platform/sdks/android"}]},{"language":"pt","pages":[{"title":"pt","href":"/pt/ad-platform/sdks/android"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/ad-platform/sdks/android"}]},{"language":"de","pages":[{"title":"de","href":"/de/ad-platform/sdks/android"}]}]},"basePath":"","title":"Android - Topsort Documentation","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}