{"id":75,"date":"2020-11-19T20:50:03","date_gmt":"2020-11-19T20:50:03","guid":{"rendered":"https:\/\/theatlass.com\/help\/?post_type=docs&p=75"},"modified":"2022-02-26T17:10:47","modified_gmt":"2022-02-26T17:10:47","slug":"custom-store-guide","status":"publish","type":"docs","link":"https:\/\/theatlass.com\/resources\/docs\/custom-store-guide\/","title":{"rendered":"Custom store guide"},"content":{"rendered":"\n

Install tracking on ads<\/h2>\n\n\n

Set up Facebook ads <\/h3>\n
\n

Go to your Facebook Ads Manager, and go to Ads tab.<\/p>\n\n\n\n

Select all ads using the checkbox in the header and click on Edit ads. This will edit all ads, in bulk<\/p>\n\n\n\n

Copy this code fbadid={{ad.id}}&fbadname={{ad.name}}<\/code> and paste it in the URL parameters field<\/p>\n\n\n\n

If you have other parameters, such as utm_campaign={{fb.campaign_name}}&source=facebook <\/code>, merge them by adding &fbadid={{ad.id}}&fbadname={{ad.name}}<\/code><\/p>\n\n\n\n

Don’t forget to save the new change<\/p>\n\n\n

\n IMPORTANT! Keep in mind that this will send the ad into review, but it won’t have any effect on your ad \n<\/div><\/div>\n\n\n

Next, make sure to integrate Facebook if you haven’t done that already!<\/p>\n\n\n

\n
\n NEXT: Facebook Integration <\/div>\n
\n <\/i>\n <\/div>\n<\/a>\n<\/div> <\/div>\n <\/div>\n\n

Set up Google ads <\/h3>\n
\n

Go to your Google Ads Manager, and go to Ads section.<\/p>\n\n\n\n

Click on the Tools icon and click on Scripts ( under Bulk Actions ) and click on the plus icon to create a new script.<\/p>\n\n\n\n

Copy the code below and paste in the new script<\/p>\n\n\n

\n
\n  function main() {\n            var adIterator = AdsApp.ads().get();\n                while (adIterator.hasNext()) {\n                var ad = adIterator.next();\n                var adgroup = ad.getAdGroup().getName().replace(\/[^a-zA-Z0-9- ]\/g, \"\");\n                var campaign = ad.getCampaign().getName().replace(\/[^a-zA-Z0-9- ]\/g, \"\");\n                \/\/var adHeadline = ad.getLongHeadline().replace(\/[^a-zA-Z0-9- ]\/g, \"\");\n                var adID = ad.getId();\n                var name = campaign + \" \" + adgroup+ \" \" + adID;\n                name = name.replace(\/\\s\/g,'-');\n                \/\/Logger.log( name );\n                ad.getCampaign().urls().setCustomParameters({adname:name});\n            }\n  }<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
Don’t forget to name the script, for example “Atlass ad name generator” and click on save. Before navigating, make sure to click run.<\/p>\n\n\n\n
Next, go to All campaigns, click on Settings button, then Account settings and open the tracking section.<\/p>\n\n\n\n
Copy this code {lpurl}?gadid={creative}&gadname={_adname}<\/code> and paste it in the Tracking Template field<\/p>\n\n\n\n
Don’t forget to save the new change<\/p>\n\n\n\n
Now, make sure to set up the Google Ads integration if you haven’t done that already.<\/p>\n\n\n
  \n    
\n      NEXT: Google Ads Integration    <\/div>\n    
\n      <\/i>\n    <\/div>\n<\/a>\n<\/div> <\/div>\n  <\/div>\n\n
      
 Set up TikTok ads <\/h3>\n    
 \n
Go to your TikTok Ads Manager, and go to Ads tab.<\/p>\n\n\n\n
Select all ads using the checkbox in the header and click on Edit ads. This will edit all ads, in bulk<\/p>\n\n\n\n
Add the following parameters to the URL of every add: ttadid=__CID__&ttadname=__CID_NAME__<\/code> <\/p>\n\n\n\n
Don\u2019t forget to save the new change<\/p>\n\n\n\n
Now, make sure to set up the TikTok integration, if you haven’t done that already<\/p>\n\n\n
  \n    
\n      NEXT: TikTok Integration    <\/div>\n    
\n      <\/i>\n    <\/div>\n<\/a>\n<\/div> <\/div>\n  <\/div>\n\n
      
 Set up Email Tracking <\/h3>\n    
 \n
Go to your Email Service provider and edit the email templates in use.<\/p>\n\n\n\n
Edit the CTA link within the body of the email<\/p>\n\n\n\n
Add the tracking parameters to the existing link ?atl_campaign=%email.subject%<\/code><\/p>\n\n\n\n
First make sure you change the %email.subject% <\/code>, depending on your ESP. <\/p>\n\n\n
\n    If the ESP does not provide the option to dynamically insert it, please make sure to change the “name-of-email-campaign” with the actual name of the campaign.\n<\/div><\/div>\n\n\n
For MailChimp<\/strong>, use he code below: <\/p>\n\n\n
\n
\n   ?mc_cid=*|CAMPAIGN_UID|*<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
( More details here<\/a> )<\/p>\n\n\n\n
For ActiveCampaign<\/strong>, use he code below: <\/p>\n\n\n
\n
\n  ?ac_cid=%CAMPAIGNID%<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
( More details here<\/a> )<\/p>\n\n\n\n
For Drip<\/strong>, use he code below:<\/p>\n\n\n
\n
\n  ?atl_campaign={{campaign.name}}<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
For ConvertKit<\/strong>, use the code below: <\/p>\n\n\n
\n
\n  ?atl_campaign=name-of-email-campaign<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
For Klaviyo<\/strong>, use the code below:<\/p>\n\n\n
\n
\n  ?atl_campaign=name-of-email-campaign<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
For Aweber<\/strong>, use the code below:<\/p>\n\n\n
\n
\n  ?atl_campaign=name-of-email-campaign<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
For SendGrid<\/strong>, use the code below:<\/p>\n\n\n
\n
\n  ?atl_campaign=name-of-email-campaign<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
Don’t forget to save the new change<\/p>\n <\/div>\n  <\/div>  <\/div>\n\n\n
Install tracking script<\/h2>\n\n\n
      
 Install the script on custom store <\/h3>\n    
 \n
Create an if statement for logged in users vs logged out users.<\/p>\n\n\n\n
For logged out users, aka visitors, use the code below:<\/p>\n\n\n\n
Copy the script below and paste it as high as you can within the HEAD tag ( <head><\/head><\/code> ).<\/p>\n\n\n
 Please log in from here<\/a> in order to get the code <\/div><\/div>\n\n\n
For logged in users, use the code below:<\/p>\n\n\n\n
Copy the script below and paste it as high as you can within the HEAD tag ( <head><\/head><\/code> ).<\/p>\n\n\n
 Please log in from here<\/a> in order to get the code <\/div><\/div>\n\n\n
Don’t forget to save the file.<\/p>\n\n\n\n
For example, the full code for a store built with PHP would look like:<\/p>\n\n\n
\n
\n  <?php if ( user_loggedin() ) { ?>\n          \t <script>\n                  window.atlassSettings = {\n                      APPKEY: \"_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_\",\n                      tags: 'primary',\n                      email: ''\n                  }\n                  var s = document.createElement(\"script\");\n                  s.type = \"text\/javascript\";\n                  s.src = \"https:\/\/theatlass.com\/t\/t.min.js\";\t\n                  document.head.appendChild(s);\n              <\/script>\n          <?php } else { ?>\n          \t <script>\n                  window.atlassSettings = {\n                      APPKEY: \"_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_\",\n                      tags: 'primary',\n                  }\n                  var s = document.createElement(\"script\");\n                  s.type = \"text\/javascript\";\n                  s.src = \"https:\/\/theatlass.com\/t\/t.min.js\";\n                  document.head.appendChild(s);\n              <\/script>\n          <?php } ?><\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div> <\/div>\n  <\/div>\n\n\n
Set up integrations<\/h2>\n\n\n
      
 Integration via API <\/h3>\n    
 
\n     NOTICE! This should be handled by the developer who set up your website. \n<\/div><\/div>\n\n\n
Locate your function that processed the order.<\/p>\n\n\n\n
Send a post request to https:\/\/atlass-302217.ew.r.appspot.com\/order\/add <\/code>containing the JSON code below.<\/p>\n\n\n\n
Depending on the programming languange, we set up some examples:<\/p>\n\n\n\n
Don’t forget to change the fields with the actual customer data.<\/p>\n\n\n\n
Raw JSON<\/h5>\n\n\n
\n
\n  {\n  \"APPKEY\": \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\", \/\/ Organization APPKEY, *required\n  \"APP_SECRET\": \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\", \/\/ Organization SECRET, *required\n  \"firstname\": \"John\", \/\/Client firstname\n  \"lastname\": \"Doe\", \/\/Client lastname\n  \"email\": \"John@doe.com\", \/\/Client email, *required\n  \"IP\": \"71.23.54.682\", \/\/Client IP\n  \"orderName\": \"Order number 215645675733\",\n  \"orderPrice\": 349,\n  \"orderID\": 1252653462, \/\/internal ID of the order\n  \"orderItems\": [\n    { \n        \"Name\": \"Produs test 1\" , \n        \"Price\": 299,\n        \"Quantity\":1 \n    }\n    ...\n  ]\n}<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div>\n\n\n
For PHP, use this code:<\/h5>\n\n\n\n
\n
\n
\n  $data = array(\n    \"APPKEY\" => \"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\", \/\/ Organization APPKEY, *required\n    \"APP_SECRET\" => \"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\", \/\/ Organization SECRET, *required\n    \"firstname\" => \"John\", \/\/Client firstname\n    \"lastname\" => \"Doe\", \/\/Client lastname\n    \"email\" => \"john.doe@gmail.com\", \/\/Client email, *required\n    \"IP\" =>  \"71.23.54.682\", \/\/Client IP\n    \"orderName\" => \"Order number 215645675733\", \/\/Order name, Purchase name or Product name \n    \"orderPrice\" => 349, \/\/Order price, Purchase price or Product price \n    \"orderID\" => 1252653462, \/\/ internal ID of the order\n    \"orderItems\" => array( \n        array( \n            \"Name\" => \"Item one\",\n            \"Price\" => 349,\n            \"Quantity\" => 1\n        ) \n    )\n);\n\n$payload = json_encode($data);\n\n\/\/ Prepare new cURL resource\n$ch = curl_init('https:\/\/atlass-302217.ew.r.appspot.com\/order\/add');\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\ncurl_setopt($ch, CURLINFO_HEADER_OUT, true);\ncurl_setopt($ch, CURLOPT_POST, true);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $payload);\n\n\/\/ Set HTTP Header for POST request \ncurl_setopt($ch, CURLOPT_HTTPHEADER, array(\n'Content-Type: application\/json',\n'Content-Length: ' . strlen($payload))\n);\n\n\/\/ Submit the POST request\n$result = curl_exec($ch);\n\n\/\/ Close cURL session handle\ncurl_close($ch);\n\nvar_dump( $result );<\/pre>\n <\/i>  <\/a>\n<\/div>\n<\/div><\/div><\/div>\n\n\n\n
<\/p>\n<\/div><\/div>\n\n\n
\n    Don’t forget to replace the APPKEY and APP_SECRET with the ones designated to your account, as well as the dummy date with the client’s actual data.\n<\/div><\/div>\n\n\n
Save the page and publish it.<\/p>\n <\/div>\n  <\/div>\n\n
      
 Facebook Integration <\/h3>\n    
 \n
The Facebook integration will allow us to calculate and analyze which ad makes the most profits and provides the best return on investment.<\/p>\n\n\n\n
Let’s plug it in.<\/p>\n\n\n\n
First, go to the Integrations<\/a> page and click on Facebook then log in with Facebook.<\/p>\n\n\n\n
After the Facebook login pop-up window will prompt to allow Atlass access to your account, click the Save Integration button.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
After the integration is saved, go to the ad accounts tab.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
From the Ad Accounts, click the imports button. This action will import all ad accounts owned or managed by you.<\/p>\n\n\n\n
After they have been imported, enable the ones you are using the run ads and want to attribute the sales. <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Now, make sure to set up tracking parameters for all Facebook ads, if you haven’t done that already.<\/p>\n\n\n
  \n    
\n      NEXT: Set up Facebook ads    <\/div>\n    
\n      <\/i>\n    <\/div>\n<\/a>\n<\/div>\n\n\n
<\/p>\n <\/div>\n  <\/div>\n\n\n
<\/p>\n","protected":false},"excerpt":{"rendered":"
Install tracking on ads Install tracking script Set up integrations<\/p>\n","protected":false},"featured_media":0,"menu_order":5,"template":"","meta":[],"_links":{"self":[{"href":"https:\/\/theatlass.com\/resources\/wp-json\/wp\/v2\/docs\/75"}],"collection":[{"href":"https:\/\/theatlass.com\/resources\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/theatlass.com\/resources\/wp-json\/wp\/v2\/types\/docs"}],"wp:attachment":[{"href":"https:\/\/theatlass.com\/resources\/wp-json\/wp\/v2\/media?parent=75"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}