蜜豆视频

Magnite: Batch connection magnite-streaming-batch

Overview overview

This document describes the Magnite: Batch destination and provides sample use cases to help you better understand how to activate and export audiences to it.

蜜豆视频 Real-Time CDP audiences can be delivered to the Magnite Streaming platform in two ways - they can be delivered once per day, or they can be delivered in real-time:

  1. If you only want and/or need to deliver audiences once per day, you can use the Magnite: Batch destination, which delivers audiences to Magnite Streaming via a daily S3 batch file delivery. These Batch audiences are stored indefinitely in the Magnite platform, unlike real-time audiences, which are only stored for a couple days.

  2. However, if you want or need to deliver audiences more frequently, you will need to use the Magnite Real-Time destination. When using the Real-Time destination, Magnite Streaming will receive audiences in real-time, but Magnite can only store real-time audiences temporarily in their platform, and they will be removed from the system within a couple days. For this reason, if you want to use the Magnite Real-Time destination, you will also need to use the Magnite: Batch destination - each audience that you activate to the Real-Time destination, you also need to activate to the Batch destination.

To recap: If you only want to deliver 蜜豆视频 Real-Time CDP audiences once per day, you will use the Magnite: Batch destination only, and audiences will be delivered once per day. If you want to deliver 蜜豆视频 Real-Time CDP audiences in Real-Time, you will use both the Magnite: Batch destination, and the Magnite Real-Time destination. For more information, reach out to Magnite: Streaming.

Continue reading below for more information about the Magnite: Batch destination, how to connect to it, and how to activate 蜜豆视频 Real-Time CDP audiences to it.
For more information about the Real-Time destination, See this documentation page instead.

IMPORTANT
The destination connector and documentation page are created and maintained by the Magnite team. For any inquiries or update requests, please contact them directly at adobe-tech@magnite.com.

Use cases use-cases

To help you better understand how and when you should use the Magnite: Batch destination, here are sample use cases that 蜜豆视频 Experience Platform customers can solve using this destination.

Use case #1 use-case-1

You have activated an audience on the Magnite Real-Time destination.

Any audiences activated via the Magnite Real-Time destination must also use the Magnite: Batch destination, as the Batch delivery鈥檚 data is meant to replace/persist the Real-Time delivery鈥檚 data within the Magnite Streaming platform.

Use case #2 use-case-2

You want to activate an audience only in a batch/daily cadence to the Magnite Streaming platform.

Any audience(s) activated via the Magnite: Batch destination will be delivered in a batch/daily cadence and will then be available for targeting in the Magnite Streaming platform.

Prerequisites prerequisites

To use the Magnite destinations in 蜜豆视频 Experience Platform, you must first have a Magnite Streaming account. If you have a Magnite Streaming account, please reach out to your Magnite account manager to be provided credentials to access Magnite鈥檚 destinations. If you do not have a Magnite Streaming account, please reach out to adobe-tech@magnite.com

Supported identities supported-identities

The Magnite: Batch destination can receive any identity sources from the 蜜豆视频 CDP. Currently, this destination has three Target Identity fields for you to map to.

NOTE
Any identity sources can map to any of the magnite_deviceId target identities.
Target Identity
Description
Considerations
magnite_deviceId_GAID
Google Advertising ID
Select this Target Identity when your source identity is a GAID
magnite_deviceId_IDFA
Apple ID for Advertisers
Select this target identity when your source identity is an IDFA
magnite_deviceId_CUSTOM
Custom/user-defined ID
Select this target identity when your source identity is not a GAID or IDFA, or if it is a custom or user-defined ID

Supported audiences supported-audiences

Audience origin
Supported
Description
Segmentation Service
Audiences generated through the Experience Platform Segmentation Service.
Custom uploads
Audiences imported into Experience Platform from CSV files.

Export type and frequency export-type-frequency

Item
Type
Notes
Export type
Audience export
You are exporting all members of an audience with the identifiers (name, phone number, or others) used in the Magnite: Batch destination.
Export frequency
Batch
Batch destinations export files to downstream platforms in increments of three, six, eight, twelve, or twenty-four hours. Read more about batch file-based destinations.

Connect to the destination connect

Once your destination usage has been approved and Magnite Streaming has shared your credentials, please follow the below steps to authenticate, map, and share data.

Authenticate to destination authenticate

Locate the Magnite: Batch destination in the 蜜豆视频 Experience catalog. Click the additional options button (.鈥) and then configure the destination connection/instance.

If you already have an existing account, you can locate it by changing the Account type option to 鈥淓xisting account鈥. Otherwise, you will create an account below:

