Integrations

To access the Integrations section, click configure in the main menu and then click the integrations panel. The Integrations page displays (figure 1).

Click the appropriate link below to scroll to the information you require:

Overview

The integrations section enables you to integrate Contactsend with various web analytics systems.

All integration settings are configured and managed from the Integrations page (figure 1).

clab-config_roi_01

Figure 1: The Integrations page

The page is subdivided into a series of panels, which you can click to access the relevant configuration sections. To be able to use an integration, it needs to be activated for your account, and you also require the appropriate permissions. A panel appears gray if it is not available to you.

Integration examples

The following describes how to configure a selection of the most popular integrations. Click the appropriate link for more about the following:

Analytics

Contactsend has its own post-click analysis tool, which enables you to trace a contact’s (user’s) behavior following a click, such as the path taken to the destination site, or any potential conversion, for example, a product being purchased, or registration for an event. When configured appropriately, the collected data can be used to calculate the ROI for a campaign.

The Contactsend Analytics system is activated in accordance with your organization’s contract. To make the system operational, you need to insert a script (clabtrack.js) into the pages for which the analytics service is required. The script can then be used to save and communicate a set of name-value pairs to Contactsend Analytics, which are used for tracking contact (user) actions.

To configure analytics, do the following:

  1. Click the analytics panel on the Integrations page.
    The Analytics management page displays.

analytics

Figure 2: The Analytics management page with the Activation tab displayed

  1. Select the Activation tab, if not already displayed.
  2. Under Analytics name, enter an appropriate name.
  3. When you are finished, click create.
    The analytic system is created.

If you click the Active systems tab, you can view the available systems, and be able to retrieve the JavaScript to be included in your site (figure 3).

analytics_code

Figure 3: Example of the ROI JavaScript

You can also use the appropriate tabs on the Analytics management page to manage conversion pages and configure keys, improving the parameterization of the collected data, as a result.

Example:

For a site that is capable of collecting donations, you could:

  • Insert a script on the page that asks for a donation confirmation, by setting a cart parameter to record who has arrived at the page.
  • Insert the JavaScript on the next donation page by setting, for example:
    • The amount parameter, for the amount donated.
    • The currency parameter, for the appropriate currency.
    • The payment_type parameter, for the payment method.
      Credit card, bank transfer, and similar.
  • Insert other parameters as required.
    For example, page_from to record the page from which the donation was made.

analytics_keys

Figure 4: Example of the Keys Configuration tab with custom keys in bold

Note:
The system can be parameterized, so it is sufficient to set one, even if it is to be used on multiple sites.

Google analytics

Contactsend enables you to track your deliveries with Google analytics for free. Do the following:

  1. Click the Google Analytics panel on the Integrations page.
    The Google Analytics page displays.

clab-config-integrations_googleanalytics

Figure 5: The Google Analytics page

You can use fixed or dynamic values for Google analytics parameters. To add a dynamic parameter, select it from the appropriate drop-down menu. The values are calculated by the system for every delivery.

  1. Under utm_medium, enter the delivery type.
    For example, e-mail.
  2. Under utm_source, enter or select the delivery identifier.
    For example, the campaign ID, in the $#delivery_id#$ variable format.
  3. Under utm_term, enter or select when the delivery is to start.
    Use the $#delivery_start_date#$ variable format.
  4. Under utm_content, enter or select the content type.
    For example, test.
  5. Under utm_campaign, enter or select the campaign subject.
    Use the $#delivery_subject#$ variable format.

You can also add custom parameters, for example, a Company ID, for a multiple-company account, or a Link ID. Do the following:

  1. Under Name setting and Value setting, enter the relevant name and value.
  2. When you are finished, click +.
  3. Repeat steps 1 and 2 to continue to add further custom parameters, as required.

When creating an email campaign and defining link tracking, you can enter different values for each link.

To track all links:

  • Under Links found in the text, select Google Analytics in the drop-down list (figure 6).
    See Create > Email campaign for more about the creation process.

Figure 6: The Google Analytics option on the Create Link tracking page

To track only selected links:

  • Click the + icon to the left of the appropriate link.
    The Link details display.

Figure 7: The Google Analytics option in the Link details

  • Under Analytics, select Google Analytics from the drop-down list.

To define or edit the Google Analytics parameters for a link:

  1. Ensure that Google Analytics is selected in the Analytics panel, and click the Cog icon positioned to the right (figure 8).
    The relevant details display (figure 9).

