Knowledge base

Where answers meet questions

How to add and control the content How to add and control the content

One of the key advantages of Traqli is flexibility and control over the content you want to send and show to your audience. Whether you're sending automated email campaigns or provide on-site content recommendations you can set the rules that Traqli should follow for content selection and distribution.

Content management starts with Sources Management page in the Dashboard that provides you with the overview of existing content sources and their statuses and checks intervals. On the same page, you can add a new source of content. In a basic scenario, all you need to add is just add an RSS / ATOM feed via this interface and Traqli will automatically identify the right structure and start checking the feed for new content every 15 minutes with any further actions from your side.

At the same time if by any reason you cannot provide the content via RSS feed there are other options available to you:

  1. Feed Manager - it's a Traqli product that we made in a separate from the Dashboard interface to make it easy for editorial, marketing or sales teams to fill up the newsletter with a new content without spending the time of email template editing.
  2. Static Blocks - within Traqli's email editor you have different type of content blocks available, the one you use for content selection from the feed (RSS, Feed Manager, etc.) called dynamic block, at the same time you have a static block available to you, that has the same configuration workflow with the only difference: the source of the content is specified manually by you via Dashboard.
  3. HTML to RSS feed - in case previous options are not applicable, but you have the content you want to push via Traqli on the specific page (s) website there is a possibility on our end to convert this HTML page (s) to RSS feed. Please contact your customer success manager at Traqli to proceed with this option.
  4. JSON feed - another replacement for the RSS feed is a JSON feed, it's a more advanced and time-consuming type of integration, but it's also available to you. All you need is to prepare a JSON feed following these requirements and provide connection details to your customer success manager, so we can add in the Sources Management of the Dashboard.

These options usually cover 99% of all sources management needs, but in case they are not applicable to you we can always find the option that will work best for you, so let us know if you need something special.

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 

Client-side API on-site content recommendations Client-side API on-site content recommendations

Traqli provides various options for personalization of the audience experience both on the website and via emails. One more option that Traqli has, in case the publisher wants to render look & feel of the content representation on his side, is client-side content recommendations provided via API.

The outcome: after Traqli's SDK is loaded on the website we provide a special code snippet that returns a predefined amount of recommendation in the format that was configured with the publisher. Usually it's a link to the article, link to the image and the title (optionally there could be an endless amount of additional paraments, e.g. price, category, author, date, etc.).

Workflow:

  1. Register an account in Traqli
  2. Add a source (-s) of content, usually, RSS feeds (optionally JSON feeds or API integration with publishers CMS) that Traqli will use to pick up the content for recommendations
  3. Create an on-site content recommendation widget to specify content source, number of stories and content age (how old could be the recommended story)
  4. Create an integration snippet and add it on the website.

Additionally (except JS tag to load SDK for behavioural and semantic analysis) you'd need to add the following code that will return actual recommendations:

$(window).on('traqli-recommendations-data-ready-widgetid', function (e, recommendations) {
// your code here
// variable "recommendations" format:
// [
// {
// "title": "Article 1 Title",
// "tags": [
// "Tag A",
// "Tag B",
// "Tag C"
// ],
// "image": "//placehold.it/350x150?text=Article+1+Image",
// "link": "//go.publisher-news.com/AVePIh0oM2kiCaIbEblZ"
// },
// {
// "title": "Article 2 Title",
// "tags": [
// "Tag B",
// "Tag C",
// "Tag D"
// ],
// "image": "//placehold.it/350x150?text=Article+2+Image",
// "link": "//go.publisher-news.com/AVhTaHNk66HmQtDllD64"
// },
// ...
// ]
});

For the proper integration, we recommend to get in touch with your customer success manager.

 

 

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.
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. 
Adding Integration code via Google Tag Manager Adding Integration code via Google Tag Manager

Google Tag Manager is a great way to manage all the additional JavaScript, or "tags" and "tracking pixels" to your website without involving development resources.

To add the Traqli Integration Code within Google Tag Manager, please follow the steps below:

1. Go to the section Setup -> Integrations -> Copy integration code

2. Login to your Google Tag Manager account and navigate to the container with your domain.

3. Click on the red “New Tag” button.

Screen_Shot_2017-04-21_at_2.44.06_PM.png

4. Name the tag “Traqli”.

5. Under "Tag Configuration" choose custom HTML.

6. Paste the Integration code into the area provided.

7. Under "Triggering" choose "All Pages". Click save.

8. In the upper right-hand corner, click "Publish" and continue to publish all changes.

Screen_Shot_2017-04-21_at_2.57.50_PM.png

9. "Container Version Description" is optional. You can add a description or click skip.

Once you've completed these steps, the Integration code will start working

 

How I can notify Traqli about users' email addresses How I can notify Traqli about users' email addresses

If you have some information about current visitors' email addresses which might be passed to Traqli in order to perform accurate behavioural tracking of a visitor. In this case, you may pass visitors’ email addresses right from a web-page, omitting any user input. In order to do so, the following JavaScript code has to be executed:

window.Traqli &&

    "function" == typeof window.Traqli.handleUserEmail &&

     window.Traqli.handleUserEmail('email@address');

 Once executed, Traqli is aware of current visitor and is able to track her visiting history in conjunction with her email address.