Glossary

Term	Definition
ADCIO Admin	Admin platform used by Stores and Sellers on ADCIO
Store	ADCIO client with its own store on site/app
Placement	The location where Stores choose to run recommendations on their website

It is recommended to visit flow overview before reading this document.

Personalized Recommendation

The personalized recommendation is one of the key features of the ADCIO. It selects the best products or banners for the customer (user), based on the predicted customer preference which is calculated by the ML model.

Making a Recommendation

💡

If you are using a e-commerce solution such as Cafe24, you may not need to modify codes in your web or app. Please follow simple steps suggested by the solution. If you still have questions, please visit adcio.ai and contact us.

Recommendations are made based on the placement (opens in a new tab). Note that in ADCIO Admin, a placement is configured to include banners/products candidates and other configurations such as how many banners should be recommended or which format do banners have to be in. Therefore to request a recommendation, you need to specify the placementId or the page which the placement is bounded to.

There are 2 ways to request a recommendation from your application.

1. Using Placement ID

Set placement IDs on where you want to fetch recommendations. For example, if you're using adcio.js, you can specify placement IDs with a placements parameter.

JavaScript

const adcioInstance = new adcio.Adcio({ clientId: "..." });
const { suggestions } = adcioInstance.createRecommendationProducts({  placementId: "...",});

Dart

import 'package:adcio_placement/adcio_placement.dart';
 
final rawData = await adcioSuggest(placementId: '...');

Kotlin

import ai.corca.adcio_placement.feature.AdcioPlacement
 
val rawData = AdcioPlacement.adcioSuggest(placementId = "...")

Placement IDs can be found on ADCIO Admin page (opens in a new tab) for stores

ADCIO Admin Page -> [SideBar] Placement -> placement detail page -> Placement ID

2. Using Page Name

If you don't want to modify your client-side code every time when the new placements are added or deleted, you can just set page name instead of the actual placement IDs. The bounded placements of that page will be used for the recommendation. For more details about the relation between pages and placements, please refer to page (opens in a new tab).

Under the hood, the placement IDs are fetched by using the API. Note that it can be a little bit slower than using Placement ID because of this fetching step.

The page parameter is not yet implemented for App SDKs.

JavaScript

const [placement] = await adcioInstance.fetchPlacements({ pageName: "..." });

Log Collection Ads