Update a Data Marketplace Segment Metadata File

To sell your Data Marketplace segments, download a Data Marketplace segment metadata file via Connect, update the file, and then upload it back to Connect.

Note

You can also use the segment metadata to specify any advertisers you want to block from accessing your segments in the Data Marketplace. However, blocking advertisers from accessing your segments in the Data Marketplace has no effect on the ability of those advertisers to access your segments in any other downstream platforms that you distribute your Data Marketplace segments to. See "Blocking Advertisers from Data Marketplace Segments" for more information.

Tip

If you only need to provide info on a small number of segments, you can update the info for each segment individually. However, only some types of information can be added individually (for example, you can't block an advertiser from accessing the segment in the Data Marketplace with this method). See "Enable an Individual Segment" for more information.

Caution

Once you’ve distributed your Data Marketplace segments to another destination platform, do not use a segment metadata file to edit the segment metadata for those segments. If you edit the segment metadata, those changes will not be implemented in any downstream platforms. To change segment metadata for existing segments, upload the segments again as new segments and then provide the new metadata. After you’ve confirmed that the new segments are available in the downstream platforms, work with the platforms to disable the previous versions. See "Edit Existing Data Marketplace Segment Information" for complete instructions.

A Data Marketplace segment metadata file is a comma-separated value (CSV) spreadsheet file containing information about a list of segments. Once you download the segment metadata file and open it, this is what it looks like:

C-Update_Segment_Metadata_File-sample_file.jpg

After you check the information in the columns that have been automatically populated, and revise or add any additional information, upload the segment metadata file via Connect.

Caution

UTF-8 Characters Only: LiveRamp cannot process segment metadata files that contain non-UTF-8 characters. Make sure to remove any non-UTF-8 characters and then save your file in the "CSV UTF-8" file format before uploading.

Tip

Just need to enable or disable an existing Data Marketplace segment? Once information has been provided for a particular segment, you can disable it (to remove it from the Data Marketplace) or enable it without having to update a new segment metadata file. Hover over SELL DATA in the left navigation bar and then select "Sell Data". Check the check box for the desired segment, and then click either Enable on Data Marketplaceor Disable (depending on the desired action).

Follow the steps below to make sure that the information in the segment metadata file is entered properly for all segments before uploading the taxonomy file:

Warning

Do not modify the first eight columns: These columns are automatically populated with the info provided when the segment was uploaded, and if they are modified the segment metadata file upload will fail.

Caution

Once you’ve distributed your Data Marketplace segments to another destination platform, do not use a segment metadata file to edit the segment metadata for those segments. If you edit the segment metadata, those changes will not be implemented in any downstream platforms. To change segment metadata for existing segments, upload the segments again as new segments and then provide the new metadata. After you’ve confirmed that the new segments are available in the downstream platforms, work with the platforms to disable the previous versions. See "Edit Existing Data Marketplace Segment Information" for complete instructions.

  1. Make any necessary changes to the segment name in the "Segment Name" column (column I). This column is automatically populated with the info provided when the segment was uploaded, but might need to be edited to make sure the naming follows the guidelines in “ Naming Data Marketplace Segments”.

    Caution

    For segments being distributed to Facebook: Segment names cannot be longer than 108 characters after adding the number of characters in your data provider name.

  2. Provide a brief description of the segment in the "Segment Description" column (column J). This is mandatory for syndicated segments, as this description helps data buyers understand the information contained in the segment. This is optional but still recommended for custom segments. Avoid special characters (aside from ">", which is allowed) and line breaks/carriage returns in segment descriptions.

    Caution

    For segments being distributed to Facebook: Keep segment descriptions to 245 characters or less.

  3. Choose the use cases for the segment. For each of the use case columns (columns M-Q), enter "Y" to enable the segment for the use case specified in the header, or "N" to disable that use case. For a list (and definitions) of these use cases, see "Data Marketplace Permitted Use Cases".

  4. Enter price information for the segment in the appropriate price column(s) (columns R-U). See "Data Marketplace Pricing Options" for more information.

    Note

    All syndicated segments being distributed to social media platforms are billed at the pre-set percentage of media spend specified by the data provider (either 10% or 15%) and all custom segments are billed at 15% of media spend.

  5. Choose whether the segment is custom or syndicated. In the "Custom" column (column V), enter “Y” for custom segments (available only to specific platforms) or “N” for syndicated segments (available to all platforms).

    Caution

    If a segment is listed as "custom", platform IDs must be entered in the “Allowed Platforms” column (column W).

  6. Enable the segment for the Data Marketplace by entering "Y" in the "Seller Approval" column (column AA), or enter “N” to disable it.

    Note

    Segments are subject to a review and approval process before being fully enabled in the Data Marketplace.

  7. Enter the three-digit code for the country or region where the data can be bought in the "Country Code" column (column AC)(the default is "USA").

    Tip

    For a list of available countries/regions and codes, see "Countries Where Data Marketplace Data Can Be Sold".

  8. Enable the segment for Customer Profiles by entering “Y” in the “Customer Profiles” column (column AE). This allows data buyers who are enabled for Customer Profiles to use the segment to perform overlaps or build a combination segment.

    Note

    You must be opted in for Customer Profiles for this column to appear in the segment metadata file. Contact your LiveRamp rep to take advantage of these additional monetization opportunities for your data.

  9. See the "List of All Columns" section of this article for a description of other columns you might wish to enter info for.

  10. Save the file in the "CSV UTF-8" file format.

  11. Upload the file via Connect.

The table below lists all of the columns in the segment metadata file, along with information about the data for that column.

Category (Column Letter)

Required?

Data Type

Notes

Automatically configured (columns A-H)

N/A

These first 8 columns are automatically populated with the info provided when the segment was uploaded. Do not modify these columns.

Segment Name (column I)

Yes

Text

This field denotes the name of your segment for external use, and is automatically populated with the info provided when the segment was uploaded. Make sure the naming follows the guidelines in “Naming Data Marketplace Segments”. Example: "Company > Pet Owners > Dog Owner"

Segment Description (column J)

Yes

Text

A brief description of your segment. Example: "A segment that contains dog owners."

Data Source (column K)

No

Numeric ("1", "2", or "3")

How the data was sourced: “1” for a deterministic source, “2” for modeled data, and “3” for other.

Data Source (column L)

No

Text

Any additional information on the data sourcing method. Example: "Known data"

Use Cases (columns M-Q)

Yes

Binary (“Y” or “N”)

For each column, enter "Y" to enable the segment for the use case specified in the header, or "N" to disable that use case. For definitions of these use cases, see "Data Marketplace Permitted Use Cases".

Price (columns R-U)

No

Numeric

Price for the use cases in columns M–Q. Do not include currency signs, such as “$”.

Custom (column V)

Yes

Binary (“Y” or “N”)

Whether this segment is custom (available to specific platforms) or syndicated (available to all platforms). Use “Y” for custom segments and “N” for syndicated segments. If platform IDs have been entered in the “Whitelist Platforms” column, this value must be set to “Y”.

Allowed Platforms (column W)

Yes (for custom segments)

Platform ID

Leave this column blank if the segment should be made available to all platforms (i.e., it's a syndicated segment). Enter the platform ID if the segment should be made available to a specific platform. If there are multiple platform IDs, separate them with commas. Download the Data Marketplace reference sheet for a list of platform IDs.

Blocked Advertisers (column X)

No

Text

Any advertisers you don't want to be able to access the segment in the Data Marketplace. Download the Data Marketplace reference sheet to find the exact advertiser name to enter. Separate multiple advertiser names with commas. See "Blocking Advertisers from Data Marketplace Segments" for more information.

Seller Comments (column Y)

No

Text

Any comments you want to make visible to the buyer. This is typically used for custom segments to specify platform and seat ID. Example: "Custom segment for Brand A, in Platform B, seat ID = 123"

Seller Approval (column Z)

Yes

Binary (“Y” or “N”)

Whether this segment should be enabled in the Data Marketplace (subject to Business and Privacy approval). Enter “Y” to enable the segment (and “N” to disable it).

Estimated Reach (column AA)

N/A

Numeric

Estimated number of LiveRamp cookies matched with the Data Marketplace segment. This will be automatically generated for you.

Country Code (column AB)

Yes

Text

Where the data can be bought. The default is "USA". For a list of available countries/regions and codes, see "Countries Where Data Marketplace Data Can Be Sold".

Currency (column AC)

Yes

Text

The currency that will be displayed for the segment. The default is USD (U.S. dollar), but you may change it to the desired ISO Currency Code (i.e., "EUR" for Euro).

Opt-in for Customer Profiles (column AD)

No

Binary (“Y” or “N”)

Whether this segment is enabled for use in Customer Profiles. Use “Y” to enable the segment and “N” to keep the segment from being used in Customer Profiles.