Fetch data

Fetch data from Bloomreach Engagement using the MAUI SDK

Fetch recommendations

Use the FetchRecommendation method to get personalized recommendations for the current customer from an Engagement recommendation model.

The method returns a list of CustomerRecommendation objects containing the recommendation engine data and recommended item IDs.

Arguments

Name	Type	Description
options	CustomerRecommendationOptions	Recommendation options (see below for details )

CustomerRecommendationOptions

Name	Type	Description
Id (required)	string	ID of your recommendation model.
FillWithRandom	bool?	If true, fills the recommendations with random items until size is reached. This is utilized when models cannot recommend enough items.
Size	int	Specifies the upper limit for the number of recommendations to return. Defaults to 10.
Items	Dictionary<string, string>?	If present, the recommendations are related not only to a customer, but to products with IDs specified in this array. Item IDs from the catalog used to train the recommendation model must be used. Input product IDs in a dictionary as `[product_id: weight]`, where the value weight determines the preference strength for the given product (bigger number = higher preference). Example: `["product_id_1": "1", "product_id_2": "2",]`
NoTrack	bool?	Default value: false
CatalogAttributesWhitelist	List?	Returns only the specified attributes from catalog items. If empty or not set, returns all attributes. Example: `["item_id", "title", "link", "image_link"]`

Example

var recommendations = await Bloomreach.BloomreachSDK.FetchRecommendation(
    new CustomerRecommendationOptions(
        id: recommendationId.Text,
        fillWithRandom: true)
);

Result object

CustomerRecommendation

Name	Type	Description
EngineName	string	Name of the recommendation engine used.
ItemId	string	ID of the recommended item.
RecommendationId	string	ID of the recommendation engine (model) used.
RecommendationVariantId	string?	ID of the recommendation engine variant used.
Data	Dictionary<string, object>	The recommendation engine data and recommended item IDs returned from the server.

Fetch consent categories

Use the FetchConsents method to get a list of your consent categories and their definitions.

Use when you want to get a list of your existing consent categories and their properties, such as sources and translations. This is useful when rendering a consent form.

The method returns a list of Consent objects.

Example

var consents = await Bloomreach.BloomreachSDK.FetchConsents();

Result object

Consent

Name	Type	Description
Id	string	Name of the consent category.
LegitimateInterest	bool	If the user has legitimate interest.
Sources	ConsentSources	The sources of this consent.
Translations	Dictionary<string, Dictionary<string, string>>	Contains the translations for the consent. Keys of this dictionary are the short ISO language codes (eg. "en", "cz", "sk"...) and the values are dictionaries containing the translation key as the dictionary key and translation value as the dictionary value.

ConsentSources

Name	Type	Description
CreatedFromCRM	bool	Manually created from the web application.
Imported	bool	Imported from the importing wizard.
FromConsentPage	bool	Tracked from the consent page.
PrivateApi	bool	API which uses basic authentication.
PublicApi	bool	API which only uses public token for authentication.
TrackedFromScenario	bool	Tracked from the scenario from event node.

Updated 2 months ago