DTM _satellite objects will be changing in 2017

“_satellite” is the object in Dynamic Tag Management (DTM). Adobe announced that many of the objects in the _satellite will be changing in 2017. If you have been using _satellite objects in your DTM projects, you might need to replace them with JavaScript code.

e.g. _satellite.isString([param]) with typeof s === “string”

Personally, I have been using _satellite methods a lot because the methods are very useful just like jQuery’s methods. Adobe hasn’t determined which_satellite objects will be eliminated, however, the main methods will not change.

 

Below is a list of _satellite object references that will NOT change:

  • _satellite.notify()
  • _satellite.track()
  • _satellite.getVar()
  • _satellite.setVar()
  • _satellite.getVisitorId()
  • _satellite.setCookie()
  • _satellite.readCookie()
  • _satellite.removeCookie()
  • _satellite.isLinked()

 

 

_satellite.trim([string])

Please read Limitations before using this reference. The object was tested on August 10, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

According to Dynamic Tag Management Object Reference PDF (2013),

“Removes spaces from the beginning and end of a string and then returns the result”.

If non-string parameter is passed into this method, the JavaScript error will be occurred because “replace()” is String method. This method is very similar to jQuery.trim().

Object Type

  • function with parameters

Parameters

  • a string (must be string type, otherwise the JavaScript error will be occurred.)

Return Value

  • a string without spaces in the beginning and end

JavaScript on Developer Console
The following codes were found when “_satellite.trim” was typed on Developer Console.

 

Examples

Example 1

 

References

_satellite.contains([array], [object])

Please read Limitations before using this reference. The object was tested on August 9, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

According to Dynamic Tag Management Object Reference PDF (2013),

“Checks to see if an array contains an object”.

If an object is not found, return false. The first parameter can be a string.
Based on the codes found in Developer Console, it seems that _satellite.contains calls another function _satellite.indexOf.

Object Type

  • function with parameters

Parameters

  • array: an array (can be string)
  • object: an object

Return Value

  • true / false (type = boolean)

JavaScript on Developer Console
The following codes were found when “_satellite.contains” was typed on Developer Console.

 

Examples

Example 1
Search an object in an array.

Example 2
Search an object in a string.

References

_satellite.parseQueryParams([string])

Please read Limitations before using this reference. The object was tested on August 8, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

According to Dynamic Tag Management Object Reference PDF (2013),

“Parses the designated URL query parameter”.

Object Type

  • function with parameters

Parameters

  • a string to be parsed

Return Value

  • parsed parameters as an object (type = object)

JavaScript on Developer Console
The function codes were partially shown when “_satellite.parseQueryParams” was typed on Developer Console.

 

Examples

Example 1

 

References

_satellite.dataElements

Please read Limitations before using this reference. The object was tested on August 8, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

According to Dynamic Tag Management Object Reference PDF (2013),

“Listing of all the available data element definitions in the library regardless of their
availability in an instance”.

Simply, listing all active data elements as an object including the data elements that are not used on the current page. The inactive data elements are not included in the list. If there is no active data elements, return an empty object {}.

Object Type

  • object

Parameters

  • none

Return Value

  • all active data elements (type = object)

JavaScript on Developer Console
List the active data elements when “_satellite.dataElements” was typed on Developer Console. Also, the data elements information is in the nested object.

data elements

Custom Script

data element with custom script

 

References

_satellite.indexOf([array], [object])

Please read Limitations before using this reference. The object was tested on August 7, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

According to Dynamic Tag Management Object Reference PDF (2013),

” Returns the index of an object within an array”.

If an object is not found, return -1. The first parameter can be a string, in this case, the result is the same as string.indexOf().

Object Type

  • function with parameters

Parameters

  • array: an array (can be string)
  • object: an object

Return Value

  • the index number (type = number)

JavaScript on Developer Console
The following codes were found when “_satellite.indexOf” was typed on Developer Console.

 

Examples

Example 1
Search an object in an array.

Example 2
Search an object in a string. The returned index is same as string.indexOf().

References

_satellite.isObject([param])

Please read Limitations before using this reference. The object was tested on August 6, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

Check if a type of parameter is an object or not. Return true if it is an object, otherwise false.

Object Type

  • function with parameters

Parameters

  • a/an number, string, object, array, null… any parameter to be tested

Return Value

  • true / false (type = boolean)

JavaScript on Developer Console
The following codes were found when “_satellite.isObject” was typed on Developer Console.

 

Examples

Example 1

 

References

_satellite.isArray([param])

Please read Limitations before using this reference. The object was tested on August 6, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

Check if a type of parameter is an array or not. Return true if it is an array, otherwise false.

Object Type

  • function with parameters

Parameters

  • a/an number, string, object, array, null… any parameter to be tested

Return Value

  • true / false (type = boolean)

JavaScript on Developer Console
The following codes were found when “_satellite.isArray” was typed on Developer Console. The code seems not be accessible from the console.

 

Examples

Example 1

 

References

_satellite.isString([param])

Please read Limitations before using this reference. The object was tested on August 6, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

Check if a type of parameter is a string or not. Return true if it is a string , otherwise false.

Object Type

  • function with parameters

Parameters

  • a/an number, string, object, array, null… any parameter to be tested

Return Value

  • true / false (type = boolean)

JavaScript on Developer Console
The following codes were found when “_satellite.isString” was typed on Developer Console.

 

Examples

Example 1

 

References

_satellite.isNumber([param])

Please read Limitations before using this reference. The object was tested on August 5, 2016. Other _satellite objects are on DTM _satellite Object List.

 

Description

Check if a type of parameter is a number or not. Return true if it is a number , otherwise false.

Object Type

  • function with parameters

Parameters

  • a/an number, string, object, array, null… any parameter to be tested

Return Value

  • true / false (type = boolean)

JavaScript on Developer Console
The following codes were found when “_satellite.isNumber” was typed on Developer Console.

 

Examples

Example 1

 

References