Zemanta can leverage the Adobe Analytics API to ingest your post-click metrics. The instructions below will walk you through the setup process in Zemanta and your Adobe Analytics account. Please make sure you follow through with all the steps to make sure the integration is complete.
There are two parts that need to be configured in order for the integration to work:
1. Configure Adobe Analytics to capture Zemanta-related information (NOTE: an Adobe user with Analytics Admin Console access is required to complete this part)
2. Configure Adobe Analytics API access so Zemanta systems can access that data (NOTE: an Adobe user with Adobe IO Admin access is required to complete this step)
1. Configure Adobe Analytics to capture Zemanta-related information
NOTE: an Adobe user with Analytics Admin Console access is required to complete this step.
1.1 Create eVar with appropriate persistence
1. Open Adobe Analytics and navigate to Admin > All Admin.
2. Click on Report Suites in the section Data configuration & collection.
3. Select the report suite for which you want to add the eVar by clicking on it (you may also select several report suites if the eVar should be set for several report suites by holding CTRL on your keyboard). Navigate to Edit Settings > Conversion > Conversion Variables.
4. Select the batch of variables that contains the eVar you want to activate (e. g. 201-250 if you want to use eVar201).
5. Click on the + icon next to the variable number to open the sub-menu.
6. Set the status to Enabled.
7. Add the name for the variable (e. g. Zemanta Tracking Parameter).
8. Set the desired Allocation (you may choose from Most Recent (Last), Original Value (First), and Linear).
9. Set the desired value for Expire after (you may choose e. g. Visit, Week, Month, or Custom where you can add a custom time period).
10. Scroll down to the bottom of the page and click on Save.
1.2 Set up processing rule
1. Open Adobe Analytics and navigate to Admin > All Admin.
2. Click on Report Suites in the section Data configuration & collection.
3. Select the report suite for which you want to add the processing rule by clicking on it. Navigate to Edit Settings > General > Processing Rules.
4. Scroll down to the processing rules and click on Add Rule.
5. Set a Rule Title for the newly created rule set (e. g. Zemanta Tracking Parameter). Please make sure to keep in mind the company regulations for naming variables.
6. Set the condition for the newly created rule set (e. g. Overwrite Value of Zemanta Tracking Parameter With Query String Parameter zaid).
7. Make sure that the rules are in the right order, keeping in mind that the execution order is top to bottom (no other rule following the newly created rule set should overwrite the variable you added via this processing rule set). You can change the order by simply dragging and dropping the rules.
Scroll down to the bottom of the page and click on Save.
2. Configure Adobe Analytics API access so Zemanta systems can access that data
NOTE: an Adobe user with Adobe IO Admin access is required to complete this step.
2.1 Creation of the product profile
NOTE: Before setting up the product profile, the integration inside console.adobe.io has to be created.
In short, please select the Product profile that has access to desired Report suites and add metrics (Unique Visitors, Visits, Page Views, Total Seconds Spent, Bounce Rate, and Time Spent per Visit) and dimensions by clicking on the +- icon next to the metric or dimension title.
Step-by-step instructions
Log in to Adobe Admin Console (adminconsole.adobe.com).
Click on Products in the main navigation.
Select Adobe Analytics from the list of products.
Click on New Profile to create a new product profile.
Set a name for the newly created product profile.
Click on Save.
Click on the newly created product profile in the product profiles list.
Inside the newly created product profile, click on the tab Permissions.
Click on Edit next to Report Suites.
Add all report suites for which you want to set up the API connection by clicking on the +- icon next to the report suite title.
Navigate to the section Metrics in the left menu.
Search for the metrics Unique Visitors, Visits, Page Views, Bounce Rate, and Time Spent per Visit (seconds) in the search field and add the metrics by clicking on the +- icon next to the metric title.
Navigate to the section Dimensions in the left menu.
Search for the dimension Zemanta Tracking Parameter in the search field and add the dimension by clicking on the +- icon next to the dimension title.
Navigate to the section Analytics Tools in the left menu.
Search for the Analytics Tool Analysis Workspace Access in the search field and add the Analytics Tool by clicking on the +- icon next to the title.
Click on Save. You are redirected to the Permissions page.
Inside the newly created product profile, click on the tab API Credentials.
Click on Add API Credentials.
Select the checkbox next to the API credentials you want to add to your product profile (e. g. Zemanta Data Export).
Click on Save. You are redirected to the API Credentials page.
2.2 Send a request to our Customer Success Team to receive a unique Adobe certificate
Reach out to our Customer Success Team which will provide you with a unique Adobe certificate. Once you've obtained the certificate, you can move on to the next step.
3. Create a new project in the Adobe Service
Regardless of your platform, you begin with the same steps in Adobe I/O Console:
1. Create a new project in Adobe I/O Console: https://console.adobe.io/home
4. Configure an API Key Integration
1. Choose Add API.
2. Select Adobe Analytics.
3. In the Configure API dialogue window, select Service Account (JWT).
4. Select Upload your public key and drag the unique Adobe certificate you received from the Zemanta Customer Success team to the box.
Your integration should now be created with the appropriate public certificate and claims.
5. Send integration details to Zemanta
1. Enter the name of the integration: Zemanta - Integration
2. Add a short description for your internal purposes.
3. Send the document including the information below to your Zemanta Customer Success Manager.
Copy API Key (client ID)
Copy Technical account ID
Copy the Technical account email
Copy Organisation ID
Retrieve client secret
6. Connect Adobe Analytics to Zemanta campaigns
Once Zemanta confirms that integration is completed on the Zemanta side, the last step is to enable it on the campaign level in the settings tab.
1. Navigate to the Settings tab on the campaign level and scroll down to the “Performance Tracking” section. Then choose “Enable Adobe Analytics performance tracking"
2. Please insert zaid in the tracking parameter field.
You're all done! Zemanta can now automatically ingest your post-click metrics in real-time for all enabled campaigns. Should you ever need to delete this user, simply login to your account permissions and select "Delete" user.
IMPORTANT: Due to the reporting configuration of Adobe Analytics, we aren't able to report on the following metrics: New Users, % New Users, Returning Users, and Average Cost for New Visitors. All other engagement metrics are available (list below).
Supported metrics:
Visits
Pageviews
Bounced Visits
Bounce Rate
Time on Site
Average Cost per Non-Bounced Visit
Unique Users
Click Discrepancy
Pageviews per Visit
Non-Bounced Visits
Total Seconds
Average Cost per Visit
Average Cost per Pageviews
Average Cost per Minute
In order to track 1st Party Analytics data (Adobe Analytics), Zemanta has to append its tracking parameters to every content ad URL. The parameters are expanded on Zemanta's redirector and captured by the analytics on the landing page. Learn more here.