Glossary

Targeted Ad

The targeted ad is one of the key features of the ADCIO. A store can invite multiple sellers. The store’s placements are used for the advertisements (ads) of those sellers. Note that targeted ads for customers (users) are calculated by the ML model in addition to ADCIO admin configurations by sellers and stores.

Embedding Ads

Similar to [recommendations](https://docs.adcio.ai/en/docs/personalized-recommendations/recommendations (opens in a new tab)), ads are also made based on the placement (opens in a new tab). To embed an ad, you need to specify the placementId or the page which the placement is bounded to.

There are 2 ways to embed ads from your application.

1. Using Placement ID

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

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

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

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 ads. 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.

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