Trace Test with Trace

In this step you will use Trace to validate that all of the previous configuration is working as expected. You will get a trace ID, add it to your application (or use the Tealium Tool), perform a simple test, then inspect the logs in the Trace interface.

Before you begin, if you will be testing a web page you will need theTealium Tools browser extension.

Start a trace

Follow these steps to perform a test with Trace:

  1. Navigate to Tools > Trace and click Start under New Trace.
  2. Copy the trace ID provided and click Continue.
  3. Activate the trace ID using one of the following methods:
  • Tealium Tools

    1. Open a new browser window to your test page.
    2. Click the Tealium Tools browser extension
    3. Click AudienceStream Trace.
    4. Enter the trace ID from step 2 and click Start Trace.
      es-getting-started-trace-tealium-tool.jpg
  • Data Layer Attribute

    1. Add tealium_trace_id to the data layer of your code installation and set it to the value of the trace ID.
    2. In the HTTP API, this means adding a query string parameter:&tealium_trace_id=012345
    3. In a Swift app, for example, it will look like this:
      tealium?.volatileData()?.add(data: ["tealium_trace_id": "012345"])
  1. Proceed with your test case work flow.
    This may mean refreshing the page, navigating through some pages, making a purchase, or viewing some screens in a native app. In this case, completing a purchase over $500 will trigger the audience we created.
  2. Return to the Trace interface to inspect the log details.

Trace log

The Trace log will update automatically as events are received. The UI will display the event data details, enriched visitor attributes, joined or left audiences, and any triggered connector actions. If there were any errors, those will be provided as well with additional details of the issue.

In this example, a purchase of $550 was completed and the following was verified in Trace:

  • ✓ - Visitor Attributes Updated
    as-getting-started-trace-enriched-visitor.jpg
  • ✓ - VIP Audience Joined
    as-getting-started-audiences-joined.jpg
  • ✓ - Google Sheets Connector Triggered
    as-getting-started-sheets-inserted-row.jpg
  • ✓ - Google Sheets Row Inserted
    as-getting-started-sheets-inserted-row.jpg
Beast-Thumbsup-Whistle-small.png

Here are some things to check if you didn’t see the expected trace log:

  • Did you use the correct trace ID in your test?
  • Did you save and publish your account after adding the visitor attributes, audience, and connector action?
  • Are your attribute enrichment rules accurate?
  • Is your audience filter correct?

Great job! You’ve made it to the end of this simple getting started guide. The next step will quickly cover the save and publish process followed by some helpful links for additional reading.

Was this page helpful?

This page was last updated: January 7, 2023