FAQs
Can I use non-secure (http) URLs for API calls?
No, you must use secure (https) URLs. Calls to insecure URLs result in a 403 Forbidden error.
How do I get the web services authentication key?
If the link to your Oracle Data Cloud API keys is not displayed in the platform UI, contact My Oracle Support (MOS) and request access to Oracle Data Cloud web services. You need these keys to successfully call the Oracle Data Cloud APIs.
Why does Oracle Data Cloud code and tags include references to BlueKai and bk?
These references are the result of legacy naming policies.
How do I test integration with Oracle Data Cloud APIs without running live campaigns?
Contact your client service manager who can set up a test partner and provide you with the information necessary to get started.
I get an HTTP error 400 when I attempt to use the API service.
A 400 error code is returned for any error. Review the body content of the 400 response for a JSON string that indicates the nature of the error.
How often does the data that is accessible through the API get updated?
We update data for reporting hourly and we have APIs accessing many different types of data. Some are refreshed hourly and some daily, such as inventory reach data and the audience discovery report data.
Is the data store that the partner site accesses to provide reporting the same data store that the API accesses?
Yes, where possible we use the external web services as the backbone of our internal services.
Can I make updates to a campaign after it is active?
Certain fields such as recency, data source (prospecting, retargeting), and segment cannot be changed due to business reasons. Create a new campaign if you need to make changes to those fields.
Can I delete a campaign using the API?
Yes. To delete a campaign, set its status field value to HIDDEN. The campaigns API returns a JSON object showing the successful change in the field's value.
I use the taxonomy API to get the number of unique users in a category. How often is that updated?
Values are updated daily based on the audience configuration.
Using the segment reach API, I query the size of a specific audience built with Boolean operators and category IDs. How long can I safely cache that size?
You can safely cache the data for 24 hours because the data is updated daily.
How is the user data API used with an ID swap?
Create a container that includes an ID swap tag and then add a phint to your container for passing your UUIDs to the Oracle Data Cloud platform. Once the ID swap is triggered for a user, the user data API can transfer their attributes to the platfom. You can use the containers API to programmatically create additional containers and their site IDs. If you are already ID swapping with the platform and storing the Oracle Data Cloud UUID (BKUUID), you can pass the BKUUID in your ID swap tag.
Oracle Data Cloud API Reference