7 Way Debugging Methods of Adobe Launch | BCS

7 Way Debugging Methods of Adobe Launch

Adobe Launch Haran Huang 1 years ago (2019-12-03) 748 Views 0 Comments

When we are done with the configuration and setup, we need to know if this is right or not, which requires testing. 

Combining with  Click Tracking Implementation  from the previous section, suppose we have configured the click tracking, and now we need to test it. What should we do?

There are many tools and plugins for testing, such as the officially recommended Adobe Experience Cloud Debugger and Launch Switch, the Monitoring Hooks solution provided by Launch, and Tagtician provided by third parties.

In fact, Browser Developer Tools can also do testing.

Browser Developer Tools

The browser developer tools also have a variety of testing methods, open the browser developer tools:

Console

Analytics Server Call

The Adobe Analytics Server Call under the Console is the data sent to Adobe Analytics, which contains specific data information:

7 Way Debugging Methods of Adobe Launch

_satellite.getVar(Data Element)

We can also use the developer console of the browser to test whether the relevant data elements have accurately obtained the value. After simulating the behavior that needs to be tracked, enter _satellite.getVar (“element”) directly in the console. The desired data element, such as the Page Name:

7 Way Debugging Methods of Adobe Launch

 

_satellite.setDebug (true)

We can also add _satellite.setDebug (true) to see which Rules fired. Enter it in the console and refresh it:

7 Way Debugging Methods of Adobe Launch

7 Way Debugging Methods of Adobe Launch

You can see that there is a small 🚀 , it will show what operation was performed and what rules triggered.

Network

It can also be judged by the Network of the browser developer tool, because the request sent to Adobe Analytics will carry the AQB key word, which can be filtered by AQB:

7 Way Debugging Methods of Adobe Launch

Click on this request, and then look at its header, you can see the specific data it sends:

7 Way Debugging Methods of Adobe Launch

You can find out whether the data you want to track has been sent.

The way of developing tools through the browser is not suitable for testing events that have jumps, because the page is refreshed after clicking, and the time is too short, and you have no time to look at the data at all.

Adobe Experience Cloud Debugger

Adobe Experience Cloud Debugger is an officially recommended tool. This is a Chrome Extensions, which can be used after installation.

The usage is very simple. After opening the website, open Adobe Experience Cloud Debugger, then refresh the website or simulate the test, and Adobe Experience Cloud Debugger will automatically collect data.

7 Way Debugging Methods of Adobe Launch

Summary will show which Adobe products are used, version information, and specific extensions configured. We are mainly looking at Network, which is the data sent to Adobe:

Then simulate the behavior that needs to be tracked, click “Adobe Launch Guide” and observe the Adobe Experience Cloud Debugger will show some data, Look for Events under Network:

7 Way Debugging Methods of Adobe Launch

If the corresponding data can be found, it means that the rule is triggered, which is normal.

If no data is found, then it is not triggered. Your rules configuration failed.

You can also Switch Launch Environments with the Experience Cloud Debugger,you can use the Adobe Experience Cloud Debugger extension to replace the Launch property hardcoded on the  site with your own property. The setting location is Replace Launch Embed Code in the tool tab.

Adobe Experience Platform Debugger

Adobe Experience Platform Debugger is actually an upgraded version of Adobe Experience Cloud Debugger.

The usage is the same. First open the website, then open the Adobe Experience Platform Debugger, and then refresh or simulate the behavior, Adobe Experience Platform Debugger will automatically collect the data.

7 Way Debugging Methods of Adobe Launch

It looks very similar to the previous one, but the UI is different.

If you want to test a different product, click on the corresponding product. It seems that the data sent is correct. Let’s take a look at Adobe Analytics, this is the data sent to Adobe Analytics:

7 Way Debugging Methods of Adobe Launch

Launch Switch

Launch Switch is also called Launch and DTM Switch. This is a test tool developed by Search Discover. It is an Extensions on Chrome and can be used after installation.

The usage is: open the website, then open the Launch Switch, select the corresponding environment, and click Debug on:

7 Way Debugging Methods of Adobe Launch

 

If we want to see the data, we also need to open the Console of the browser developer tool, refresh it, and you will see a lot of 🚀, which means the opening is successful:

7 Way Debugging Methods of Adobe Launch

Is this interface rarely familiar?

In fact, you can also directly enter _satellite.setDebug (true) in the console to open it. The functions of Launch Switch and _satellite.setDebug (true) are the same.

Here you can see more launch execution messages that can help you determine whether the rule is triggered, but you need to find the rule yourself. If there is no rule you are looking for, it means that it is not triggered and you need to modify the event in the rule.

Tagtician

Tagtician is a test tool developed by 33 Stick, It is an Extensions on Chrome and can be used after installation.

The usage is: open the developer tools (F12) and click on the Tagtician tab.

7 Way Debugging Methods of Adobe Launch

You can see which rules are triggered. You can know what data is passed.

Omnibug

Omnibug is a Chrome extension built to ease developing and QAing today’s marketing technologies. It is an Extensions on Chrome and can be used after installation.

The usage is: open the developer tools (F12) and click on the Omnibug tab.

7 Way Debugging Methods of Adobe Launch

Click on it to see the specific information sent:

7 Way Debugging Methods of Adobe Launch

Monitoring Hooks

This method is provided by Adobe Launch, you need to add a piece of code before the launch library,This will allow the monitor to catch even the earliest system events that occur in the Launch library,The code to be added is as follows:

<span style="font-size: 12pt;"><script>
    window._satellite = window._satellite || {};
    window._satellite._monitors = window._satellite._monitors || [];
    window._satellite._monitors.push({
      ruleTriggered: function (event) {
        console.log(
          'rule triggered', 
          event.rule
        );
      },
      ruleCompleted: function (event) {
        console.log(
          'rule completed', 
          event.rule
        );
      },
      ruleConditionFailed: function (event) {
        console.log(
          'rule condition failed', 
          event.rule, 
          event.condition
        );
      }
    });
  </script>
</span>

The monitor object can specify the following methods, which will later be called by the Launch library at certain points in time:

  • ruleTriggered will be called after an event triggers a rule but before the rule’s conditions and actions have been processed. The event object passed to ruleTriggered will contain information about the rule that was triggered.
  • ruleCompleted will be called after a rule has been fully processed. In other words, the event has occurred, all conditions have passed, and all actions have executed. The event object passed to ruleCompleted will contain information about the rule that completed.
  • ruleConditionFailed will be called after a rule has been triggered and one of its conditions has failed. The event object passed to ruleConditionFailed will contain information about the rule that was triggered and the condition that failed.

As you might surmise, if ruleTriggered gets called, either ruleCompleted or ruleConditionFailed will be called shortly thereafter.

Let’s try how to use it. After deploying which piece of code, directly open the console of the developer tools of the browser, and then you can directly simulate the test, and you will see the following interface:

7 Way Debugging Methods of Adobe Launch

It will prompt you which rules are triggered, what are the results of the trigger, success or failure. This is more convenient than the previous need to find out if the Rule is triggered by yourself.

 

Referral

https://medium.com/adobetech/launch-library-monitoring-hooks-c674d16deae3


If you don't understand, You can leave a comment below or email me (haran.huang@ichdata.com).
Like (3)
Post my comment
Cancel comment
Expression Texture Bold Strikethrough Center Italic Sign in

Hi, you need to fill in your nickname and email!

  • Nickname (required)
  • Email (required)
  • Website