This technical implementation guide provides information about the reference architecture, ​guidelines, configuration steps and tests that implementation specialists need to follow while integrating Adobe Target with Adobe Campaign.

This technical integration guide is intended for Adobe Consultants, Adobe Partners, and other experienced implementation specialists. Configuring this integration requires a full understanding of the implementation process for each individual solution covered in this guide.

Adobe customers can contact Adobe Professional Services or an Adobe Partner to learn more about this integration.

Integration Options

Benefits/ Limitations

Option #1: Adobe Campaign and Target integration

Option #2: Offers in Adobe Campaign emails coming from Target recommendations using Rawbox

Target can track the following data:

  • User agent
  • IP address
  • Geographical location
  • Segment associated with the visitor's ID in Target (subject to legal approval)
  • Data from Campaign Datamart

There are several limitations:

  • Because only an image can be used, content cannot be personalized
  • Tracking is not consolidated in Adobe Campaign
  • No unified user experience
  • You must use both Target and Campaign to set up different parts of the integration:
    • The rawbox and the experience in Target
    • The delivery in Campaign

Solution Planning and Integration Architecture

Pre-requisites (License, Connectivity, Initialization)

In order to use the integration between Adobe Campaign and Adobe Target, you must have:

  • Adobe Marketing Cloud and Adobe Target tenants
  • An Adobe Target rawbox specified to establish the connection with Adobe Campaign

Implementation Architecture

Option #1: Using Adobe Campaign Target Integration

#

If your goal is

Create a Campaign that contains

Adjust Campaign

1 Optimize image based on clicks on image

Adbox with Redirect offers

No Target code required on web site

N/A
2

Optimize image, track click on image through your site including conversion

Track view-through and click-through and conversion

  • Adbox with different image Redirect offers (for acRawbox)
  • Same Redirector URL (acRawbox_click)

Target code required on web site.

  • Change the a href adbox call type to from ubox/raw? to ubox/page?
  • Optional: Change a href default image URL from image to page url

 

3

Optimize landing page, vary destinations

