Knowledge base

Where answers meet questions

MailChimp Integration MailChimp Integration

Traqli provides a simple to use mechanism for including personalized content and ads recommendations within newsletters handled by MailChimp.

Here are the steps you need to go through in order to start using Traqli in your MailChimp account:
  1. Set up notifications about new content that appears on your website. The easiest way to do that is by using RSS feeds, other options are available as well.
  2. Next step is to connect Traqli with your MailChimp account. In order to do that please provide us with an API key. Please click here to find out how.
  3. We also need an ID of your target mailing list - mailing list that you are going to use for personalized content recommendations. Please click here to find out how.
  4. Send content recommendations requirements to Traqli's customer succcess manager, e.g.:
    1. Type of recommendations: personally recommended to each subscriber, most popular content, latest content
    2. Display type: title only, image + title or image + title + description
    3. Number of recommended items (from 1 to 10)
  5. Once you send us this information, we will provide you with the following data:
    1. Login and passwork to your Traqli Dashboard
    2. List of merge tags that you'll need to add into your email template in MailChimp
  6. After you login to the dashboard, you'll need to do the following:
    1. Go to Integrations, add a new one to generate JS code for further integration on your website
    2. Go to Campaigns and choose the schedule for content recommendations updates. Please note that updates should be prepared in advance, approximately 50k subscribers per hour, e.g. if you want to send the campaign in MailChimp at 9am and have 100k subscribers, the time frame for update delivery should be from 7 to 8.59 am
  7. Go to email editor in MailChimp and add blocks using existing MailChimp items (e.g. add an Image+Caption), creating the structure for dynamic content — the way you want to arrange that it in the newsletter
  8. Save the template and export it to HTML
  9. Create new template and import saved HTML file
  10. Open HTML in MailChimp editor and replace placeholder text with Traqli's merge tags provided in the step 5.2
    • Note that Traqli merge tag for image should be included within HTML tag for images, same should be done for links and titles
  11. Save the template and launch the campaign 
iContact Integration iContact Integration
Please follow these steps to set up a mechanism for obtaining personalized content recommendations powered by Traqli:
Setting up Traqli app in your iContact account
  1. Go to https://app.icontact.com/icp/core/externallogin
  2. Insert Traqli app ID into the Application IDfield:
    • Traqli app ID is FvgSgjQ9kFy3ouEA8OCaJa7zX8MuLDie 
  3. Create a password for Traqli in the corresponding field. We’ll need that password to access your account and insert content recommendations into your newsletter. We don’t do anything else but providing the content recommendations. Only Traqli can use this password. 
  4. Click the Save button. 
 
Supplying Traqli with integration credentials.
To let our system produce content recommendations for your audience please send us the following:
  1. A link to your iContact list of subscribers who you want to provide with content recommendations.
  2. An email address that you use to log into your iContact account
  3. The password you created for the Traqli app to access your iContact account (see step 3 of Setting up Traqli app in your iContact account instructions)
 
After we set up our system to supply you with content recommendations, you’ll notice a list of fields in the Custom Fields section that you can access by clicking your username in iContact dashboard.
 
Each recommended story consists of a set of 3 custom fields — [tqXX_img], [tqXX_link] and [tqXX_title], where XX is a unique number of a set. You can use up to 10 sets of recommendations. You can request more than 10 sets by contacting Traqli support.
 
To add recommended stories to your newsletter please replace placeholder images, titles and links in the template with corresponding custom fields. For example:
 
 
 
You may want to add height and width restrictions for an image that would be displayed in the newsletter instead of [tqXX_img] custom field to ensure the newsletter layout looks appropriate.
 
After you modify the newsletter template you can proceed to sending out emails as you normally would do with a hand picked content. 
Can I use my built-in subscription forms? Can I use my built-in subscription forms?

If you decide to provide Traqli with new subscribers using your own subscription forms (or any other way of collecting new subscribers) rather than using Traqli op-in forms, the following API call has to be performed to add new subscribers:

HTTP FORM POST to http(s)://api.traq.li/tracker/securesub?api_key=<api_key> with set headers: Content‐Type:application/x‐www‐form‐urlencoded

Form fields to be submitted:

email: “<subscriber_email>”

mlids: “idX,idY, ... ”

Alternatively, you can send JSON POST to http(s)://api.traq.li/tracker/securesub?api_key=<api_key> with set headers: Content‐Type:application/json

