Merge Tags

Introduction
Merge tags or personalization tags allow you to insert data and dynamic visitor content. For example the visitor's city.
Default location merge tags are available on selected accounts. Contact us to enable location merge tags.
How to Add a Merge Tag
To add a merge tag to a rich text field click Embed inline entry and select a Nintetailed Merge Tag.
Location Merge Tags
City of the visitors, e.g. "Berlin"
Country of the visitors, e.g. "Germany"
Postal code of the visitor, e.g. "10214"
Region of the visitor, if known, the ISO 3166-2 name for the first level region, e.g. "Berlin".
You can localize the city and country merge tags adding the locale code in the <PersonalizationProvider locale ="YOUR_ISO_LOCALE"/>
User Traits Merge Tags
You can set unlimited user traits to merge tags with the identify analytics call, e.g. first name, role, or company.
Add Merge Tags
To use your user traits merge tags in Contentful add a new entry for every trait, e.g. first name.
1.Create a new merge tag.
2.Add the ID of your user trait. Use the prefix traits_ and your trait name, e.g. traits_firstname.
3. Publish the entry.
Rich Text Rendering with MergeTags
Contentful provides libraries for all major JS frameworks to render rich text easily. Here is an example on how to render Ninetailed MergeTags through the Contentful react rich text renderer.
1
import { documentToReactComponents } from '@contentful/rich-text-react-renderer';
2
import { MergeTag } from '@ninetailed/experience.js-next';
3
​
4
const RichTextSection = () => {
5
  const RTComponent = documentToReactComponents(rtd, {
6
    renderNode: {
7
      [INLINES.EMBEDDED_ENTRY]: (node) => {
8
        // ... you other embedded entries
9
      
10
        if (node.data.target.sys.contentType.sys.id === 'nt_mergetag' && node.data.target.fields.nt_mergetag_id) {
11
          return <MergeTag id={node.data.target.fields.nt_mergetag_id} />;
12
        }
13
​
14
        return null;
15
      }
16
    }
17
  });
18
  
19
  return <RTComponent />
20
}
21
​
22
​
23
​
Copied!

Personalized Content

Multiple Audiences

Last modified 6d ago

Copy link

Contents

Introduction

How to Add a Merge Tag

Location Merge Tags

User Traits Merge Tags

Add Merge Tags

Rich Text Rendering with MergeTags