App developer frequently asked questions
Why should I develop apps for the app developer framework?
The app developer framework is a complete development platform where you can easily build, register, and deploy apps for Eloqua. With new and improved service types which take advantage of Eloqua's bulk API, support for OAuth, and the ability to test your applications with Eloqua prior to launch, the App Developer Framework provides the environment needed to put apps first.
What permissions do I need to start developing apps for the Oracle Eloqua app?
At the minimum, you need access to an Eloqua instance. If you are not currently an Eloqua user, you can sign up as a technology partner to obtain a development instance. As a user, you will also need the Advanced Users - Marketing permissions.
When and how does my app get listed on the Oracle Eloqua app site?
See building apps for the Oracle marketing app developer framework on Topliners for detailed instructions.
How do marketers find my app to start using it?
Registered apps are listed on the Oracle Cloud Marketplace. Users are linked to this page through the "Get more Apps" link in Eloqua's AppCloud Catalog section.
No. The Oracle Eloqua app exclusively supports contact, account, activity and custom object fields in its record definition fields. You must use the correct Eloqua markup language statement to reference each field.
Is there an Oracle Eloqua app certification program?
Yes. Check out the Oracle Marketing AppCloud Certification Program on Topliners.
What kind of digital certificate is required to communicate with Eloqua?
App's URL endpoints must have an SSL Certificate, specifically needing to be a digital signature from a certificate authority (CA). Eloqua will not communicate with untrusted sites.
What happens during an Eloqua release?
The application and the various associated services will be intermittently unavailable within the duration of the maintenance window. If there are any Bulk API sync failures, they should be retried after the maintenance window completes.
Which version of TLS is supported?
TLS 1.2 is supported.
Oracle Eloqua App Services and Operations
Which service should I develop?
It depends on what you're trying to achieve! See the Service Descriptions for an overview of each service and the use cases it supports.
What's the difference between Oracle Eloqua App services and Cloud Connectors or Components?
Eloqua Oracle Eloqua app services greatly extend the functionality provided by cloud connectors and cloud components. Cloud content replaces cloud components, allowing you to process emails in bulk and test the service within Eloqua. Unlike cloud connectors and components, the Oracle Eloqua App services use Eloqua's bulk API for processing, greatly improving performance and throughput.
Can I include campaign, email, landing page, form fields in my record definition?
No. The Oracle Eloqua app exclusively supports contact, account, activity and custom object fields in its record definition fields. You must use the correct Eloqua markup language statement to reference each field.
Can I include static values in my record definition?
No. You can only specify the Eloqua markup language for Eloqua fields.
Managing Your Apps
What does this app status mean?
See the Oracle Eloqua Help Center for a list of all the different status messages you can see related to app members moving through your campaigns and programs.
What if my request to refresh a token times out?
If the current access token has not been used, submitting a request to authenticate with the previous refresh token will return the existing new access token and refresh token.
What happens if contacts encounter an error in an Action or Decision step? What happens if the service is unavailable when contacts flow into a step on the canvas?
The contacts remain in the step until the marketer manually pushes them into the next step on the canvas.
Does Eloqua notify me when someone uninstalls or deletes my app from their Eloqua instance?
If you set an Uninstall URL it will be called when a user uninstalls the app.
Why has my app been shut down?
If in the last five minutes, there were more than 100 calls, and 25% of them failed, the app will be shut down. All the pending and future requests will be marked as failed. See the App shutdown for more information.
Will Eloqua retry my contacts if my app doesn't respond?
No, the contacts in a step will be marked as "Errored". If the marketer has configured a default path for the contacts to flow through, then the contacts will flow into the next step.
What if my app responds to the notify call after 100 seconds?
Any response after 100 seconds will be ignored.
What if my app responds to the notify call with a response status code that is not 200 level?
If Eloqua calls out to your app and receives a response status code that is between 300 and 599, Eloqua will retry the notify call over approximately an eight-hour period of time with a backoff strategy of the time between calls doubling after each call. After this eight-hour period, the contacts in a step will be marked as "Errored". If the marketer has configured a default path for the contacts to flow through, then the contacts will flow into the next step.
Why does my app prompt the error "502 Error: App Provider not Available"?
This error message will appear if a URL has been configured with a non-standard port. Eloqua only supports the standard ports 80 and 443. If a URL is not configured with port 80 or port 443, requests to this URL will fail.
Limits
Are there limits that I should be aware of?
The AppCloud developer framework relies on the bulk API. The bulk API has limits on the size of the staging area for imports and exports, on the amount of data you can import at one time, and on the number of fields you can include in a record definition. There is also a daily limit on the number of syncs you can perform. For more details, see: bulk API limits.
What happens if I reach the daily sync limits?
The daily sync limit is not currently enforced, but syncs are logged and monitored.