Step One: Add a Click Tracking Google Tag

Title the tag "Shop My Shelf Click Tracking"
Set the Tag Type to Custom HTML
Set the HTML to the script provided in your brand onboarding setup guide.
Set the Triggering field to Fire on a "Page View" on "All Pages"
Ensure the tag looks like the image below (but with your personal script) and press "Save"

Step Two: Add an Order Tracking Google Tag

Set the title to "Shop My Shelf Order Tracking"

Set the HTML to the following. Where noted, change the declared variables relying on dataLayer to your data configuration:

orderId - the unique identifier for the order (eg. 123456)
orderAmount- the total before taxes and shipping (eg: 89.99)
currency - the ISO 4217 currency code (eg: "USD")
code - the optional discount code used at checkout (eg: 20PERCENTOFF)
is_returning_customer - optional boolean field indicating if this order is coming from a returning customer (e.g. false if from a new customer, true otherwise). Particularly useful to include in the payload if setting up a different rate for returning customers via the ShopMy affiliate network.

<script>
 /* Google Tag Manager does not accept ECMASCRIPT6*/
 var cookies = {}
 var cookiesList = document.cookie.split(';');
 for (var i = 0; i < cookiesList.length; i++) {
     if (cookiesList[i]) {
         cookies[cookiesList[i].split('=')[0].trim()] = cookiesList[i].split('=')[1].trim();
     }
 }

 var orderId, orderAmount, currency, code, is_returning_customer;
 try {
     // Need to pull the following from however your data layer is configured, this is one example used on a Shopify implementation.
     orderId = dataLayer.find(function (a){ return 'transactionId' in a}).transactionId;
     orderAmount = dataLayer.find(function (a){ return 'transactionGoodsNet' in a}).transactionGoodsNet;
     currency = dataLayer.find(function (a){ return 'currencyCode' in a}).currencyCode;
     code = dataLayer.find(function (a){ return 'transactionDiscountCode' in a}).transactionDiscountCode;

     // Optional logic to set is_returning_customer
     var customerOrdersEvt = dataLayer.find(function (a){ return 'customer_order_count' in a});
     if (customerOrdersEvt && 'customer_order_count' in customerOrdersEvt) {
       is_returning_customer = customerOrdersEvt.customer_order_count > 1;
     }
 } catch(error) {
     console.log('We had an issue with the SMS checkout', error)
 }


  fetch('https://api.shopmy.us/api/order_confirmation', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      orderAmount: orderAmount,
      orderId: orderId,
      clickId: cookies.sms_click_id,
      currency: currency,
      page_url: window.location.href,
      code: code,
      is_returning_customer: is_returning_customer
    })
  })
    .then(function(r) {
      if (!r.ok) throw new Error('Invalid order request sent');
      return r.json();
    })
    .then(function() {
      var now = new Date();
      document.cookie = 'sms_click_id=;expires=' + now.toUTCString() + ';path=/;';
      document.cookie = 'sms_click_time=;expires=' + now.toUTCString() + ';path=/;';
      document.cookie = 'sms_code=;expires=' + now.toUTCString() + ';path=/;';
    })
    .catch(function() {
      // ignore the error
    });
</script>

Set the Triggering field to Fire on "Order Confirmation" on "DOM Ready"
Ensure the tag looks like the following and press "Save"

Step Three: Handle Order Cancellations

Configure a POST request to be sent to the following endpoint whenever an order is cancelled. This is crucial for maintaining accurate tracking and reporting in our system.

📘
This endpoint uses your unique Brand Developer Key for authorization. Always keep your key confidential to ensure security.

fetch(`https://api.shopmy.us/api/Affiliates/cancel`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer <YOUR_DEVELOPER_KEY>`,
  },
  body: JSON.stringify({
    order_id: '123456',
  })
})

Step Four: Handle Order Updates

Configure a POST request to be sent to the following endpoint whenever an order is updated. We define an order update as whenever a order has new total amount, or currency change. This is crucial for maintaining accurate tracking and reporting in our system.

📘
This endpoint uses your unique Brand Developer Key for authorization. Always keep your key confidential to ensure security

fetch(`https://api.shopmy.us/api/Affiliates/update`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer <YOUR_DEVELOPER_KEY>`,
  },
  body: JSON.stringify({
    order_id: '123456',
    currency: 'USD',
    new_order_amount: '1234.56'
  })
})

Step Five: Revert back to your onboarding guide for testing

📘
By adding our integration code to your site, you are agreeing to the terms of the ShopMy affiliate network. Please review these terms here.