This document provides answers to commonly asked questions relating to the ability to replicate your production instance into your sandbox. Please be aware that this feature was rolled out as BETA in Winter '13 to registered BETA customers only. We do not yet have a date for General Availability.

** ERRATA: Please note that as of the Summer '14 release, the navigation path in Eloqua 10 has been changed from Setup> Sandbox to Settings> Setup> Sandbox.  As the Sandbox functionality is still in beta status, this document is not being updated for the Summer '14 release.  Please be sure to make that change on any previously downloaded versions of the attached PDF.  Thank you.

Harry Beckwith wrote about “Selling the Invisible”.  While progressive when written, the tech boom has allowed for greater advancements in customer engagement.  It has also created an increased challenge in not only selling the invisible, but standing apart from the noise.  In a conversation with Adam Kranitz, Avid’s Senior Manager for Social Strategy and Editor-in-Chief of Avid Blogs, it’s clear Avid has figured out how to do just that.  

Found in 1987 Avid pioneered digital video editing and currently holds 200 patents.  Now through the Avid Everywhere strategic vision, Avid is helping content creators and media organizations connect with consumers more powerfully, efficiently, collaboratively, and profitably.

So how does this global leader drive revenue, and foster loyalty?  Below are 6 practices that Adam incorporates into Avid’s content strategy and customer experience.

1. “Avid’s core content beliefs center on people, purpose, and then technology.  Content needs to feel human.  It’s about the creative professionals who are using the platform.”
2. “We invest in imagery.  While we’re selling the invisible, the customer experience is easily seen.  The product is in the background.  Humans are the focus of the imagery.  We also hire a professional photographer to capture customer interaction at events.”
3. “We leverage the people closest to the experience.  We use social media as the platform tocombine knowledgeable customers with subject matter experts at Avid to connect with the creative community. “
4. “Community development is a priority at Avid.  Our Director of Online Communities and Customer Advocate, Marianna Montague, has guided our extremely active and well trafficked customer forums for over 8 years. These customer forums are pivotal in upgrade decisions.  Customer communities show that their peers have made the investment and also demonstrate momentum in the marketplace.  This also creates brand loyalty.  We have people who have been customers for 25 years and Marianna ensures all customers have a voice within the company”
5. “We measure content effectiveness and understand which content should be used at each stage of the process.  For example, tutorial content is good for deciding between companies and products. We also know that our most effective content is produced by the customer.”
6. “Avid has a content vision.  We plan on developing a virtual newsroom.  We don’t want to replace trade journals, but certainly supplement them.  AvidBlogs.com already has 323 articles contributed by multiple sources. Partners want visibility, and product teams want awareness and support.  Also, once you gain momentum everyone want to get on board. “

It’s through these practices that Avid has become a more customer-centric organization and opened the doors to new markets.  It’s also why they’re a leader in customer engagement.  I encourage you to check out the phenomenal work they’re doing with their communities as well as how they’re engaging with customers and leveraging imagery on their Instagram, Twitter, and YouTube channel.  You can also follow Adam on Twitter @AdamKranitz.

Hi everyone,

I want to learn more about Insight reports. I was wondering is there any video tutorials?
Is it possible to do video tutorials in any subject?

// Carina

4Thought Marketing, an Oracle/Eloqua Gold Partner, is growing fast and looking for a solution consultant in the US - work remote, that's fine with us.  If you like helping others enhance their Eloqua experience, and expand it beyond their wildest dreams, then 4Thought Marketing is the place to be.

Check out the job on LinkedIn - https://www.linkedin.com/job/consumer/overview/index/11017444 (don't let the city fool you, we had to pick one).

Send us a note and let us know why you think you'd be the best person for 4Thought Marketing - careers@4thoughtmarketing.com.

Anyone who was successful in clearing "Implementation Specialist Exam" Beta exam or the production exam now.Need a few tips as I would be appearing for this shortly.

thanks In Advance.

You've written an App, but now you need to register it with Eloqua! Before you can start sharing your App with Eloqua users, you'll need to register as a Provider of Apps in your Eloqua development instance, and register each App you create along with any associated Services. You can also test your Apps within your instance to make sure they work as expected. When you register as a Provider, your Eloqua instance stores the public information about your company so that users can contact you about your Apps.

