Expression

Expression is a clause within a target product.

At the Expression level, you have two options to specify the type and value:

TARGET_CATEGORY: This is the default pairing. For the type, you set it as ‘TARGET_CATEGORY’, and for the value, you use the specific <categoryId>.
EAN_RELATION: This is an alternative pairing option. For the type, you set it as ‘EAN_RELATION’, and for the value, you use ‘ALTERNATIVE’. However, it’s important to note that this feature will be deprecated in the future, so it’s not recommended to use it.

When you create an expression, all the ads within an ad group will be targeted by the same expression.

This API helps you create, delete and gather detailed information about expression within a target product.

This API offers the following endpoints:

Create an expression - Creates an expression and within a target product.
Get a list of expressions - Retrieves a list of all expressions within a target product in a paginated format.
Delete an expression by expressionId - Deletes an expression

Creating an expression

Use the Create an expression endpoint to add expression within target product. Specify the targetProductId, type and value as the request parameters.

Modifying an expression is not possible. Hence, if you need to change something, perform the following:

Delete the expression using the Delete an expression by expression id endpoint.
Create a new expression using the Create an expression endpoint.

New Feature! We have launched a new expression type TARGET_CATEGORY and HIGHLY recommend all users to switch from EAN_RELATION / ALTERNATIVE to the new type exclusively.

What’s new? This enables the expression to target spesific product categories instead of just a broad level of alternative products. We have also added the ability to add up to 30 non archived target products to each ad group.
How? When creating an expression set the type to 'TARGET_CATEGORY' and value to '<categoryId>'.

In order to find out what would be relevant target categories, please refer to the Get product placement endpoint. This endpoint shows you what product categories your ads may be showing in. Therefore, only the product categories found in the product placement endpoint serve as relevant target categories.

Please Note: Targeting a specific category does not guarantee your ad will be displayed in that category. The visibility of your ad is determined by our algorithm, which assesses the relevance of your ad to the targeted category.

Example 1. TV’s

Consider your advertisement as ‘Television X’. This ad falls under the following hierarchical categories: [3136 > 18100 > 7291] which translates to [Electronics > Televisions & Accessories > TVs].
Targeting Specific Categories: If you target the ID 7291, your ad will specifically target product pages that belong to the ‘TVs’ category. Broader Category Targeting: If you target the ID 3136, your ad will target all sub-categories that fall under the broader ‘Electronics’ category. This includes categories such as ‘Audio & HiFi’.

Multiple Category Targeting: If you wish to target all relevant categories for your product, you will need to create a separate Target Product for each category. This allows for a more granular and effective targeting strategy. This is recommended if you wish to differentiate your bids based on the level of targeting.