Back

This article covers the following topics:

Table of Contents Placeholder

Checking for Issues

This article describes steps used to verify that an Omnichannel ingest has worked correctly and to check for potential issues.

Access the Location for your Omnichannel Files

Use the following steps to access the location for your Omnichannel files:

  1. Log in to the Tealium Universal Data Hub (UDH).
  2. Click Enrich > Omnichannel to access the location for your Omnichannel files.
  3. From the Configuration tab, view the available enrichment locations.
    Omnichannel Enrichment Locations.jpg

    You can open the location using an external tool, such as CyberDuck.

Find the File Name

Use the following steps to find the file name you are looking for:

  1. Click the Definitions tab to locate the file name.
  2. Click Edit File Definition to open the file definition.

    Screen Shot 2016-02-22 at 14.10.42.png
  3. Look for the file prefix that Omnichannel is detecting.
    Screen Shot 2016-02-22 at 14.12.30.png

Check for the Latest Version of the File

  1. Check the file location for the latest version of the file.
    Screen Shot 2016-02-22 at 14.14.56.png
  2. Find the latest version in the file location using your client, e.g. CyberDuck.

Use the Omnichannel Status Checker Tool

  1. Take the latest file name and use it in the Omnichannel Status Checker Tool.
    This tool allows you to check the status of any file ingest:
    Screen Shot 2016-02-22 at 14.18.40.png
  2. Look for a state of PROCESSED for a successful ingest.

Add a Dashboard Report Looking at the File Definition

Use the following steps to add a dashboard report that looks at the file definition specified:

  1. From AudienceStream, add a report for the Omnichannel file definition you are checking.
    Screen Shot 2016-02-22 at 14.20.23.png
  2. If successful, you should see the number of rows in the latest file definition reflected in the number shown in the report for the date when it was ingested/processed, as shown in the following example:
    Screen Shot 2016-02-22 at 14.23.04.png
    The example shows that, on February 20th, 602,154 rows of data were processed for this file definition.

Check Audience Discovery for Enriched Data Values

Use the following steps to check Audience Discovery for enriched data values:

  1. Check the Discover > Audience Discovery report for attributes you are expecting values for.
    audience-discovery-enriched-data-values.png
    If you checked LIVE or HISTORIC reports, you should see some visitors with the values you are expecting for a particular attribute you are defining using Omnichannel.

    You will only see values for users who have visited the site since you ingested the Omnichannel file.

    If you are not using the legacy Omnichannel column mappings, you will need to ensure that you have mapped the Omnichannel data sources to AudienceStream attributes, as shown in the following example:

    Screen Shot 2016-02-22 at 14.31.28.png

Log in as a Visitor on Your Site to Check Your Attributes

Use the following steps to log in as a visitor on your site to check your attributes:

Tealium iQ technical knowledge is required to perform this task. If you are in doubt, contact the Tealium Support Desk for assistance.

Though it is unlikely to be an issue, be aware that this step will cause AudienceStream to show that one of your visitors has revisited the site.

  1. Open a Chrome Incognito window and declare a data source that will ensure that you are identified as one of the users in your Omnichannel file.
    The following example checks a visitor with an ID of abc123@gmail.com in a the column Email Addr.
    Screen Shot 2016-02-22 at 14.42.17.png
  2. To locate the visitor attribute this relates to, check the File Definition.
    Screen Shot 2016-02-22 at 14.43.55.png
  3. You now know that you are looking for the Customer Email
  4. Set a value for Customer Email, as follows:
    Screen Shot 2016-02-22 at 14.46.50.png
  5. As shown in the previous example, if you set the customerEmail data source, you are "pretending" to be this visitor.
  6. The easiest way to call this function is to use the Google Chrome Console while on a page and performing this step:
    utag.view({"customerEmail":"abc123@gmail.com"});
    
    Your browser will now respond as if it is this visitor.
  7. Run a trace and check your attributes to see if any of the values from the Omnichannel file are present in your profile.

    You will need to have your Omnichannel columns mapped to attributes in order to see values here, as described in previous steps.

  8. Run a trace and check your attributes to see if any of the values from the Omnichannel file are present in your profile.
    Trace Me As New Visitor Checkbox.jpg

    Check the Trace me as a new visitor checkbox to ensure that the browser starts using a new visitor profile.

Next Steps if you Find an Issue

If you find problems with any of the issues described in this article, you can do one of the following:

  • Check that the column headers in your files match the declared columns in the file definition

  • Check that your file names match the defined file prefix in the file definition.

  • Visit the Tealium Support Desk for assistance.

Tags (1)