Step 1: Register as a Provider

To register as a Provider, log in to your Eloqua instance, and navigate to the Setup menu, then choose AppCloud Developer.

Then, click Create a Provider, which brings you to the AppCloud Developer "Edit Provider Details" page.

Fill out your company's information:

• id: your unique Provider id. This is the only field you cannotedit once you click Save. You will be prompted to choose an alternate id if the one you provide already exists.
• Icon URL: the URL of the icon Eloqua should display with your Provider information. You might want to use your company logo.
• Name: your Provider name. You might want to use your company name.
• Website URL: your company website.
• Support email address: the email address users should use to contact you if there are issues with your app.
• Support phone number: the phone number where you can be contacted if there are problems with your app.

Click Save, and you're all set up as a provider! You can easily edit this information by selecting the Provider tab within the AppCloud Developer section of Eloqua, and clicking Edit.

Step 2: Register Your App

You're more than half way there: you've registered as a provider and developed an app, but you still need to tell Eloqua where to find it and what it does.

To register your app, select the Apps tab in the AppCloud Developer section of Eloqua

If you have not yet registered any Apps, you will see a "No apps have been defined" message, and the "Create new App" button. If you have already registered an App, it will be listed, alongside the "Create new App" button. To register your App, click Create new App.

The Create App screen prompts you to fill in a number of fields that describe your App: the App's name and description, URL of its icon, etc.:

Details

These fields are general information about your App.

• Icon URL:
• Name:
• Description:
• Short Description:

Lifecycle

The Lifecycle fields

• Enable URL: the URL called when the App is first installed or when it is reconfigured
• Status URL: the URL called to check the App's status. See: How To: Respond when Eloqua calls out to check the status of your App for more about calls to the Status URL.

OAuth

Apps for the AppCloud™ use OAuth for authentication. For more information about configuring OAuth, see: OAuth and Eloqua.

• Client ID (App id): Eloqua creates and assigns the App ID when you save your App.
• Client Secret: Eloqua generates the secret access token when you save your App. Click Show to view it.
• Callback URL: the URL that the users should be redirected to after installing the app and authenticating with Eloqua.

When you've filled in all fields, click Save, and your App will be listed on the Apps tab of the AppCloud Developer area and on the AppCloud Developer landing page.

Step 3: Add Services (if your App has services)

Finally, you should register any services your app uses. The AppCloud Developer Platform currently supports five services: AppCloud Menu, Firehose, AppCloud Content, AppCloud Actions, and AppCloud Decisions.

Apps can include zero services, as in the case of a a portal app, or integration not directly tied to one of the service types, for instance, or many services. If you are implementing services as part of your app, you need to define them within Eloqua by clicking Add Services on the App Details page.

A modal window opens listing the types of services Eloqua currently supports: select the service type you've implemented.

Then, fill out the service's details: you will have different information you need to supply depending on the service you are implementing. For an AppCloud Menu, you need to provide the Action URL, specify the areas it supports and how Eloqua should present it, and provide the service's icon URL, name, and description. For AppCloud Content, you will need to fill out instance configuration details, as well as configure content and notification settings, as well as the general service details. The following documents describe the service configuration page for each service type:

• AppCloud Menus
• AppCloud Content
• AppCloud Actions
• AppCloud Decisions
• AppCloud Feeders
• Firehose

When you are done configuring your service, click Save. A green alert message will appear at the top of the page indicating the Service has been successfully saved.

Step 4: View your App!

You can view the App information by clicking its name in the list, in this example AppCloud Docs Example App, which brings up the App Details page.

The App Page shows all of the App information, including Services, and now includes Publish and Catalog sections, which are used to grant access to the App. When you register an App, it immediately becomes available in your instance of Eloqua so you can test it before releasing it to any other prospective users. When you're ready to release your App, or just to share it with a select few, check out the App installation tutorial.

I just read in an email from Oracle, "Oracle Marketing Cloud Support is pleased to announce the transition of support for the Oracle Eloqua cloud services to Oracle’s support portal, My Oracle Support."  Do you think that Oracle should leave Eloqua's name and branding intact?

