All Collections
Get Started
1st Steps
Tagging Customer Information
Tagging Customer Information
Dan Macarie avatar
Written by Dan Macarie
Updated over a week ago

For updated information, please see: Adding-the-customer-information in our documentation

Tagging customer information is optional, but enables Nosto’s email features. Tagging can be applied to different page types where a customer opts-in for emails.

<!-- Tag your customer's contact information, replace static example values to equivalent database/ecom engine variables -->
         <div class="nosto_customer" style="display:none">
           <span class="email">john.doe@example.com</span>
           <span class="first_name">John</span>
           <span class="last_name">Doe</span>
           <span class="marketing_permission">true</span>

           <!-- Optional properties -->
           <span class="customer_reference">e18daf14-d715-4d77-82f2-93eceb4ae1ef</span>              
         </div>

General Guidelines

Email-addresses and name details are tagged and mapped to Nosto only to enable Nosto’s email features. Nosto never approaches your customers directly. Therefore, if strict company policy doesn’t allow using Nosto as an email service you can skip this part and move to tagging order content, but be aware that you can’t leverage any of Nosto’s email features.

The customer tagging is placed in the log-in area if a site has one. The tagging needs to be present just once, preferably immediately after a customer has logged in. The tagging can also be implemented in use cases when a customer leaves an email address for other purposes, for example when a customer subscribes for a newsletter. Simply load the same tagging on the page where customer is directed after signing up!

Nosto only uses the email address and typically just first name for email personalisation, meaning that you can leave last name and DOB out.

Once ready, enable debugger, verify by logging in, and if all looks good jump to learn how to tag order content!

Tagging marketing permission

The new marketing-permission flag denotes whether the customer has consented to email marketing. If the marketing-permission field is omitted, we assume that the current customer has not given their consent and Nosto will refrain from sending out any personalized triggered emails.

The marketing permission is false by default but if a user has explicitly agreed to receive marketing then you can set it to true manually. In practice, this means reading and mapping the value from opt-in for marketing in your platform e.g. a consumer explicitly subscribed for marketing emails when checking out.

The marketing-permission should be included as a part of the customer tagging and should be rendered on all pages.

Tagging customer reference

The customer reference attribute to match the customer across Nosto stores, devices or even between offline/online sessions if you are using a unified customer loyalty program.

The customer-reference should be a long, secure and a non-guessable identifier. For example, use your internal customer-id or the customer's loyalty program identifier and use a secure hash function like an HMAC-SHA256 to hash it.

Note: If a customer reference is in use in the customer information tagging, make sure the identifier is secure enough. Nosto recommends using a UUID or the structure in the above example if a UUID can’t be supported.

Did this answer your question?