library/io.constructor.core/ConstructorIo

ConstructorIo

The Constructor SDK client used for getting results and tracking behavioural data.

Functions

fun getAutocompleteResults(request: AutocompleteRequest): Observable<ConstructorData<AutocompleteResponse>>

Returns a list of autocomplete suggestions utilizing a request object.

fun getAutocompleteResults( term: String, facets: List<Pair<String, List<String>>>? = null, groupId: Int? = null, hiddenFields: List<String>? = null, variationsMap: VariationsMap? = null, sectionFacets: Map<String, List<Pair<String, List<String>>>>? = null): Observable<ConstructorData<AutocompleteResponse>>

Returns a list of autocomplete suggestions.

getAutocompleteResultsCRT

suspend fun getAutocompleteResultsCRT( term: String, facets: List<Pair<String, List<String>>>? = null, groupId: Int? = null, hiddenFields: List<String>? = null, variationsMap: VariationsMap? = null, sectionFacets: Map<String, List<Pair<String, List<String>>>>? = null): AutocompleteResponse

Returns a list of autocomplete suggestions. This function should be called within a coroutine scope.

getBrowseFacetOptions

fun getBrowseFacetOptions(request: BrowseFacetOptionsRequest): Observable<ConstructorData<BrowseFacetOptionsResponse>>

Returns a list of browse facet options utilizing a request object.

fun getBrowseFacetOptions(facetName: String, showHiddenFacets: Boolean? = null): Observable<ConstructorData<BrowseFacetOptionsResponse>>

Returns a list of browse facet options results.

getBrowseFacetOptionsCRT

suspend fun getBrowseFacetOptionsCRT(facetName: String, showHiddenFacets: Boolean? = null): BrowseFacetOptionsResponse

Returns a list of browse facet options results. This function should be called within a coroutine scope.

getBrowseFacets

fun getBrowseFacets(request: BrowseFacetsRequest): Observable<ConstructorData<BrowseFacetsResponse>>

Returns a list of browse facet results utilizing a request object.

fun getBrowseFacets( page: Int? = null, perPage: Int? = null, offset: Int? = null, showHiddenFacets: Boolean? = null): Observable<ConstructorData<BrowseFacetsResponse>>

Returns a list of browse facet results.

getBrowseFacetsCRT

suspend fun getBrowseFacetsCRT( page: Int? = null, perPage: Int? = null, offset: Int? = null, showHiddenFacets: Boolean? = null): BrowseFacetsResponse

Returns a list of browse facets results. This function should be called within a coroutine scope.

getBrowseGroups

fun getBrowseGroups(request: BrowseGroupsRequest): Observable<ConstructorData<BrowseGroupsResponse>>

Returns a list of browse groups results utilizing a request object.

fun getBrowseGroups(groupId: String? = null, groupsMaxDepth: Int? = null): Observable<ConstructorData<BrowseGroupsResponse>>

Returns a list of browse groups results.

getBrowseGroupsCRT

suspend fun getBrowseGroupsCRT(groupId: String? = null, groupsMaxDepth: Int? = null): BrowseGroupsResponse

Returns a list of browse groups results. This function should be called within a coroutine scope.

getBrowseItemsResults

fun getBrowseItemsResults(request: BrowseItemsRequest): Observable<ConstructorData<BrowseResponse>>

Returns a list of browse results from a list of item IDs including filters, categories, sort options, etc. utilizing a request object.

getBrowseItemsResultsCRT

suspend fun getBrowseItemsResultsCRT( itemIds: List<String>, facets: List<Pair<String, List<String>>>? = null, page: Int? = null, perPage: Int? = null, groupId: Int? = null, sortBy: String? = null, sortOrder: String? = null, sectionName: String? = null, hiddenFields: List<String>? = null, hiddenFacets: List<String>? = null, groupsSortBy: String? = null, groupsSortOrder: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, fmtOptions: Map<String, Any>? = null): BrowseResponse

Returns a list of browse results from a list of item IDs including filters, categories, sort options, etc. This function should be called within a coroutine scope.

getBrowseResults

fun getBrowseResults(request: BrowseRequest): Observable<ConstructorData<BrowseResponse>>

Returns a list of browse results including filters, categories, sort options, etc. utilizing a request object.

fun getBrowseResults( filterName: String, filterValue: String, facets: List<Pair<String, List<String>>>? = null, page: Int? = null, perPage: Int? = null, groupId: Int? = null, sortBy: String? = null, sortOrder: String? = null, sectionName: String? = null, hiddenFields: List<String>? = null, hiddenFacets: List<String>? = null, groupsSortBy: String? = null, groupsSortOrder: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, fmtOptions: Map<String, Any>? = null): Observable<ConstructorData<BrowseResponse>>

