From ac3151b145409d1045d0f3f4543ff0644d32f764 Mon Sep 17 00:00:00 2001 From: "david.lanchava@constructor.io" Date: Wed, 6 Aug 2025 09:33:35 +0300 Subject: [PATCH 1/2] Add sponsored tracking to the readme --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index d98474f8..8ce22145 100755 --- a/README.md +++ b/README.md @@ -542,6 +542,16 @@ ConstructorIo.trackSearchResultClick("Fashionable Toothpicks", "1234567-AB", "to ConstructorIo.trackSearchResultClick("Fashionable Toothpicks", "1234567-AB", "RED", "tooth", "Products", "179b8a0e-3799-4a31-be87-127b06871de2") ``` +### Sponsored Search Events +Sponsored results can be identified by `is_retail_media = true` label +```kotlin +// Track when sponsored search results are loaded into view. +ConstructorIo.trackSearchResultsLoaded(term = "tooth", resultCount = 789, items = arrayOf(TrackingItem("item-1", "variation-1", "campaign-1", "owner-1")) + +// Track when a search result is clicked (itemName, customerId, searchTerm, sectionName, resultId) +ConstructorIo.trackSearchResultClick(itemName = "Fashionable Toothpicks", customerId = "1234567-AB", searchTerm = "tooth", slCampaignId = "campaign-1", slCampaignOwner = "owner-1") +``` + ### Browse Events ```kotlin @@ -560,6 +570,16 @@ ConstructorIo.trackBrowseResultClick("group_id", "Snacks", "7654321-BA", "4", "P ConstructorIo.trackBrowseResultClick("group_id", "Snacks", "7654321-BA", "RED", "4", "Products", "179b8a0e-3799-4a31-be87-127b06871de2") ``` +### Sponsored Browse Events +Sponsored results can be identified by `is_retail_media = true` label +```kotlin +// Track when browse results are loaded into view +ConstructorIo.trackBrowseResultsLoaded(filterName = "group_id", filterValue = "Snacks", items = arrayOf(TrackingItem("item-1", "variation-1", "campaign-1", "owner-1")), resultCount = 674) + +// Track when a browse result is clicked +ConstructorIo.trackBrowseResultClick(filterName = "group_id", filterValue = "Snacks", customerId = "7654321-BA", "4", slCampaignId = "campaign-1", slCampaignOwner = "owner-1") +``` + ### Recommendation Events ```kotlin From 36d8c74754d8ac935766c730041c423f5ad6a0c7 Mon Sep 17 00:00:00 2001 From: "david.lanchava@constructor.io" Date: Wed, 6 Aug 2025 11:07:44 +0300 Subject: [PATCH 2/2] Small fixes --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 8ce22145..8b45b31e 100755 --- a/README.md +++ b/README.md @@ -548,7 +548,7 @@ Sponsored results can be identified by `is_retail_media = true` label // Track when sponsored search results are loaded into view. ConstructorIo.trackSearchResultsLoaded(term = "tooth", resultCount = 789, items = arrayOf(TrackingItem("item-1", "variation-1", "campaign-1", "owner-1")) -// Track when a search result is clicked (itemName, customerId, searchTerm, sectionName, resultId) +// Track when a sponsored search result is clicked ConstructorIo.trackSearchResultClick(itemName = "Fashionable Toothpicks", customerId = "1234567-AB", searchTerm = "tooth", slCampaignId = "campaign-1", slCampaignOwner = "owner-1") ``` @@ -573,10 +573,10 @@ ConstructorIo.trackBrowseResultClick("group_id", "Snacks", "7654321-BA", "RED", ### Sponsored Browse Events Sponsored results can be identified by `is_retail_media = true` label ```kotlin -// Track when browse results are loaded into view +// Track when sponsored browse results are loaded into view ConstructorIo.trackBrowseResultsLoaded(filterName = "group_id", filterValue = "Snacks", items = arrayOf(TrackingItem("item-1", "variation-1", "campaign-1", "owner-1")), resultCount = 674) -// Track when a browse result is clicked +// Track when a sponsored browse result is clicked ConstructorIo.trackBrowseResultClick(filterName = "group_id", filterValue = "Snacks", customerId = "7654321-BA", "4", slCampaignId = "campaign-1", slCampaignOwner = "owner-1") ```