Install tracking on ads

Set up Facebook ads

Go to your Facebook Ads Manager, and go to Ads tab.

Select all ads using the checkbox in the header and click on Edit ads. This will edit all ads, in bulk

Copy this code fbadid={{ad.id}}&fbadname={{ad.name}} and paste it in the URL parameters field

If you have other parameters, such as utm_campaign={{fb.campaign_name}}&source=facebook , merge them by adding &fbadid={{ad.id}}&fbadname={{ad.name}}

Don’t forget to save the new change

Next, make sure to integrate Facebook if you haven’t done that already!

Set up Google ads

Go to your Google Ads Manager, and go to Ads section.

Click on the Tools icon and click on Scripts ( under Bulk Actions ) and click on the plus icon to create a new script.

Copy the code below and paste in the new script

Don’t forget to name the script, for example “Atlass ad name generator” and click on save. Before navigating, make sure to click run.

Next, go to All campaigns, click on Settings button, then Account settings and open the tracking section.

Copy this code {lpurl}?gadid={creative}&gadname={_adname} and paste it in the Tracking Template field

Don’t forget to save the new change

Now, make sure to set up the Google Ads integration if you haven’t done that already.

Set up TikTok ads

Go to your TikTok Ads Manager, and go to Ads tab.

Select all ads using the checkbox in the header and click on Edit ads. This will edit all ads, in bulk

Add the following parameters to the URL of every add: ttadid=__CID__&ttadname=__CID_NAME__ 

Don’t forget to save the new change

Now, make sure to set up the TikTok integration, if you haven’t done that already

Set up Email Tracking

Go to your Email Service provider and edit the email templates in use.

Edit the CTA link within the body of the email

Add the tracking parameters to the existing link ?atl_campaign=%email.subject%

First make sure you change the %email.subject% , depending on your ESP.

For MailChimp, use he code below:

   ?mc_cid=*|CAMPAIGN_UID|*

( More details here )

For ActiveCampaign, use he code below:

  ?ac_cid=%CAMPAIGNID%

( More details here )

For Drip, use he code below:

  ?atl_campaign={{campaign.name}}

For ConvertKit, use the code below:

  ?atl_campaign=name-of-email-campaign

For Klaviyo, use the code below:

  ?atl_campaign=name-of-email-campaign

For Aweber, use the code below:

  ?atl_campaign=name-of-email-campaign

For SendGrid, use the code below:

  ?atl_campaign=name-of-email-campaign

Don’t forget to save the new change

Install tracking script

Install the script on custom store

Create an if statement for logged in users vs logged out users.

For logged out users, aka visitors, use the code below:

Copy the script below and paste it as high as you can within the HEAD tag ( <head></head> ).

For logged in users, use the code below:

Copy the script below and paste it as high as you can within the HEAD tag ( <head></head> ).

Don’t forget to save the file.

For example, the full code for a store built with PHP would look like:

  <?php if ( user_loggedin() ) { ?>
          	 <script>
                  window.atlassSettings = {
                      APPKEY: "_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_",
                      tags: 'primary',
                      email: ''
                  }
                  var s = document.createElement("script");
                  s.type = "text/javascript";
                  s.src = "https://theatlass.com/t/t.min.js";	
                  document.head.appendChild(s);
              </script>
          <?php } else { ?>
          	 <script>
                  window.atlassSettings = {
                      APPKEY: "_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_",
                      tags: 'primary',
                  }
                  var s = document.createElement("script");
                  s.type = "text/javascript";
                  s.src = "https://theatlass.com/t/t.min.js";
                  document.head.appendChild(s);
              </script>
          <?php } ?>

Set up integrations

Integration via API

Locate your function that processed the order.

Send a post request to https://atlass-302217.ew.r.appspot.com/order/add containing the JSON code below.

Depending on the programming languange, we set up some examples:

Don’t forget to change the fields with the actual customer data.

Raw JSON
  {
  "APPKEY": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // Organization APPKEY, *required
  "APP_SECRET": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // Organization SECRET, *required
  "firstname": "John", //Client firstname
  "lastname": "Doe", //Client lastname
  "email": "John@doe.com", //Client email, *required
  "IP": "71.23.54.682", //Client IP
  "orderName": "Order number 215645675733",
  "orderPrice": 349,
  "orderID": 1252653462, //internal ID of the order
  "orderItems": [
    { 
        "Name": "Produs test 1" , 
        "Price": 299,
        "Quantity":1 
    }
    ...
  ]
}
For PHP, use this code:
  $data = array(
    "APPKEY" => "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", // Organization APPKEY, *required
    "APP_SECRET" => "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", // Organization SECRET, *required
    "firstname" => "John", //Client firstname
    "lastname" => "Doe", //Client lastname
    "email" => "john.doe@gmail.com", //Client email, *required
    "IP" =>  "71.23.54.682", //Client IP
    "orderName" => "Order number 215645675733", //Order name, Purchase name or Product name 
    "orderPrice" => 349, //Order price, Purchase price or Product price 
    "orderID" => 1252653462, // internal ID of the order
    "orderItems" => array( 
        array( 
            "Name" => "Item one",
            "Price" => 349,
            "Quantity" => 1
        ) 
    )
);

$payload = json_encode($data);

// Prepare new cURL resource
$ch = curl_init('https://atlass-302217.ew.r.appspot.com/order/add');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLINFO_HEADER_OUT, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);

// Set HTTP Header for POST request 
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Content-Type: application/json',
'Content-Length: ' . strlen($payload))
);

// Submit the POST request
$result = curl_exec($ch);

// Close cURL session handle
curl_close($ch);

var_dump( $result );

Save the page and publish it.

Facebook Integration

The Facebook integration will allow us to calculate and analyze which ad makes the most profits and provides the best return on investment.

Let’s plug it in.

First, go to the Integrations page and click on Facebook then log in with Facebook.

After the Facebook login pop-up window will prompt to allow Atlass access to your account, click the Save Integration button.

After the integration is saved, go to the ad accounts tab.

From the Ad Accounts, click the imports button. This action will import all ad accounts owned or managed by you.

After they have been imported, enable the ones you are using the run ads and want to attribute the sales.

Now, make sure to set up tracking parameters for all Facebook ads, if you haven’t done that already.