Eloqua recently made some infrastructure changes in support of additional data centers.  To support these additional data centers, a new API endpoint was created to allow you to interface with Eloqua regardless of where the Eloqua install is located.  In this post we share details of this new endpoint.

Until now, almost all customers resided in the same production environment.  The API could therefore be accessed using the base URL of https://secure.eloqua.com.  In the coming months, new customers will be deployed in the new data centers, and some customers may move between data centers, and will therefore have a different URL than what you have seen in the past.

What does this mean to you as a developer?

Depending on the Eloqua customer that is trying to use your app, your API calls may no longer work!

Here's the good news...

There is now an endpoint that allows you to determine the URL for your API calls.  This endpoint is https://login.eloqua.com/id.

The endpoint, when called with basic authentication or OAuth authentication, will return details about the URLs for the various APIs.

Here's how to use it:

Request (basic authentication):

GET https://login.eloqua.com/id HTTP/1.1
Authorization: Basic XXXXX

Response (success):

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 824

 

{
    "site": {
        "id": 42,
        "name": "MyTestInstall"
    },
    "user": {
        "id": 314,
        "username": "TJ.Fields",
        "displayName": "TJ Fields",
        "firstName": "TJ",
        "lastName": "Fields",
        "emailAddress": "tj.fields@eloqua.com"
    },
    "urls": {
        "base": "https://www05.secure.eloqua.com",
        "apis": {
            "soap": {
                "standard": "https://www05.secure.eloqua.com/API/{version}/Service.svc",
                "dataTransfer": "https://www05.secure.eloqua.com/API/{version}/DataTransferService.svc",
                "email": "https://www05.secure.eloqua.com/API/{version}/EmailService.svc",
                "externalAction": "https://www05.secure.eloqua.com/API/{version}/ExternalActionService.svc"
            },
            "rest": {
                "standard": "https://www05.secure.eloqua.com/API/REST/{version}/",
                "data": "https://www05.secure.eloqua.com/API/Data/{version}/",
                "bulk": "https://www05.secure.eloqua.com/API/Bulk/{version}/"
            }
        }
    }
}

Now that you have the URLs for the API(s), you can use them in your code.

Response (failure):

HTTP/1.1 200 OK

Content-Type: application/json; charset=utf-8

Content-Length: 20

 

"Not authenticated."

 

Tip: When calling this endpoint from a  Cloud Connector or Cloud Component app,  if an API call fails with a 401, your application should call the /id endpoint again to determine whether the 401 was the result of the user's credentials/token being invalidated, or the result of the site being moved to a different data center.  If the /id endpoint returns a failure, your application should stop making API calls.  If the /id endpoint returns a success, your application should retry the API call at the new address in the response.

 

Here's a quick flowchart showing the fallback process:

 

 

Interactive applications can respond to 401s using this process, or by simply logging the user out.

An update rule is a data tool used for data cleansing and normalization of Contacts, Companies, Prospects, or Custom Objects. In this example, we will create an update rule to normalize a contact field (Country) based on a lookup table field.

A lookup table is simply a list of two columns of values, one column for values to perform the lookup on, and one for values that will be used to replace the original values.

For example:

First, we will create a Lookup Table that will be used in the Update Rule.

1. In Eloqua, go to Contacts> Data Tools.
2. Click the Data Tools menu, and then click New Lookup Table.
3. Enter an appropriate Display Name such as Normalize Country.
4. Enter an appropriate description (optional).
5. Enter a Lookup Value Column Name. This is the name of the column of field values that you are replacing, for example, Country.
6. Enter a Replacement Value Column Name. This is the name of the column of field values that will replace the original field values, for example, Normalized Country.
7. Check or clear the Values are case-sensitive field. In this example, we will leave this cleared.
   • Note: This setting can only be changed when the table is empty.
8. Click Save.
9. Add values to the lookup table manually by entering the lookup value, the replacement value, and then clicking Add. You may also upload entries from an existing file by going to Manage Entries> Upload Lookup Table Entries.
10. Click Save.

You may end up with a lookup table that looks similar to this:

