3. Integrate Partner Data Tutorial

In the first two tutorials of the series, 1. On Demand Scripts Tutorial and 3. Partner Application Configuration Tutorial, Partners learned how to create On Demand scripts for Partner reports and how to upload them during the creation of the Integration Wizard. The Integration Wizard packages all of the scripts, variables and data needed for Customer integration and automates the process of mapping Partner and Customer variables to each other.

While the other tutorials and articles in this series are focused on Partner tasks, this one is focused on Genesis Customer tasks. As a Partner, keep in mind that you are performing the Customer's role to help you better understand the product integration process.

In this tutorial, you will learn how to execute the Genesis product Integration Wizard and then add the Genesis-provided JavaScript code to your existing SiteCatalyst JavaScript code. This will pass Genesis product data back to the Adobe Data Collection Layer along with your SiteCatalyst online analytics data.

This tutorial assumes that you know how to collect SiteCatalyst metrics using SiteCatalyst JavaScript Tagging. If you do not know how to do this, explore the c_SiteCatalyst_Tagging.xml#concept_A8ED446D8B9340BE84DE7F092FFFF3FB Tutorial.

Prerequisite knowledge, system permissions and environment setup

  • This article is for web developers with knowledge of HTML and JavaScript.
  • You must have a valid Report Suite ID in order to complete this tutorial. Follow the directions in the Authentication and Setup Tutorial.

Download code files for this tutorial

This tutorial displays code inline to the discussion but you can also download the code for PHP, Java or C# to explore on your own.

Follow the directions in the Authentication and Setup Tutorial article.

An overview of Genesis integration

Before SiteCatalyst Customers can use a Genesis product, they must first run the Genesis product Integration Wizard and map some of their application variables and events to the Genesis product's variables and events.

Once the Customer has run the Integration Wizard, the Adobe Engineering team takes the information from the active integration and builds theGenesis JavaScript code. The Customer then adds this JavaScript code to their existing SiteCatalyst JavaScript library file (s_code.js).

You learned in the c_SiteCatalyst_Tagging.xml#concept_A8ED446D8B9340BE84DE7F092FFFF3FB tutorial that once you have integrated the SiteCatalyst JavaScript code into your web pages, each web page request sends analytics data to the Adobe Data Collection Layer.

When you integrate Genesis product data, you can optionally delay the JavaScript processing to the Adobe Data Collection Layer so that the system has time to retrieve the necessary data from the Partner servers (see Figure 4).

Genesis products are created by Genesis Partners. The product data may come from either Adobe or Partner servers.

In this tutorial, you will perform the following steps to integrate the Genesis product data into your own application:

  1. Step 1: Active the Integration for your SiteCatalyst Report Suite
  2. Step 2: Review SiteCatalyst JavaScript Code in the JJ. Esquire Demo Application
  3. Step 3: Add Genesis JavaScript Code to your SiteCatalyst JavaScript Library File
  4. Step 4: Display Product Data in the JJ. Esquire Demo Application
  5. Step 5: Verify retrieval of Partner Data using Adobe DigitalPulse Debugger
  6. Step 6: Run SiteCatalyst Reports to Verify Partner Data Collection

Once the Genesis product data has been sent to the Adobe Data Center it will be included in SiteCatalyst reports. You will learn more about how the Genesis Partners can pull reports on this integrated data using the Partner API in the 5. Partner Reports Tutorial and the 8. Data Warehouse Tutorial articles.