Formatting Identifiers

Follow the guidelines listed below when formatting identifiers (whether known or anonymous identifiers).

For a list of identifiers that can be hashed, see "Hashing Identifiers".

Note

Known identifiers and PII identifiers are sometimes referred to as "offline identifiers". Anonymous identifiers and device identifiers are sometimes referred to as "online identifiers". See "Identifier Data" for more information.

Warning

Do not combine known identifiers and anonymous identifiers in a single file.

When Formatting File Data, you may include as many plaintext postal addresses per individual as you know, but if you have multiple addresses for the same person, place each on a separate row along with the same "first name" and "last name" info (but segment data values do not need to be duplicated/included on those additional rows).

Note

Because postal addresses are comprised of multiple fields, including only one per row ensures there are no accidental mismatches of elements from the different address fields. If you need to include multiple addresses per row, contact your LiveRamp representative for details.

Each of the elements listed below is required for name and postal address identifiers, and each element must be in a separate column:

Caution

Make sure to separate names into first and last name fields. Do not include middle name(s) or initials.

Element

Header(s)

Notes

First name

FIRSTNAME

Last name

LASTNAME

Street address

ADDRESS1

ADDRESS2 (optional)

A single full address field should not contain a newline character. This tends to occur when you generate the data in a spreadsheet application like Excel and place two lines inside one cell.

City

CITY

State

STATE

ZIP code

ZIP

You can include either 5-digit or 9-digit (ZIP+4) values. If sending 9-digit values, do not include hyphens. Note: Matching using only ZIP+4 is available for certain use cases. Contact your LiveRamp representative for details.

Caution

LiveRamp cannot accept hashed name and postal address data. Unfortunately, there is too much variation in casing and whitespace to do this reliably.

LiveRamp accepts plaintext and SHA-1 hashed phone numbers (see Hashing Identifiers for more information).

Caution

EU data files cannot contain hashed phone numbers. Email addresses are the only identifiers that can be hashed in EU data files.

You may include as many phone numbers per individual as you know. Place all phone numbers for the same person in the same row, with each phone number in its own distinctly-labeled column. This minimizes file size and ensures there are not conflicting segment values tied to the same identifier.

Note

If including multiple phone numbers, be sure to use unique field names (for example, "HOME_PHONE" and "MOBILE_PHONE").

Use one of the allowed formats listed below:

  • +1XXXXXXXXXX

  • +1 (XXX) XXX-XXXX

  • (XXX) XXX-XXXX

  • XXX-XXX-XXXX

  • XXX XXX XXXX

  • XXXXXXXXXX (this format must be used if hashing)

LiveRamp accepts plaintext and SHA-256, MD5, or SHA-1 hashed email addresses (see " Hashing Identifiers" for more information).

Note

Want the highest match rates? Your match rates might be slightly lower with hashed email addresses than with plaintext emails. To maximize the match rates for hashed email addresses, send all three hash types, each in a separate column.

You may include as many email addresses per individual as you know. Place all email addresses for the same person in the same row, with each email address in its own distinctly-labeled column. This minimizes file size and ensures there are not conflicting segment values tied to the same identifier.

Note

Make field names unique: If including multiple email addresses, be sure to use unique field names (such as "EMAIL1", "EMAIL2", etc.).

When formatting file data before uploading files, do not modify (e.g., by changing casing) cookie values.

LiveRamp accepts the following plaintext or SHA-1 hashed mobile device IDs (see Hashing Mobile Device IDs for more information):

  • Identifier for Advertisers (also known as IDFA) (Apple/iOS devices).

  • Android Advertising ID (also known as AAID) (Android devices).

Plaintext mobile device IDs should be downcased and hyphenated. For example: 1f4d256c-1f08-41f6-a108-bbe511de9497.

Plaintext AAIDs ( Android device IDs) and IDFAs ( iOS device IDs) can be included together in the same file. LiveRamp can match off of both IDs at the same time as long as they are in plaintext. All IDs should be in a single mobile device ID column, regardless of whether the ID is an AAID or an IDFA.

Caution

Have both types? Hashed AAID IDs and hashed IDFA IDs cannot be accepted in the same file. To send both types of hashed mobile device IDs, put them in separate files.

LiveRamp accepts SHA-1 hashed mobile device IDs. See "Formatting Mobile Device IDs" for more information.

Before hashing:

  • AAIDs must be downcased and hyphenated

  • IDFAs must be upcased and hyphenated

Caution

Hashed AAID IDs and hashed IDFA IDs cannot be accepted in the same file. To send both types of hashed mobile device IDs, put them in separate files.

When formatting file data before uploading files, do not modify (e.g., by changing casing) custom ID (CID) values.