How To Embed a LookBook in E9 Emails

   

  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.  

  Preliminary  Step:    

If  you  have  IP  address  restrictions  on  your  Eloqua  account,  you  would   need  to  add  IP  address  to  allow  the  LookBook  email  and  engagement   data  integration  to  work.  If  you  don’t,  skip  this  and  move  on  to  Step  One.     1. In  your  Eloqua  account,  go  to  >>  Setup  >>  Security    

    2. Under  “Restrict  login  by  IP  Address,”  a  checked  box  indicates  that  your   Eloqua  account  does  have  restrictions.    

 

3. Select  “New”  and  type  enter  the  following  IP  addresses  separately  as   Specific  IP  Blocks  and  make  sure  to  save.    

1  

199.27.181.109   199.27.181.110   172.17.116.106    

 

    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.    

 

2  

    4. You  should  see  the  “connected”  indicator,  which  shows  that  your  Eloqua   account  has  been  connected.            

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  

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.        

    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                  

 

4  

                                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.    

 

5  

                         

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.    

 

6  

   

                                      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.                      

7  

      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.      

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.      

8  



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  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.                    

 

9  

               

          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.    

 

10