Returns a list of browse results including filters, categories, sort options, etc.

getBrowseResultsCRT

suspend fun getBrowseResultsCRT( filterName: String, filterValue: String, facets: List<Pair<String, List<String>>>? = null, page: Int? = null, perPage: Int? = null, groupId: Int? = null, sortBy: String? = null, sortOrder: String? = null, sectionName: String? = null, hiddenFields: List<String>? = null, hiddenFacets: List<String>? = null, groupsSortBy: String? = null, groupsSortOrder: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, fmtOptions: Map<String, Any>? = null): BrowseResponse

Returns a list of browse results including filters, categories, sort options, etc. This function should be called within a coroutine scope.

getClientId

fun getClientId(): String

Returns the current client identifier (a random GUID assigned to the app running on the device)

getQuizNextQuestion

fun getQuizNextQuestion(request: QuizRequest): Observable<ConstructorData<QuizQuestionResponse>>

Returns the next quiz question including options and attributes utilizing a request object.

fun getQuizNextQuestion( quizId: String, answers: List<List<String>>? = null, quizVersionId: String? = null, quizSessionId: String? = null, sectionName: String? = null): Observable<ConstructorData<QuizQuestionResponse>>

Returns the next quiz question including options and attributes.

getQuizNextQuestionCRT

suspend fun getQuizNextQuestionCRT( quizId: String, answers: List<List<String>>? = null, quizVersionId: String? = null, quizSessionId: String? = null, sectionName: String? = null): QuizQuestionResponse

Return the next quiz question including options and attributes. This function should be called within a coroutine scope.

getQuizResults

fun getQuizResults(request: QuizRequest): Observable<ConstructorData<QuizResultsResponse>>

Return a list of quiz results utilizing a request object.

fun getQuizResults( quizId: String, answers: List<List<String>>? = null, quizVersionId: String? = null, quizSessionId: String? = null, sectionName: String? = null, filters: Map<String, List<String>>? = null, page: Int? = null, perPage: Int? = null): Observable<ConstructorData<QuizResultsResponse>>

Return a list of quiz results.

getQuizResultsCRT

suspend fun getQuizResultsCRT( quizId: String, answers: List<List<String>>? = null, quizVersionId: String? = null, quizSessionId: String? = null, sectionName: String? = null, filters: Map<String, List<String>>? = null, page: Int? = null, perPage: Int? = null): QuizResultsResponse

Return a list of quiz results. This function should be called within a coroutine scope.

getRecommendationResults

fun getRecommendationResults(request: RecommendationsRequest): Observable<ConstructorData<RecommendationsResponse>>

fun getRecommendationResults( podId: String, facets: List<Pair<String, List<String>>>? = null, numResults: Int? = null, sectionName: String? = null, itemId: String? = null, term: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, hiddenFields: List<String>? = null): Observable<ConstructorData<RecommendationsResponse>>

Returns a list of recommendation results for the specified pod.

getRecommendationResultsCRT

suspend fun getRecommendationResultsCRT( podId: String, facets: List<Pair<String, List<String>>>? = null, numResults: Int? = null, sectionName: String? = null, itemId: String? = null, term: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, hiddenFields: List<String>? = null): RecommendationsResponse

Returns a list of recommendation results including filters, categories, sort options, etc.

getSearchResults

fun getSearchResults(request: SearchRequest): Observable<ConstructorData<SearchResponse>>

Returns a list of search results including filters, categories, sort options, etc. utilizing a request object.

fun getSearchResults( term: String, facets: List<Pair<String, List<String>>>? = null, page: Int? = null, perPage: Int? = null, groupId: Int? = null, sortBy: String? = null, sortOrder: String? = null, sectionName: String? = null, hiddenFields: List<String>? = null, hiddenFacets: List<String>? = null, groupsSortBy: String? = null, groupsSortOrder: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, fmtOptions: Map<String, Any>? = null): Observable<ConstructorData<SearchResponse>>

Returns a list of search results including filters, categories, sort options, etc.

getSearchResultsCRT

suspend fun getSearchResultsCRT( term: String, facets: List<Pair<String, List<String>>>? = null, page: Int? = null, perPage: Int? = null, groupId: Int? = null, sortBy: String? = null, sortOrder: String? = null, sectionName: String? = null, hiddenFields: List<String>? = null, hiddenFacets: List<String>? = null, groupsSortBy: String? = null, groupsSortOrder: String? = null, variationsMap: VariationsMap? = null, preFilterExpression: String? = null, fmtOptions: Map<String, Any>? = null): SearchResponse

