Keyword Conversion

Sends `Custom Purchase Conversion Events` when a keyword is present in the incoming product payload

What are keyword conversions?

Keyword conversions is a feature where you can map keywords to custom conversions. In a Purchase event, if we see any mapped keyword present in the fields of the event payload (see below) after we transform them, we fire the mapped custom conversion.

E.g. if keyword shirt is present in contents.title, we fire the mapped custom conversion of that keyword.

Transform payload fields

When looking for keywords, we are considering the following fields in the payload:

• contents.title
• contents.brand
• contents.description
• keywords

When transforming, we will remove punctuations, replace word split characters with spaces, changes text to lower case etc.,

Transformation:

1. Text is converted to lowercase

   • Ensures consistent normalization
2. Word-contract characters (', _, -) are removed

   • Words may merge together
   • Example: this-is → thisis
3. Word-split characters (\s , . ! ? + " ; : |) are replaced with a single space

   • Multiple consecutive separators collapse into one space
4. Leading and trailing spaces are trimmed

Example:

Input

Hello.World_THIS-is|A"Test!!! Don't+Split;Here:Now

Output

hello worldthisis a test dont split here now

How to create a keyword conversion mapping?

Once you know the keyword that can be used, please go to the plugins page, select the plugin that you want to add keyword conversion mapping, add keyword in the left dropdown and the custom conversion name in the right dropdown and save the form.