Next, we will create an update rule to use the created lookup table:

1. In Eloqua, go to Contacts> Data Tools.
2. Click the Data Tools menu, and then click New Update Rule Set.
3. Enter an appropriate Update Rule Set Name, such as Normalize Contact Country.
4. Select Contacts as the Entity Type.
5. Click Add Update Rule.
6. Click the Select a field to update field to open the Contact Field Search window, and then search for the contact field that you want to normalize.
7. Select the field and then click OK.
8. From the Select an update action list, select Overwrite value from Lookup Table Field.
9. Make sure that the field that you are normalizing is selected in the Select a lookup field list.
   • Note: This will perform the lookup on the same field that it is replacing. You may want to take a less destructive approach by updating to a new field, such as Updated Country, to retain the original field values.
10. Click the Select a lookup table field to open the Lookup Table Search window, and then search for your created lookup table.
11. Select the lookup table and click OK.
    • Select Overwrite if lookup value not found to set a static value if the lookup value is not found in the lookup table. In this example, we will leave this unchecked.
    • Select Make this rule Conditional to make the update based on the conditions of a certain field, for example, if the Title is equal to CEO. In this example, we will leave this unchecked.
12. Click Apply and then click Save.
    • Note: An update rule set may contain one or more Update Rules which are run in top to bottom order; you may change the ordering by dragging and dropping Update Rules in the Update Rules list.

Once you have created an Update Rule set, you can run it on a shared list:

1. In Eloqua, go to Contacts> Shared Library.
2. Click Shared Lists.
3. Open the shared list that you want to run the update rule on.
4. Click gear menu and select Run Update Rule.
5. Select the Update Rule from the list and then click Continue.
6. Change the email address if necessary, and then click Continue. A notification will be sent by email when the update is complete.

In a future article, we will discuss how to use an update rule in Program Builder.

Hi All,

My Question is where can I see the list of emails which haven't got uploaded during upload contacts

For example if I am uploading a list of 3 contacts, 2 of them has same mail id, out of total 3 only 2 got imported, and 1 is not imported because of same mail id.

Is there any location where I can see the 1 contact which hasn't  got uploaded showing the reason why it has not uploaded.

I do checked the upload History, in Setup > Integration > Inbound > Reporting > Upload History, but there it is displaying the total number of contacts in the list, but not in details as to which email ids haven't got uploaded

Please help me on this, thank you

Hi community,

     Am am working in eloqua 10 asynchronous page tracking scripts.