Returns a list of search results including filters, categories, sort options, etc. This function should be called within a coroutine scope.

getSessionId

fun getSessionId(): Int

Returns the current session identifier (an incrementing integer)

init

fun init(context: Context?, constructorIoConfig: ConstructorIoConfig)

Initializes the client

setClientId

fun setClientId(clientId: String)

Sets the clientId

setSessionId

fun setSessionId(sessionId: Int)

Sets the sessionId

trackAutocompleteSelect

fun trackAutocompleteSelect( searchTerm: String, originalQuery: String, sectionName: String, resultGroup: ResultGroup? = null, resultID: String? = null, itemID: String? = null)

Tracks autocomplete select events.

trackBrowseResultClick

fun trackBrowseResultClick( filterName: String, filterValue: String, customerId: String, resultPositionOnPage: Int, sectionName: String? = null, resultID: String? = null, analyticsTags: Map<String, String>? = null, slCampaignId: String? = null, slCampaignOwner: String? = null)

fun trackBrowseResultClick( filterName: String, filterValue: String, customerId: String, variationId: String, resultPositionOnPage: Int, sectionName: String? = null, resultID: String? = null, analyticsTags: Map<String, String>? = null, slCampaignId: String? = null, slCampaignOwner: String? = null)

Tracks browse result click events.

trackBrowseResultsLoaded

fun trackBrowseResultsLoaded(request: BrowseResultsLoadedData)

Tracks browse result loaded (a.k.a. browse results viewed) events, with support for the result ID, pagination, sorting and selected filters of the browse results.

fun trackBrowseResultsLoaded( filterName: String, filterValue: String, resultCount: Int, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null)

fun trackBrowseResultsLoaded( filterName: String, filterValue: String, items: Array<TrackingItem>, resultCount: Int, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null)

~~fun~~ ~~trackBrowseResultsLoaded~~( filterName: String, filterValue: String, itemIds: Array<String>, resultCount: Int, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null)

Tracks browse result loaded (a.k.a. browse results viewed) events.

trackConversion

fun trackConversion( itemName: String, customerId: String, revenue: Double?, searchTerm: String = Constants.QueryConstants.TERM_UNKNOWN, sectionName: String? = null, conversionType: String? = null, isCustomType: Boolean? = null, displayName: String? = null, analyticsTags: Map<String, String>? = null)

fun trackConversion( itemName: String, customerId: String, variationId: String?, revenue: Double?, searchTerm: String = Constants.QueryConstants.TERM_UNKNOWN, sectionName: String? = null, conversionType: String? = null, isCustomType: Boolean? = null, displayName: String? = null, analyticsTags: Map<String, String>? = null)

Tracks conversion (a.k.a add to cart) events.

trackGenericResultClick

fun trackGenericResultClick( itemName: String, customerId: String, variationId: String? = null, sectionName: String? = null, analyticsTags: Map<String, String>? = null)

Tracks generic result click events.

trackInputFocus

fun trackInputFocus(term: String?)

Tracks input focus events.

trackItemDetailLoaded

fun trackItemDetailLoaded( itemName: String, customerId: String, variationId: String? = null, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null)

Tracks item result loaded events.

trackMediaImpressionClick

fun trackMediaImpressionClick( bannerAdId: String, placementId: String, analyticsTags: Map<String, String>? = null)

Tracks media impression click events.

trackMediaImpressionView

fun trackMediaImpressionView( bannerAdId: String, placementId: String, analyticsTags: Map<String, String>? = null)

Tracks media impression view events.

trackProductInsightsAgentAnswerFeedback

fun trackProductInsightsAgentAnswerFeedback(request: ProductInsightsAgentAnswerFeedbackTrackingData)

Tracks Product Insights Agent answer feedback events.

trackProductInsightsAgentAnswerView

fun trackProductInsightsAgentAnswerView(request: ProductInsightsAgentAnswerViewTrackingData)

Tracks Product Insights Agent answer view events.

trackProductInsightsAgentFocus

fun trackProductInsightsAgentFocus(request: ProductInsightsAgentFocusTrackingData)

Tracks Product Insights Agent focus events.

trackProductInsightsAgentOutOfView

fun trackProductInsightsAgentOutOfView(request: ProductInsightsAgentOutOfViewTrackingData)

Tracks Product Insights Agent out of view events.

trackProductInsightsAgentQuestionClick

fun trackProductInsightsAgentQuestionClick(request: ProductInsightsAgentQuestionClickTrackingData)

Tracks Product Insights Agent question click events.

