registerPostTrackCallback

The registerPostTrackCallback variable allows your organization to hook a JavaScript function immediately after a hit is successfully sent to Adobe. If a tracking call fails, this function does not run. You can use this variable to send data collected by AppMeasurement to a partner or in-house infrastructure, or clean up variable values in single-page applications.

Each time you call the registerPostTrackCallback variable, you hook that function to run immediately after an image request is successfully sent. Avoid registering the same function multiple times in the same page load.

Post-track Callback using the Web SDK extension

Coming soon!

Post-track Callback manually implementing the Web SDK

You can use a JavaScript Promise when sending an event to register a function after data is successfully sent to Adobe.

alloy("sendEvent",{
  "xdm": {}
}).then(function(result) {
  Console.Log("Data was successfully sent.");
});

See Handling responses from events in the Web SDK documentation for more information.

Register Post-track Callback using the Adobe Analytics extension

There is not a dedicated field in the Adobe Analytics extension to use this variable. Use the custom code editor, following AppMeasurement syntax.

s.registerPostTrackCallback in AppMeasurement and the Analytics extension custom code editor

The s.registerPostTrackCallback is a function that takes a function as its only argument. The nested function runs immediately after an image request is successfully sent.

s.registerPostTrackCallback(function(){/* Desired code */});

If you want to use the image request URL in your code, reference the requestUrl string argument within the nested function. You can parse the requestUrl variable for your desired use; adjusting this variable does not impact data collection.

s.registerPostTrackCallback(function(requestUrl){
  console.log(requestUrl); // Outputs the full image request URL
});

Additional arguments can be included in the s.registerPostTrackCallback function, which can be used in the nested function:

s.registerPostTrackCallback(function(requestUrl,a,b,c) {
    console.log(requestUrl); // Full image request URL
    console.log(a); // param1
    console.log(b); // param2
    console.log(c); // param3
}, "param1", "param2", "param3");

Use case

Registering the clearVars() function in the post track callback can be beneficial for single-page applications. Every time you successfully send a hit to Adobe, the clearVars() function runs. Your implementation can then define variables again without worrying about incorrectly persisting values.

s.registerPostTrackCallback(function(){s.clearVars();});