Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel62
outlinefalse
typelist
printablefalse
Info

If you’re not a preezie customer yet, check out our journeys solution for more details.

How it works

When activated, all users completing a preezie lead form at the end of a journey will be passed directly into your dotdigital account as contacts. In addition, all of their answers to the quiz questions and their product recommendations will also be passed as Insight Collections.

It uses Dotdigital’s public api to authenticate with your credentials and pass the preezie data directly into your account in real-time.

Example scenarios

  • Email the user’s product recommendations directly to their inbox

    • e.g. Here are your top product recommendations: 1) Pure Bright Eye Shadow, 2) Tinted Lip Balm

  • Re-target these users with email campaigns directly related to their answers/product recommendations

    • e.g. Target all emails with a budget >$100 and looking for organic products

  • Segment these users with specific flows based on their answers/product recommendations

    • e.g. Create a segment who have an answer of “I’m a make up beginner” > email them content tips on make up tutorials

...

Quick start guide

There are 2 3 easy steps to activate the direct integration from preezie journeys into your dotdigital account.

...

Form field

Explanation

User Name

paste in your API user email from Dotdigitaldotdigital

Password

use your dotdigital API password (Now hit Test Connection)

Api Endpoint

(read only) https://r3-api.dotdigital.com/contacts/v3/import (Note, this field will automatically populate after you hit Test Connection)

Opt-in type

select how you want your contacts to be handled for email subscriptions in Dotdigitaldotdigital

Unknown = emails go straight into ‘subscribed’ status, see https://support.dotdigital.com/hc/en-gb/articles/212212098-Contact-opt-in-types

List ID (Optional)

if you want emails to go straight into your email List enter the List ID found from your Dotdigital dotdigital account,

e.g. 123456789 if your list ID url is:
https://r3-app.dotdigital.com/contactmanager/#/audience/lists/123456789

Active

turns on/off the integration

  • Hit Save Dotdigital Integration and it’s now live!Click Save Dotdigital Integration

3. Add 3 custom preezie fields to your dotdigital account

  • Now go back to your dotdigital account go to Settings > Contacts > Contact data fields > Custom data fields

...

  • Click New Data Field to Create these 3 fields:

1

2

3

Name

PREEZIE_LEAD_ID

PREEZIE_SOURCE

PREEZIE_SOURCE_TYPE

Data type

Text

Text

Text

Default value

[empty]

[empty]

[empty]

Access

Private

Private

Private

Folder

Data fields

Data fields

Data fields

...

Congrats, you are now live!!

Where to find your data

Once your integration is live, every email being submitted through preezie will send to Dotdigital the fields in you lead form

...

  • Key:

    • id: the unique identifier of the product as defined in your Product Attributes in the preezie CMS

    • name: the product name

    • img: the image url

    • url: the product url

    • price: the price shown

    • score: the match score

    • age etc. these are custom attributes with a check against Appears in Statistics in Product Attributes in the preezie CMS:

...

Removing old data

Info

To keep data storage light and not incur any additional Dotdigital charges. We automatically remove all preezie Insight collections data older than 3 months.

Create a segment with your data

...

preezie Integration Video Explainer (6 minutes)

Info

Note, instructional videos can be outdated quickly, always use the latest settings detailed above.

Aura embed
JTdCJTIyaW5wdXRVcmwlMjIlM0ElMjJodHRwcyUzQSUyRiUyRnd3dy5sb29tLmNvbSUyRnNoYXJlJTJGOGZjZjg3NWUzNTQzNDI1YWJkZTk0YTk4MGZkNjkwZTYlM0ZzaWQlM0QwN2Y5MjU5ZS05N2RkLTRmYTMtYTYyOC1kNTZiZjc2MGZhNjYlMjIlMkMlMjJlbWJlZFR5cGUlMjIlM0ElMjJsb29tJTIyJTJDJTIyd2lkdGglMjIlM0ElMjI2MDBweCUyMiUyQyUyMmhlaWdodCUyMiUzQSUyMjYwMHB4JTIyJTJDJTIyYWxpZ25tZW50JTIyJTNBJTdCJTIyaG9yaXpvbnRhbCUyMiUzQSUyMmNlbnRlciUyMiU3RCU3RA==
paramsJTdCJTIyaW5wdXRVcmwlMjIlM0ElMjJodHRwcyUzQSUyRiUyRnd3dy5sb29tLmNvbSUyRnNoYXJlJTJGOGZjZjg3NWUzNTQzNDI1YWJkZTk0YTk4MGZkNjkwZTYlM0ZzaWQlM0QwN2Y5MjU5ZS05N2RkLTRmYTMtYTYyOC1kNTZiZjc2MGZhNjYlMjIlMkMlMjJlbWJlZFR5cGUlMjIlM0ElMjJsb29tJTIyJTJDJTIyd2lkdGglMjIlM0ElMjI2MDBweCUyMiUyQyUyMmhlaWdodCUyMiUzQSUyMjM4MHB4JTIyJTJDJTIyYWxpZ25tZW50JTIyJTNBJTdCJTIyaG9yaXpvbnRhbCUyMiUzQSUyMmNlbnRlciUyMiU3RCU3RA==

Building emails using preezie data

Now you have your preezie data stored against your contacts you can use Dotdigital’s Liquid markup language to use this as content in your emails.

Here we’ll show how a user’s preezie results email can be dynamically created.

Add products to an email template

Either clone an existing product based email template (e.g. abandoned cart) or create a new one.

  • Now drag in a Loop component from the Advanced personalisation section:

...

  • In this component, Select collection > preezie_recommendations hit APPLY

...

  • Now drag another Loop component into the first loop and choose collection > recommendations. Here you can choose 1/2/3 columns depending on the number of products you want to show in a row on larger devices.

...

  • These will loop through the contents of the contact’s insight collection data.

Now we’ll add the product details to these loops.

Drag in a Text component and hit the Edit HTML icon in the menu bar:

...

Here you’ll add HTML around the Liquid markup to show the products, e.g.

<a href="{{recommendations.url}}">
<img src="{{recommendations.img}}" style="max-width: 80%;">
<p>{{recommendations.name}}</p>
<p>{{recommendations.price | money: "AUD" }}</p>
</a>

The Liquid markup requires the pattern {{recommendations.<name of attribute>}} plus you can see an additional filter has been added to the price field.

By adding money filter and your currency acronym it will add the appropriate symbol in front of it, e.g. from 21.00 to $21.00

...

All of the Dotdigital Liquid filters you can use are listed here: https://support.dotdigital.com/en/articles/8198944-filter-liquid-outputs

Info

Note it is space sensitive! https://support.dotdigital.com/en/articles/8198942-script-content-with-advanced-personalisation#h_1701a50ed7

Liquid markup variables

Here’s a quick guide to the standard variables from preezie_recommendations you can use:

Product feed variable

Liquid markup

Description

Product ID

{{recommendations.id}}

The SKU or unique ID of your product

Product name

{{recommendations.name}}

Product name

Product link

{{recommendations.url}}

Product page link

Price

{{recommendations.price}}

Price

Match score

{{recommendations.score}}

The product’s match score based on the preezie user’s quiz answers

Custom

{{recommendations.skin__concern}}

Any custom variables you have passed to Dotdigital via CMS product attributes