Mapping Visitor GUID to Contact via REST API 2.0 Form Submit

James Solo

I'm trying to figure out the correct way to architect a REST API 2.0 form submission solution that links the first-party cookie web visitor GUID to the contact.

I found the following documentation in the Eloqua Developer Help Center:

https://docs.oracle.com/en/cloud/saas/marketing/eloqua-develop/Developers/RESTAPI/Tutorials/mapping-contacts-form-submit.htm

At the end, it states

The GUID hidden field value must be in GUID format "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx". To submit form data when you do not have a GUID value, use a value with all zeros for the field. For example: "00000000-0000-0000-0000-000000000000".

Now, I then found the following documentation in the Eloqua Help Center:

https://docs.oracle.com/en/cloud/saas/marketing/eloqua-user/Help/EloquaAsynchronousTrackingScripts/Tasks/BasicPageTrackingFirst.htm

In it, is a code sample for Retrieving the visitor GUID using a first-party cookie

I also found the following when going to my form's HTML Integration Details, with 1st Party Cookies radio option enabled another (different) code sample for retrieving the visitor GUID using a first-party cookie

Here are my questions as I am really confused...

1. Both code samples return a GUID value in a "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" format (no dashes), but the developer documentation states that the format needs to be "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx". Which format is it and if it needs to be with dashes, how do I get that for 1st party cookie?
2. Why are there 2 different code samples for retrieving the 1st party cookie visitor GUID? Which should be used?
3. The developer documentation makes no reference of the elqCookieWrite with having a value set to 0. Is that not needed for REST API 2.0 Form Submissions or is that an oversight?
4. Anyone willing to provide a working code snip that has this working successfully?

Would really appreciate someone from the Eloqua development side to respond as well.

Many thanks,

James

@Lou Patrick

gvikas-Oracle

Hi James,

Please refer to this link for more information on this topic: https://docs.oracle.com/en/cloud/saas/marketing/eloqua-develop/Developers/RESTAPI/Tutorials/mapping-contacts-form-submit.htm

Please let me know if you have further questions.

Thanks

gyan

James Solo

Thanks @gvikas-Oracle , but that was the documentation that I first referenced in my post which resulted in me having to post here as the overall solution is not complete/clear.