How To Guide: Embedding a LookBook in an Eloqua 9 Email The LookBook integration for Eloqua 9 allows you to add LookBooks to emails in Eloqua. To accomplish this, there are four major steps you need to accomplish.
Step One: Connect your LookBookHQ account to Eloqua [Setup]
1. Log in to your LookBookHQ account. 2. Hover your mouse over “My Profile” on the top left of your screen; click “Settings.”
3. Scroll down to the “Integrated Tools & Apps” section and enter your Eloqua login credentials: Company name, username, and password. Click “Save” at the bottom of the page.
4. You should see the “connected” indicator, which shows that your Eloqua account has been connected.
1
Step Two: Push a LookBook to Eloqua
You have connected your LookBookHQ account to Eloqua, you would need to make specific LookBooks of your choice available in Eloqua. 1. While logged into your LookBookHQ, select to the LookBook of your choice from the dashboard. 2. Click Sharing & Settings.
3. Scroll down to “Integrated Tools And Apps.” Click “Push to Eloqua”
4. Wait for the message confirming that your LookBook has been successfully pushed to Eloqua.
2
Step Three: Set up the Custom Field.
If you will be using the Custom Objects (Data Card) feature, proceed with this step; otherwise, skip and go straight to step four. After pushing the LookBook to Eloqua, you’ll need to do some minor configuration in Eloqua, to setup engagement data tracking via Custom Objects. 1. On the top toolbar, go to Communicate >> Email Marketing >> Email
2. From Tools & Content Components >> Email Field >> New Email Field
3
3. From the New Email Field window that launches, add a Contact Field Value by pressing the search button. 4. This will launch the Contact Field Search window. Select “Eloqua Contact ID” and click OK.
4
5. When you’re back on the New Email Field window, you should see the Contact Field Value set to “Eloqua Contact ID” as you selected. Now set the display name to ELQContactID. Save and close.
Step Four: Add the LookBook to your email.
After configuring Eloqua, you’ll need to add the LookBook to an HTML email in Eloqua. 1. Grab the HTML embed code from your LookBook’s Sharing & Settings.
5
2. If you are not using the Custom Object feature to feed in LookBook engagement data, you can copy and paste this code into your email editor. However, if you are using the Custom Object feature to feed in LookBook engagement data, you will need to make a couple of modifications to the HTML embed to enable the engagement data tracking to work properly. We recommend using a text editor like NotePad, TextMate or TextEdit. 3. First, change the “short URL” in the embed code to the long URL. The long URL can be seen after you enter the short URL into your browser. The short URL typically appears in the format http://lbhq.it/ABCD while the long URL typically appears in the format http://yourcompany.lookbookhq.com/overlay/ABCD.
6
4. Add the snippet to the end of the URL in the href attribute within the tag; that is just before the “” ?elqcontact=<span >ELQContactID1
Your tag should now look like this.
5. 6.
7. 8.
Ensure that you have the HTML email open in your Eloqua email editor. Switch to the Source Editor Copy and paste your modified HTML embed code from (4) into the part of your email where you want the LookBook to be. Switch from the Source Editor to the Design Editor to see a preview of your LookBook.
9. Note: In the event
that you see some stray 7
HTML in the design editor’s preview, it might be caused by Eloqua’s source editor not properly escaping the code; so make sure to send a test email.
The test email should look fine and not contain the stray html. If the test email contains html, make sure that your html embed code looks like the one in the example (in step 4) above.