JSON body: {"email”:“<reader_email>”,“mlids”:[idX,idY,...]}

For obtaining secret API key and idX, idY, ... values please contact Traqli Support Team at info@newzmate.com

How can I notify Traqli about unsubscribes? How can I notify Traqli about unsubscribes?

If you are using your own opt-in and opt-out forms and would like to keep your mailing list in tact with mailing list uploaded to Traqli, you’ll need to us notifications using our API:


HTTP FORM DELETE to http(s)://api.traq.li/tracker/securesub?api_key=<api_key> with set headers: Content‐Type:application/x‐www‐form‐urlencoded

Form fields to be submitted:

email:“<reader_email>”

mlids:“idX,idY,...”

Alternatively, JSON DELETE to http(s)://api.traq.li/tracker/securesub?api_key=<api_key> with set headers: Content‐Type:application/json

JSON body: {“email”:“<reader_email>”, “mlids”:[idX,idY,...] }

For obtaining secret API key and idX, idY, ... values please contact Traqli Support Team at info@newzmate.com

I'd like to be notified of new subscribers via Traqli opt-in form I'd like to be notified of new subscribers via Traqli opt-in form

Traqlil provides neat, clear and efficient opt-in forms for collecting new subscribers. You can always check how many new subsribers were added to your mailing list in the dashboard, but if you'd like to be notified each time you get a new subscriber, you can set up and receive HTTP event(s), also known as callback requests with JSON body.

The HTTP request may be performed to any number of HTTP(s) endpoints with the following JSON body:

{“email”:“<reader_email>”, “mlids”:[idX,idY,...] }

mlid and idX, idY will be provided on demand by Traqli's agent.

HTTP method to use for each of endpoints for receiving notifications can be chosen arbitrarily by Customer and should be provided to Traqli for corresponding setup.

I'd like to keep track of those who chose to opt-out from Traqli's mailings I'd like to keep track of those who chose to opt-out from Traqli's mailings

Traqli does its best to keep your audience engaged, but sometimes there's a quiter or a couple occur and you'd want to know about that. You can set up notifications about unsubscribe event and receive it each time subscribers click the "Unsubscribe" button in the newsletter.

The HTTP request may be performed to any number of HTTP(s) endpoints with the following JSON body:

{“email”:“<reader_email>”, “mlids”:[idX,idY,...] }

mlid and idX, idY will be provided on demand by Traqli's agent.

HTTP method to use for each of endpoints for receiving notifications can be chosen arbitrarily by Customer and should be provided to Traqli for corresponding setup.

I'd like to check subscription status of any of my subscriber I'd like to check subscription status of any of my subscriber

At any point of time you can query Traqli regarding subscription status of any subscriber using the following HTTP GET method:

http(s)://api.traq.li/tracker/securesub/email/<reader_email>/ml/<idX>?

api_key=<api_key>

Returned HTTP code shall indicate subscription status:

HTTP200: reader <reader_email> is subscribed to list <idX>

HTTP404: reader <reader_email> is not subscribed to list <idX>

HTTP 500: server error encountered (see HTTP logs or contact Traqli agent for further steps)

For obtaining secret API key and idX, idY, ... values please contact Traqli Support Team at info@newzmate.com 

Integration with MailUp Integration with MailUp

Traqli provides a simle to use mechanism for including ads recommendations within newsletters handled by MailUp

Here are the steps you need to go through in order to start using Traqli in your MailUp account:

  1. You need to accept Traqli's terms of use and policy here http://traq.li/terms-of-use-to-sign
  2. You'll get an access to the dashboard to generate integration code (JS tag) that you need to puton the website so Traqli can monitor users interests and behaviour
  3. You'll get an access to the dashboard to generate integration code (JS tag) that you need to put on the website so Traqli can monitor users interests and behavior
  4. Based on your email template we prepare the layout of native ad item  (layout) as well as  amount of native ad items  in the email and provide you with ready-to-add HTML snippet  where you’d need to put  email address / or user id of a specific person into special parameter within the provided HTML code.
  5. If you want to use Traqli for personalized content recommendations (not only native ads from 3rd party advertisers), you can add an RSS feed in Traqli Dashboard → Setup → Sources Management, so Traqli can automatically pick up the right content for your subscribers. Information on how to add feeds you can find in this article.
  6. After that go to  Email ->Campaigns, there will be  two campaigns:  Access Based Recommendations Generator and Access Based Recommendations Preview. The first is the actual campaign that is used to generate the recommendations, the second one just a preview to give you the link and show how the configured layout looks like. All the setting of campaign or block wouldn't have any effect in the actual look & feel of the item. This is related to the need of integration through 3rd party ESP. In case you'd want to make any changes to the layout, just send a request to the support.
  7. Next, go to Templates, choose on top (in the header) campaign Access Based Recommendations Preview and in Preview side of the page you will see links for the item:
  8. At the end of each link you can see the parameter for user email address, that is where you need to add actual email address of the user on your ESP side, so, for instance, for me this link should look like this:
    http://api.traq.li/story/abr/p/581/9647cf79950f9c597a4af145f40b2242c9cdb7d127e72b9e929c00640853c3bb/andrew@newzmate.com
  9. Currently there are two links for one AD item, in case you want to use more ad items, you need to add "?uid={unique_number}" for every next item, like here:
    http://api.traq.li/story/abr/p/581/9647cf79950f9c597a4af145f40b2242c9cdb7d127e72b9e929c00640853c3bb/andrew@newzmate.com?uid=123123
  10. Once you'll add the item in the template and start sending the email you can go to Analytics -> Overview and see number of Ad Clicks made. There is no stats for number of opens yet, but in mailing list activity you'll see the number of new subscribers that requested (opened an email) the item for the first time, so you'll see amount of unique users that saw the image.