Figure 8: The Cog icon in the Analytics panel

Figure 9: The Google Analytics parameters for the link

  1. Edit the values, as required.
  2. If you want to copy a value to other links, click the icona_propaga_ga icon, positioned to the right of the appropriate parameter.
  3. When you are finished, click close.
  4. Continue to create the delivery, as described in Create > Email campaign.

Schema.org

Gmail has recently introduced a new (Beta) way of viewing emails in the Promotions tab. With this new grid layout mode, emails are displayed with a graphic preview, which can use an image that is not in the email itself. You can configure items to appear in this new grid layout view using Schema.org markup syntax, which is a project created by Google, Microsoft, and Yahoo!, working in collaboration.

To enable you use this feature, the Contactsend Schema.org integration has been made available. Please note that you need the appropriate permissions to use this integration.

Do the following:

  1. Click the Schema.org panel on the Integrations page.
    The Schema.org page displays.
  2. Click Create new organization.
    The Schema.org new organization page displays.

Figure 10: The Schema.org new organization page

  1. Enter the following details:
    1. Name
    2. Site URL.
    3. URL Google+.
  2. When you are finished, click + confirm.

Once you have configured the integration, you can automatically include a portion of Schema.org code when you create a delivery, so that emails to Gmail recipients are already optimized for the grid view. Do the following:

  1. On the Message contents page of the Create a new campaign wizard,  in the panel beneath the HTML content, click Gmail Feature.
    The Gmail Feature panel displays.

Figure 11: The Gmail Feature panel on the Message contents page of the Create a new campaign wizard

  1. Under Select the organization, choose the appropriate organization.
  2. Select the check (tick) box next to Promotions tab.
  3. Click Browse… to upload the image that you want to appear in the preview.
    The icon will automatically be taken from the linked Google+ page.
  4. When you are finished, continue to create the delivery, as described in Create > Email campaign.

Facebook

To use custom audiences or lead ads, you must link at least one Facebook Ads account to Contactsend. You can configure and link up to 10 accounts. The configuration steps must be carried out for every Facebook Ads account, but they do not need to be repeated to upload contacts (users) as custom audiences.

To configure a Facebook Ads account, do the following:

  1. Click the Facebook panel on the Integrations page.
    The Facebook page displays.

Figure 12: The Facebook page with the Authorizations tab selected

  1. Select the Authorizations tab.
    Any existing Facebook Ads accounts are displayed in the Accounts list.
  2. Click + Set up a Facebook Account.
    The Facebook new account page displays.

Figure 13: The Facebook new account page

  1. Enter the following:
    1. Under Name, a recognizable name for the Facebook Ads account.
    2. Under Ads account ID, the numeric ID for the Facebook Ads account.
  2. Click authorize to automatically request and retrieve an access token.
    When requesting the access token, Facebook will ask you to give Contactlab permission to access the Ads account. This is needed to create and upload custom audience contacts (users).
    Note:
    The access token is tied to the relevant Facebook user. If you have already logged in to Facebook, then that account will be used. Otherwise, you need to log in to Facebook as the user who has the appropriate permissions for the Facebook Ads account.
  3. Once you have the access token, click save.
    The account is added to the accounts list on the Authorizations tab of the Facebook page (figure 12). Here, you can edit or delete the Ads account, and display the relevant details.

 

Note:
Facebook access token has an unlimited time validity.

clab_configintegrazioni-facebook-info
Figure 14: The Custom Audiences info page

Once you have completed the configuration, Contactsend will be able to access the Ads account, and you can upload and manage custom audiences as required.

Custom audiences

You can start from an exinsting db in Contactsend or a part of it (filter) to create  a new custom audience on Facebook or add users to one existing audience. You can do this via the db admin panel, under configure > user db by clicking the db name and then the links in the “custom audience” panel.

In the “configure > integrations > facebook” area you can see the existing synchronizations between Contactsend and Facebook custom audiences. If you select the Info icon in the appropriate row of the Accounts list, you can view the Custom Audiences info page for that account, which includes a list of all the relevant audiences, regardless of who created them, together with the number of contacts and the date of the last edit. 

When a custom audience is loaded or synchronized, Facebook now requires you to indicate the origin of the data. Specifically, whether the contact data that is being uploaded was collected directly from the customers, came from third parties or originates from a combination of both of these sources.