See which landing page leads to most conversions

  • Adbox with image Redirect offer (for acRawbox) or default image
  • Different Redirector URLs (acRawbox_click

 Target code required on web site

  • Change the a href adbox call type to from ubox/raw? to ubox/page?
  • Optional: change a href default image URL from image to page url

 

4 Optimize image, track click on image and keep same experience on your web page.
  • Adbox with different image Redirect offers (for acRawbox)
  • Different Redirector URLs (acRawbox_click)

Target code required on web site

  • Change the a href adbox call type to from ubox/raw? to ubox/page?
  • Optional: change a href default image URL from image to page url

Adjust the Integration Based on your Goal:

<a href='https://adobeinternalags133.tt.omtrdc.net/m2/adobeinternalags133/ubox/page?mboxXDomain=disabled&mboxXDomainCheck=true&mboxSession=<%= (document.mode == "preview")? Math.random() * 10000: message.id%>&mboxPC=<%= (document.mode == "preview")? Math.random() * 10000 : message.id%><%= (document.mode == "preview" || delivery.FCP) ? "&mboxHost=Preview": "" %>&gender=<%= recipient.gender%>&mbox=acRawbox_click&mboxDefault=mysite.com' target="_blank">
 
    <IMG style="BORDER-TOP: medium none; BORDER-RIGHT: medium none; BORDER-BOTTOM: medium none; BORDER-LEFT: medium none" alt="Dynamic Image" src='https://adobeinternalags133.tt.omtrdc.net/m2/adobeinternalags133/ubox/raw?mboxXDomain=disabled&amp;mboxXDomainCheck=true&amp;mboxSession=<%= (document.mode == "preview")? Math.random() * 10000: message.id%>&amp;mboxPC=<%= (document.mode == "preview")? Math.random() * 10000 : message.id%><%= (document.mode == "preview" || delivery.FCP) ? "&amp;mboxHost=Preview": "" %>&amp;gender=<%= recipient.gender%>&amp;mbox=acRawbox&amp;mboxDefault=mysite.com%2Flogo.gif' />
    </a>
1
2

Installation, Provisioning and Configuration

Set-up/ Provisioning

Settings Adobe Campaign

  1. Note: Adobe Campaign must have connection to Internet.
  2. Follow the instructions from the Adobe Campaign Help section
  3. Configure Adobe Campaign - Target integration under Administration > Platform > Options
  4. Do not change the TNT_EdgeServer value, it is already set by default and correct
  5. Set only the TNT_TenantName to Target Clientcode. 
3
4

   6.  Clientcode resides in Adobe Target Classic under Confguration > Edit.

5

Note:

Only after adding the TNT_TenantName the menu "Dynamic image server by Adobe Target" is available.

6

Set the default image when timeout occurs or server not available and the name of the rawbox. Passing parameter is optional and can be used for targeting or to be passed in the Scene 7 URL.

7

Campaign-Target OOB Generated Code

8

Settings Target Classic

Creating Campaign A/B..N Campaign Type

9

Creating Redirect Offers with the Given Images

10

Add Offers to Experience

You will see redirect to for the adbox_click only if the a href adbox call type is changed from ubox/raw? to ubox/page?

With redirector the mboxSession will be set when clicking on the link and redirected to the given URL.

Case 1: optimize image through conversion - all experiences redirect to the same URL in acRawbox_click

11

Case 2: optimize image and keep same experience - every experience redirect to different URL in acRawbox_click

12

Set Conversion

Conversion is set to seeing acRawbox_click, landing page and conversion page.

13

Mbox Host

mboxHost=Preview is set on sending proofs and preview. This setting is to separate production from staging and dev for reporting. Check the settings under Target Configurations > Hosts and move Preview to the right host group.

14

Check the Mbox/Adbox Type

under Locations>List.

15

Setting Target Standard

Create Target Standard Tests with the Form Based composer.

 Creating Campaign A/B..N Campaign Type

16

Creating Redirect Offers with the given images and URLs

Under Content create Redirect Offers for the Images

17

Create offer for the redirect to the landing page. In Target Standard Form Composer we do not have the possibility to enter the URL directly, it must be wrapped in Redirect offer and the mbox session id must be passed.

18

Add Offers to Experience

Case 1: optimize image through conversion - all experiences redirect to the same URL in acRawbox_click

19

Case 2: optimize image and keep same experience - every experience redirect to different URL in acRawbox_click

20
21

Set Conversion

Conversion is set to seeing acRawbox_click, landing page and conversion page.

22

Mbox Host

mboxHost=Preview is set on sending proofs and preview. This setting is to separate production from staging and dev for reporting. Check the settings under Setup > Hosts and move Preview to the right host group.

23
mbox MY_EMAIL_NAME

adbox_name

adbox_name_click

name of the adbox, use start with ad or raw combined with email name to separete them logically from mbox on page

adbox_name_click is generated automatically
mboxPC UNIQUE_ID_PER_EMAIL 12345

Identifies the visitor, generated with message id unique per recipient and email

Needed for image only; mboxPC for image/link click will be picked up based on the mboxSession passed

Note: id is timestamp when mboxHost is preview
mboxSession UNIQUE_ID_PER_EMAIL 12345

Identifies the session valid for 30 min, generated with message id unique per recipient and email, same as mboxSession

Needed for image and link click

Note: id is timestamp when mboxHost is preview
mboxXDomain disabled disabled Do not attempt to set 3rd party domain cookies
mboxXDomainCheck true true  
mboxDefault DEFAULT_URL
DEFAULT_IMAGE_URL
http://yoursite.com

Note: there is no timeout when using adbox.

Defualt content will be shown if there is no Target Campaign targeting location to the adboxes.

Consider changing the default URL for click otherwise it will go to the default image if the adbox_click is not targeted.

mboxHost MBOX_HOST Preview

Separate Target Production from Development reporting

Set only when Preview in Adobe Campaign and Sending proof, otherwise nothing

Settings under Target > > Configurations > Hosts, move it right host group

Generate mboxPC and mboxSession UNIQUE_ID_PER_EMAIL

See 
HowTo: Offers in Adobe Campaign Emails coming from Target Recommendations using Rawbox#GeneratemboxPCandmboxSessionUNIQUE_ID_PER_EMAIL

URL Example
https://adobeinternalags133.tt.omtrdc.net/m2/adobeinternalags133/ubox/raw?mbox=acRawbox&mboxDefault=http://switzerland.isyours.com/images/img.346.1.jpg&mboxPC=12345&mboxSession=9876

Tracking Conversion

  1. Clicking on Image in the Email: http://XXXX.com/jjesquire/list.html?mboxSession=79002&mboxPC=79002
  2. Landing Page: mboxSession and mboxPC are set on the first call to Target
24

     3.  Going to Order confirmation the same values for mboxSession and mboxPC remain. The visitor is identified through the journey.

25

Reporting

Summary Report

26

Success Metric Report - Tracking on Conversion Steps

27

Personalizing image in Target Redirect Offer with Scene7

Example Scene7 image: http://s7g3.scene7.com/is/image/AdobeDACHSC/kfzschild?$schildtext=$

Adding parameter to Scene7: http://s7g3.scene7.com/is/image/AdobeDACHSC/kfzschild?$schildtext=$munich

In the redirect offer add a Scene7 URL and add the parameter available in Target user.currentCountry with the syntax ${user.currentCountry}

28

Concerns / questions (recommendations integration)

Q: Is there documentation on how to integrate Recommendations within Email?

A: Integrating Recommendations with Email

To configure Adobe Campaign:

  1. Install the Integration with the Adobe Marketing Cloud standard package. Installing an integration package is the same as installing a standard package, which is detailed in the Package Import section. This gives you access to the shared assets via Digital Asset Manager.
  2. Enable connection via IMS (Adobe ID connection service) to use images shared via Adobe Marketing Cloud in your emails. Consult the section about IMS.
  3. In Administration > Platform > Options, configure the server and Tenant options for Adobe Target:
    • TNT_EdgeServer: Adobe Target server used for the integration. This option is already selected by default. This value corresponds to the Adobe Target Domain Server, followed by the value /m2. For example: tt.omtrdc.net/m2.
    • TNT_TenantName: Adobe Target Tenant name. This value corresponds to the name of the Adobe Target Client.
33

Option #2: Offers in Adobe Campaign emails coming from Target recommendations using Rawbox

Using the Download-Only Template

Creating Adobe Campaign workflow responsible for:

  • Making API call to Recs for specific campaign
  • Getting CSV file for recommended Products with Product ids
  • Connect Product Ids with Product information (e.g. name, description, price)
  • Connect Product data with own look and feel for each item

Put the data in the Email

  • Note: No direct tracking of performance under Visitors as the call to Recs is made once for downloading the file
  • Recs server cannot track the performance of Recs or split traffic across algorithm/template combination

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy