Page tree
Skip to end of metadata
Go to start of metadata


Altcraft pixel is a stack of tracking technologies based on HTML and JavaScript tracking codes, that you place in your website and messages.

A pixel generates an HTTP request to Altcraft Marketing tracking module. It can retrieve various customer data:

  • geographic location;
  • platform and browser;
  • activity - before and after subscription;
  • preferences and interests.

Pixels are extremely convenient in segmentation queries: you can segment profiles by pixel activation times, pixel goals and goal values or referer web pages. You can specify a time period to make more precise audience slices. 

Pixel technologies also take a great part in keeping your databases up to date by refreshing profile location and device information.

Pixel goal achievement can be monitored via Goals report.

Enabling pixels

When using Altcraft Marketing On-premise on your hardware, Pixels must be first enabled in platform administrative panel by ticking "Enable pixel" in account settings.

In order for the pixels to work correctly, HTTPS protocol must be active for both your website and the platform.

After activation you can access pixels via the platform interface.

Creating pixels

Create a new pixel script by giving it a name, writing a description, setting access groups and a database to process.

You have an option to prevent unwanted pixel double activation by limiting the time before another activation.

Allow to import data on this pixel enables customer profile import at the moment your customer activates a tracking code.

Pixels can update your existing profiles or create the new ones, including for anonymous website visits:

  • HTML pixels (image and URL redirect) use your customers' session data (cookie) for matching profiles. If a profile with the same cookie (e.g. pened mail from the same device) is not found - a new anonymous profile will be imported.
  • JavaScript tracking codes can use both cookie data and customer profiles information. If a profile is found - its data will be updated; if not - a new profile is created with the data you can specify.

JS pixel import is decribed further on this page.  

After you save a new pixel - you'll be able to open Get pixel code interface. The first thing is to decide upon tracking technology you need:

  • Show a page - a JavaScript code that can be customized to detect user actions like scrolling a page within a specific time period.
  • Show a page (No JS) - this is a somewhat classic pixel technology,  representing a transparent image wrapped in a tracking HTTP request.
  • Click a link(No JS) -  this technology is a hyperlink wrapped in a redirect tracking request.

For all pixel types you can set goals and goal values:

When a pixel code is created - forward it to your website developers to implement it into your web site or application code -  and it will start tracking your customers' actions.

Web page tracking

Configuring the code

The script is placed on those pages where you want to track your customers' actions. On activation pixel will record goals you specify in pixel settings. You can record one value for these initial goals.

Below you can set to activate pixel at once when the page is loaded - or to wait for page scroll to exclude random website visitors from the query. 

After you configure a new pixel - forward its code from Show a page tab to your website developers along with the information from this page.

Recording goals via API methods

On the web page with the script implemented you can track any of your customers actions based on browser events. For example, these can be a mouse focus on a specific banner - or a popup activation - or leaving a page. On these events you can record customer's target actions and their values. For commercial actions you can register both profit and fees, if any.

For the page elements and browser events use the following method - ak_pixel_push():

These arguments are used to record target actions:

  • tags - goal name or names. Can contain a string value or an array of strings.
  • value - value or price for the goals. Can contain positive and negative floating point values.
Simple callak_pixel_push()
Goal registrationak_pixel_push("click")
Goal and value registrationak_pixel_push("click", 100)

Several goals with a negative value. One value will be recorded for all the goals

ak_pixel_push(["click", "cars"], -100.40)

Customer profiles import and update (JS)

If customer profiles import is enabled in pixel settings, you can add arguments for searching an existing profile to update- and for adding profile data: ak_pixel_push(tags, value, match, update, matching_mode):

  • match - this one is used for profile search. It is an object with one or two properties: "search field": "field value" и "db_id": "profile database ID" - in case a database is not specified for the pixel.

    db_id can be ignored when a profile database is specified in pixel settings.

  • update - can contain any customer profile data including subscriptions. 
  • matching_mode - can contain one of the following values: "email", "email_profile", "phone", "profile_id" or "custom" for the corresponding profile search modes.

    matching_mode can be ignored when searching by custom fields. 

Example of goal registration with profile import

ak_pixel_push("registration", 100, {
        "db_id": 12,
	"Client_ID": 12311541
}, {
	"_fname": "Nikita",
	"_lname": "Ryazanskiy",
	"subscriptions": [{
		"channel": "email",
		"email": ""
Goals and associated values can be recorded to customer profiles with the help of a direct API call as well.

Redirects via pixel settings

Redirect links can be used for fraud by sending phishing message with redirect_url. To avoid this, pixel in Altcraft MP does not support redirect by default. To engage this option, you need to activate this flag:

When flag is activated, you can enter domains list allowed for redirect, in the field below

After these settings, redirect in messages with pixel will be available on for enlisted domains. Redirect for other domains will be restricted.

  • No labels