Using Oracle Contextual Intelligence
You can use Oracle Contextual Intelligence (Context) through a web-based user interface or programmatically via APIs. In addition to the UI, you can also use APIs to integrate Context directly to your systems.
In this topic
You log into Context by going to https://admin.grapeshot.co.uk/login/ and using credentials supplied by your Oracle Data Cloud representative.
When you open Context, you see the Segments page with a selection of tiles. Each tile represents a keyword segment. Both standard and custom keyword segments are shown, including segments for contextual targeting, brand safety and prediction.
The selection of tiles is customized for each Context instance, providing you with a visual overview of your keyword segments. Your customized dashboard is called your zone.
The tiled view of the dashboard is called the Grid view. Grid view is the default, but there are two other views: List and Taxonomy. Each view provides access to different capabilities. You select the view by clicking its icon at the upper right of the Segments page.
The Taxonomy view displays the full segment hierarchy. You can drill down from segments to sub-segments and to keywords.
The List view displays all segments in a scrolling and sortable format. For each segment you see:
- Type (custom or standard)
- Page coverage
Click on a row to view sub-segments; click on a sub-segment to view keywords. Click in the Status column to view the matching inventory for each segment.
Standard segments are defined by Oracle and configured into your zone based on your business needs. Standard segments such are read-only. Only our editorial team can edit them. If you need to edit them for a brand or campaign, contact your Oracle representative to have the segments or sub-segments recreated as custom segments.
To view information about a standard segment, click its tile on the Segments page.
The page changes to display the segment's sub-segments.
Segments and sub-segments can support multiple languages. Your contract determines how many languages you can use at the same time; the default is one. You select the language for a sub-segment by choosing from the drop-down menu in a tile.
After you select the language, you see the keywords in the sub-segment along with a scrolling display of matching inventory.
Colors and symbols provide information about keywords.
- Gray shading indicates a standard keyword.
- Blue shading indicates a required keyword.
- Red shading indicates an excluded keyword.
- An upward arrow indicates a boosted keyword. Boosting increases the significance of the keyword during analysis and categorization.
To download a spreadsheet of the keywords in a segment, use the download arrow.
Standard brand safety segments
There are 11 standard brand safety segments. In addition, our experts proactively identify websites that may be conducting other nefarious activity, such as illegal downloads or spreading harmful viruses, and identify these URLs and publishers for pro-active exclusion from targeting in our systems.
Custom segments are ones that you create and configure. You select the keywords to include and set configuration options. You can boost keywords, make them required, and mark them for avoidance. The segment must include enough keywords must be to make it relevant for matching. (Context informs you if you your segment does not include enough keywords.)
To create a custom segments:
Click the “+” sign in the top navigation bar.
Specify the purpose for which you are creating the segment: Contextual Targeting or Brand Safety.
Specify whether the segment is for Predicts. If not, the keywords remain unchanged unless you update them. If you click “yes” to Predicts, the keywords automatically update every 24 hours based on relevant content.
- Name the segment. Note that some platforms and partners require specific naming conventions.
Add relevant keywords by typing words and phrases. Context provides suggestions based on what Suggestions are given in the interface. Click keywords after they appear in the page to boost, exclude, or to require an exact match. (Our technology does not require exact matches so we can find variations of the same words.)
After you have created one or more custom segments, you publish them so that Context can begin to analyze web pages and match them against you keywords. Context indicates that there are segments to publish by adding a red dot to the publish icon in the upper right of window and by adding a colored publish icon to segment windows.
To publish custom segments:
Click the Publish icon in the Context window or in a segment creation page.
If you published from a segment creation page, it updates to indicate that the segment is active. In some cases, Context adds information about possible related segments.
Additional features of the dashboard
The dashboard also includes these features:
- Displays URLs for which the segment would find a match.
- Shows the number of pages that are anticipated to be found for targeting by chosen segments.
- Allows for segments, including their keywords, to be downloaded as a data file.
You can integrate with Context by using APIs. For example, you can share the results of a page categorization and subsequent segment match (including the scores) can be shared via an API. APIs can provide results for matches for all types of segments, including Predicts.
Contact an account manager to receive an API key and to receive technical guidance on implementing Oracle Context for specific use cases.
There are two primary APIs:
- The Signal API handles the exchange of data between Oracle Contextual Intelligence’s servers and partner servers during contextual analysis on page requests.
- The Keyword API handles and updates keyword segments.
You can also integrate with context by using flat files, such as spreadsheets and structured data files. For example, you can use flat files to request proactive categorization of specific publishers’ websites or pages. These pages will then be categorized in our system and ready for match before there is a request from an advertising technology partner. Similarly, you may want to exclude certain URLs proactively.
Contact your Oracle Data Cloud representative for information about using this capability.