trackProductInsightsAgentQuestionSubmit

fun trackProductInsightsAgentQuestionSubmit(request: ProductInsightsAgentQuestionSubmitTrackingData)

Tracks Product Insights Agent question submit events.

trackProductInsightsAgentResultClick

fun trackProductInsightsAgentResultClick(request: ProductInsightsAgentResultClickTrackingData)

Tracks Product Insights Agent result click events.

trackProductInsightsAgentView

fun trackProductInsightsAgentView(request: ProductInsightsAgentViewTrackingData)

Tracks Product Insights Agent view events.

trackProductInsightsAgentViews

fun trackProductInsightsAgentViews(request: ProductInsightsAgentViewsTrackingData)

Tracks Product Insights Agent views events.

trackPurchase

fun trackPurchase( items: Array<PurchaseItem>, revenue: Double?, orderID: String, sectionName: String? = null, analyticsTags: Map<String, String>? = null)

fun trackPurchase( customerIds: Array<String>, revenue: Double?, orderID: String, sectionName: String? = null, analyticsTags: Map<String, String>? = null)

Tracks purchase events.

trackQuizConversion

fun trackQuizConversion( quizId: String, quizVersionId: String, quizSessionId: String, displayName: String? = null, type: String? = null, isCustomType: Boolean? = null, customerId: String, variationId: String? = null, itemName: String? = null, sectionName: String? = null, revenue: String? = null, analyticsTags: Map<String, String>? = null)

Tracks quiz conversion events ##Example

trackQuizResultClick

fun trackQuizResultClick( quizId: String, quizVersionId: String, quizSessionId: String, customerId: String, variationId: String? = null, itemName: String? = null, sectionName: String? = null, resultId: String? = null, resultPositionOnPage: Int? = null, numResultsPerPage: Int? = null, resultPage: Int? = null, resultCount: Int? = null, analyticsTags: Map<String, String>? = null)

Tracks quiz result click events ##Example

trackQuizResultLoad

fun trackQuizResultLoad( quizId: String, quizVersionId: String, quizSessionId: String, sectionName: String? = null, resultId: String? = null, resultPage: Int? = null, resultCount: Int? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null)

Tracks quiz result load events ##Example

trackRecommendationResultClick

fun trackRecommendationResultClick( podId: String, strategyId: String, customerId: String, variationId: String? = null, sectionName: String? = null, resultId: String? = null, numResultsPerPage: Int? = null, resultPage: Int? = null, resultCount: Int? = null, resultPositionOnPage: Int? = null, analyticsTags: Map<String, String>? = null, seedItemIds: List<String>? = null)

Tracks recommendation result click events.

trackRecommendationResultsView

fun trackRecommendationResultsView( podId: String, numResultsViewed: Int, resultPage: Int? = null, resultCount: Int? = null, resultId: String? = null, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null, seedItemIds: List<String>? = null)

fun trackRecommendationResultsView( podId: String, items: Array<TrackingItem>, numResultsViewed: Int, resultPage: Int? = null, resultCount: Int? = null, resultId: String? = null, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null, seedItemIds: List<String>? = null)

~~fun~~ ~~trackRecommendationResultsView~~( podId: String, itemIds: Array<String>, numResultsViewed: Int, resultPage: Int? = null, resultCount: Int? = null, resultId: String? = null, sectionName: String? = null, url: String = "Not Available", analyticsTags: Map<String, String>? = null, seedItemIds: List<String>? = null)

Tracks recommendation result view events.

trackResultsImpressionView

fun trackResultsImpressionView( items: List<ResultsImpressionItem>, searchTerm: String? = null, filterName: String? = null, filterValue: String? = null, analyticsTags: Map<String, String>? = null)

Tracks results impression view events (items that were viewably impressed per MRC guidelines).

trackSearchResultClick

fun trackSearchResultClick( itemName: String, customerId: String, searchTerm: String = Constants.QueryConstants.TERM_UNKNOWN, sectionName: String? = null, resultID: String? = null, slCampaignId: String? = null, slCampaignOwner: String? = null)

fun trackSearchResultClick( itemName: String, customerId: String, variationId: String?, searchTerm: String = Constants.QueryConstants.TERM_UNKNOWN, sectionName: String? = null, resultID: String? = null, slCampaignId: String? = null, slCampaignOwner: String? = null)

Tracks search result click events.

trackSearchResultsLoaded

fun trackSearchResultsLoaded(request: SearchResultsLoadedData)

Tracks search results loaded (a.k.a. search results viewed) events, with support for the result ID, pagination, sorting and selected filters of the search results.