When UBX users share an audience, UBX sends a collection of IDs and associated data that is defined as a segment in a source database and moves the data to a segment that is defined in a destination database. No point-to-point software integration is required.
To share audience data, a registered UBX endpoint can call APIs that are hosted by UBX or implement specific UBX APIs that UBX can call. The APIs enable UBX to describe the audience data that you can produce, run jobs to export or import the data, and report on the status and success of each audience data exchange.
- An endpoint provider registers with UBX as an audience source. The endpoint declares a contact
URL and the personal identifiers and descriptive metadata it can provide.
- UBX calls the source endpoint to gather audience metadata. UBX displays summary descriptions of
the audience and its contents in the UBX interface.
- In UBX, users select a source audience and destination endpoint. Users also map identifiers and
attributes in the source audience to corresponding data in the destination endpoint. UBX users can share the audience immediately, schedule sharing for a later time, or schedule
sharing on a recurring basis.
- UBX calls the source endpoint to get the audience data. The source endpoint uploads the audience
- UBX can download the audience data to the registered URL for the destination endpoint over HTTP.
The destination endpoint can use the UBX Toolkit to pull the audience data from UBX.
Request audience data
UBX provides a graphical interface for users to search for appropriate audiences, review
audience descriptions, and specify how and when to share audience data.
UBX gets the details about the audience by making an API call to the URL that was specified when
the endpoint was registered.
In UBX, users specify how to share audiences as follows.
- Select an audience. Users search for and select an audience that provides identifiers and
attributes that are best suited to achieving a business objective.
- Select a destination. Users select a destination endpoint. Each user can see only the endpoints
that are registered with UBX on behalf of their UBX user account.
- Map identities and attributes. Users map identities and attributes that are present in the
source audience to corresponding data that is used in the destination endpoint.
- Share the audience. Users can share the audience immediately, schedule sharing for later, or
schedule sharing on a recurring basis. Users can also indicate how UBX modifies the destination
audience. UBX can add records to a new or existing database, replace records in an existing
database, or remove specific records from the destination database.
Connect audience endpoints with UBX
UBX endpoints connect with UBX through RESTful APIs. Endpoints call or implement UBX APIs
depending on how the endpoint provides or consumes audience data.
UBX refers to the exchange of audience data between endpoints through UBX as data
syndication. As an endpoint provider, you can use the UBX Integration Manager to declare a
syndication type when you define the UBX application on which your UBX endpoint is based. After
completing the process to be an approved UBX endpoint, you can exchange audience data through UBX by
implementing APIs that UBX can call, or by calling various APIs that are hosted by UBX.
All API requests to UBX require that the request header include an authorization bearer that is a
customer-supplied authentication key. Providing the authentication key verifies the connection
between a specific UBX user account and a user account in the endpoint application. As part of its
Click to Connect endpoint registration, UBX supports two ways for users to provide
their authentication credentials.
Audience data is shared through UBX by a source and a destination endpoint as a list of
comma-separated values (CSV). UBX requires that, as an audience producer or consumer endpoint, you
indicate whether the data exchange occurs as a push to UBX or the endpoint, or as a
pull from UBX or the endpoint.
The distinction between audience sharing as PUSH or PULL depends on how the audience data moves
between an endpoint and UBX. How the data flows between UBX and source and destination endpoints
also determines where the audience sharing APIs are hosted.
- PULL-type audience producer. UBX calls APIs that are hosted and implemented by
the source endpoint. When the source endpoint indicates that data is available, UBX pulls audience
data from the source endpoint.
PUSH-type audience producer. The source endpoint calls APIs that are hosted by
UBX. When the source endpoint determines that it can make audience data available, the source
endpoint pushes data to UBX.
- PULL-type audience consumer. The destination endpoint calls APIs that are
hosted by UBX. When the destination endpoint is ready to accept audience data, it pulls data from
- PUSH-type audience consumer. UBX calls APIs that are hosted and implemented by
the destination endpoint. UBX pushes audience data to the endpoint when the data is shared by an
As an endpoint provider, you must declare an endpoint type as part of the endpoint provisioning
and review process when you use the UBX Integration Manager to define the UBX application on which
to base your endpoint.