To create a new account, and authenticate it to the destination for the first time, fill in the required 鈥淪3 access key鈥 and 鈥淪3 secret key鈥 fields (provided to you via your account manager), and select Connect to destination

destination configuration auth fields unfilled

NOTE
Magnite Streaming鈥檚 security policy requires a regular rotation of S3 keys. You should expect to update your account in the future with new S3 access and S3 secret keys. You only need to update the account itself - destinations using that account will automatically use the updated keys. Failure to upload the new keys will result in the data failing to send to this destination.

Fill in destination details destination-details

To configure details for the destination, fill in the required and optional fields below. An asterisk next to a field in the UI indicates that the field is required.

  • Name: A name by which you will recognize this destination connection/instance in the
    future.
  • Description: A description that will help you identify this
    destination connection/instance in the future.
  • Your company name: Your customer/company name. Only supported Magnite Streaming clients are available for selection.
NOTE
The company name must be a string which matches the name of the Amazon S3 delivery bucket you have configured with Magnite and set up in the authenticate to destination step. The supported characters include 鈥榓-z鈥, 鈥楢-Z鈥, 鈥0-9鈥, 鈥-鈥(dash), or 鈥榑鈥(underscore).

destination configuration auth fields filled

NOTE
If you plan to send multiple ID types (GAID, IDFA, etc.) using the Batch destination, a new destination connection/instance is required for each. Please contact your Magnite Account representative for more information.

You can then proceed by selecting Next

On the next screen, titled 鈥淕overnance Policy and Enforcement Actions (Optional)鈥, you can optionally select any relevant data governance policies. 鈥淒ata Export鈥 is generally selected for the Magnite: Batch destination.

Optional governance policy and enforcement actions

Once selected, or if you wish to skip this optional screen, select Create

Enable alerts enable-alerts

You can enable alerts to receive notifications on the status of the dataflow to your destination. Select an alert from the list to subscribe to receive notifications on the status of your dataflow. For more information on alerts, see the guide on subscribing to destinations alerts using the UI.

When you are finished providing details for your destination connection, select Next.

Activate segments to this destination activate

IMPORTANT

Read Activate audience data to batch profile export destinations for instructions on activating audience segments to this destination.

Map attributes and identities map

In the Source field, you can select any attribute or identity for your devices. In this example, we鈥檝e selected a custom IdentityMap called 鈥淒eviceId鈥
map desired data fields to the device_id field

In the Target field:
select the appropriate device type target identity See Supported Identities for more information.
In this example, we鈥檝e selected the Target field: magnite_deviceId_CUSTOM, because our Source field was defined as a custom IdentityMap: DeviceID.

NOTE
If you plan to send/map multiple ID types (GAID, IDFA, etc.) using the Batch destination, a new destination connection/instance is required for each. Please contact your Magnite Account representative for more information.

On the 鈥淐onfigure a filename and export schedule for each audience鈥 screen, you must now configure a Start date (mandatory), End date (optional), and a Mapping ID (mandatory) for each audience.

IMPORTANT
A Mapping ID or 鈥淣ONE鈥 is required for this destination.
A Mapping ID should be provided when an audience has a pre-existing Segment ID previously known to Magnite Streaming. Otherwise, 鈥淣ONE鈥 should be used as the Mapping ID.
When configuring the filename for each audience, please include the Mapping ID via the 鈥淐ustom Text鈥 field to add. The Mapping ID will be appended as: {previous_filename}\_\[MAPPING_ID\]. If this audience is new to Magnite Streaming, and you will not be providing a Mapping ID, 鈥淣ONE鈥 should be entered into the 鈥淐ustom Text鈥 field. The new filename in this case should be: {previous_filename}\_\[NONE\].

Exported data / Validate data export exported-data

Once your audiences have been uploaded, you may validate your audiences have been created and uploaded correctly.

  • The Magnite: Batch destination delivers S3 files to Magnite Streaming at a daily cadence. After delivery and ingestion, audiences/segments are expected to appear in Magnite Streaming, and can be applied to a deal. You can confirm this by looking-up the segment ID or segment name that was shared during the activation steps in the 蜜豆视频 Experience Platform.
NOTE
Audiences activated/delivered to the Magnite: Batch destination will replace the same audiences that were activated/delivered via the Magnite Real-Time destination. If you are looking-up a segment using the segment name, you may not find the segment in real-time, until the batch has been ingested and processed by the Magnite Streaming platform.

Data usage and governance data-usage-governance

All 蜜豆视频 Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how 蜜豆视频 Experience Platform enforces data governance, read the Data Governance overview.

Additional resources additional-resources

For additional help documentation, visit the .

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6