I have followed the Eloqua Asynchronous Tracking Scripts (with Support for First-Party Cookies : Open Beta Program, Summer '14) .

and integrated that code to my external website's page to track the page and to populate the details of a particular contact in that page. The first part is working and am getting tracking information from eloqua.

But the second thing seems to be not working ie the contact details not populated in the page.Given below is the code that i have tried

<html>

<body>

<script type="text/javascript" LANGUAGE='JavaScript'>

        var _elqQ = _elqQ || [];

        _elqQ.push(['elqSetSiteId', '123456789']);// suppose this is my site id ,not the actual one

        _elqQ.push(['elqTrackPageView']);

        (function () {

            function async_load() {

                var s = document.createElement('script'); s.type = 'text/javascript'; s.async = true;

                s.src = 'http://img.en25.com/i/elqCfg.min.js';

                var x = document.getElementsByTagName('script')[0]; x.parentNode.insertBefore(s, x);

            }

            if (window.addEventListener) window.addEventListener('DOMContentLoaded', async_load, false);

            else if (window.attachEvent) window.attachEvent('onload', async_load);

        })();

    </script>

<SCRIPT TYPE='text/javascript' LANGUAGE='JavaScript'><!--//

function CreateRow(label, value)

{

    var p = document.createElement('p');

    var b = document.createElement('b');

    p.appendChild(b);

    b.appendChild(document.createTextNode(label));

    p.appendChild(document.createTextNode(value));

    document.getElementById('contactinfo').appendChild(p);

}

function SetElqContent()

{ alert('SetElqContent');

    if (this.GetElqContentPersonalizationValue)

    {

      CreateRow('General: ', GetElqContentPersonalizationValue(''));

      CreateRow('Email Address: ', GetElqContentPersonalizationValue('C_EmailAddress'));

      CreateRow('First Name: ', GetElqContentPersonalizationValue('C_FirstName'));

      CreateRow('Last Name: ', GetElqContentPersonalizationValue('C_LastName'));

      CreateRow('Title: ', GetElqContentPersonalizationValue('C_Title'));

      CreateRow('Company: ', GetElqContentPersonalizationValue('C_Company'));

      CreateRow('Business Phone: ', GetElqContentPersonalizationValue('C_BusPhone'));

      CreateRow('Address: ', GetElqContentPersonalizationValue('C_Address1'));

      CreateRow('City: ', GetElqContentPersonalizationValue('C_City'));

      CreateRow('Salesperson: ', GetElqContentPersonalizationValue('C_Salesperson'));

  } else

  {

      CreateRow('Personalization functions not found','');

  }

}

//--></SCRIPT>

<SCRIPT TYPE='text/javascript' LANGUAGE='JavaScript'><!--//

    _elqQ.push(['elqDataLookup', escape('ee8064e78750439db75280586860f863'),'<C_EmailAddress>mymail@gmail.com</C_EmailAddress>']);//this email address is present in eloqua contact

//--></SCRIPT>

<div id="contactinfo">

</div>

</body>

</html>

As per the eloqua documentation after loading this page the call back function SetElqContent get executed and the div is populated with specific contact details returned.

But haven't get any contact details associated with the given email(mymail@gmail.com) in the datalookupvalue .

Do you have any idea on this problem? Is anything wrong from my understanding or in the code that i have tried?

Any help will be appreciable.Eloqua Support,Eloqua Administrator,Leigh Burke

Hi

T.J. Fields,Fred Sakr do have any idea regarding the same?

I've been workiing with the REST API and have run into some snags.

1. I am trying to convert the Eloqua form into a Flash object. In order to do this, I need to examine the entire form structure. I don't see any documentation for the subfields of the form (e.g. element, validation, etc.). Does this exist?

2. The html returned in the html field of the forms object is not legal. (e.g there are tags in the value attributes of input fields) Is this intentional?

3. I noticed that some of the form fields include a reference to an OptionList (optionListId) which I can then use to download the option list using a separate API call. I had some form fields referring to an OptionList called "Default" and all of those fields never returned the optionListId even though the optionList existed and I could edit it, add items to it, etc. What is the purpose of this default OptionList? Once I've deleted it, can I recreate it? Is there a way to indicate to the system which is to be the default list? How does one know which list is the default if no optionListId is included? If I want to create a form from an element that has no OptionListId, how can I know which optionList to ask for?

What is your social media of choice?

We have folders in Campaigns and Emails.  Can i genetrate a report based on this folders.

Ex.

1. I need to generate a report for EHG group for all their campaigns.
2. I need to generate a report for EHG group for all the Newsletter campaigns.

Campaigns Folder Structure

EHG / EPG are Group Co's

Comp1,2,3 are sub co's respectively.

Please help me on this.

Looking to do  little bit of research prior to A/B split testing. 

What are you primarily using the Custom Data Objects for?

A while back I did a post Consuming the EloquaService WSDL with PHP that later turned out didn't really work too well!

Many developers are running into issues consuming the EloquaService WSDL, which is preventing them from building on the Eloqua Platform.

Well, there is now good news...Eloqua has developed an Eloqua PHP Client, and it is now in Alpha testing.

If you are a developer working with PHP, and are having trouble using the Eloqua API, please go to the link above and check out the great work that Syed has done!

I am attempting to find the number of engaged contacts over the last 12 months. I have run the Database health dashboard and the figure it gives me for active engaged contacts is 1/3 the number of contacts returned when i run a segment with the following criteria:

1) opened an email in last 12 months. or

2) Clicked through from an email in the last 12 months. or

3) submitted a form in the last 12 months

When i run a segment without the "opened an email" criteria it comes back with half the amount the database health dashboard say are engaged. Therefore I wonder what exactly does the database health dashboard consider as an engaged active prospect?

Also is it best practice to consider an email open as an engagement?

Thanks

Kevin