[Targeting] of Equativ Keywords

Owned by Pascal Clausen, created
Last updated: 2023-12-29 by Oksana Vinkarklina (Deactivated)
3 min read

External Systems

Equativ

Role

Order Manager - Fulfilment, Product Management

Challenge

You are using the ADvendio Equativ integration to push your Media Campaigns and Campaign Items as Insertions to Equativ and are planning to use keyword targeting. How can this be configured in ADvendio?

Solution

For our Equativ integration offers to set Keywords for your Insertions. This can be configured on different levels in ADvendio. You can change this for each of your Campaign Items individually or you can predefine certain keywords in your product configuration. This way they will be used each time an item is submitted automatically from ADvendio, without the users having to set it for each Campaign Item.

Our current feature only supports the usage of keywords. Keyword groups or Keyword ranges are currently not supported.

Define Keywords for individual Campaign Items

To define your keywords for a Campaign Item, please use the field AdKeyValues Paste in a keyword string according to the format shown later on this wiki page.

The keywords you enter in this field will be sent to your Equativ insertion. Additionally, they will also be shown as targeting information on Quote and Invoice PDF documents generated by ADvendio, as seen in the following image:

 

If you don’t want to have this shown on your document, you can hide the keywords, by setting the checkbox ‘Hide Key Value Targeting on Quote’ on your Campaign Item.

 

Please be aware some older version of ADvendio still use the field AdKeyWords, so if the Keywords from AdKeyValues field are not transferred to Equativ, please try that field instead. With Release 2.154 AdKeyValues should definitively work.

 

Preconfigure Keywords on Ad Specs and Ad Types

Additionally to the Campaign Item, you can also predefine your keywords on the Ad Spec and Ad Type object. For this, please use the KeyValues field.

If you set keywords on the Ad Spec or Ad Type, they will be used for each connected Campaign Item. If you additionally define keywords for your Campaign Item, they will be put automatically in an AND relation, with whatever is preconfigured.

 

How to use Keywords, Expected Syntax and operators.

As there is no dedicated interface to set your keywords, ADvendio expects them to be written in a certain format, which is in accordance with Equativ.

To use this you need to generally apply the logic:

key=value

Then there are certain ways to use operators. “;” between two keys shows an AND relation, while “,” shows an OR relation. To set a key to not equals please use:

NOT key=value

Following this logic, the following expression in ADvendio:

gender=female,gender=male;interest=cars

will result in the following keywords in Equativ:

 

Setup

To use this field for your Equativ integration to ADvendio, there is no additional setup required.

It might be that your users are not able to see the relevant fields on the Campaign Item or Ad Spec objects, please make sure that your users have read permissions to access the fields and that they are part of your Page Layouts for Campaign Item and Ad Spec.