UserIdentifier

  • The user_identifier_source field specifies the source of the user identifier for various upload services.

  • The identifier field is a union field where exactly one of the listed options must be specified, varying depending on the service used.

  • Accepted identifier types include hashed email, hashed phone number, mobile ID, third-party user ID, and address information, with each type being valid for specific services.

  • Hashed email and hashed phone number are accepted across multiple services including Customer Match, Store Sales, ConversionUploadService, and ConversionAdjustmentUploadService.

User identifying information.

Fields

user_identifier_source

UserIdentifierSource

Source of the user identifier when the upload is from Store Sales, ConversionUploadService, or ConversionAdjustmentUploadService.

Union field

identifier

identifier. Exactly one must be specified. For OfflineUserDataJobService, Customer Match accepts hashed_email, hashed_phone_number, mobile_id, third_party_user_id, and address_info; Store Sales accepts hashed_email, hashed_phone_number, third_party_user_id, and address_info. ConversionUploadService accepts hashed_email and hashed_phone_number. ConversionAdjustmentUploadService accepts hashed_email, hashed_phone_number, and address_info. identifier can be only one of the following:

hashed_email

string

Hashed email address using SHA-256 hash function after normalization. Accepted for Customer Match, Store Sales, ConversionUploadService, and ConversionAdjustmentUploadService.

hashed_phone_number

string

Hashed phone number using SHA-256 hash function after normalization (E164 standard). Accepted for Customer Match, Store Sales, ConversionUploadService, and ConversionAdjustmentUploadService.

mobile_id

string

Mobile device ID (advertising ID/IDFA). Accepted only for Customer Match.

third_party_user_id

string

Advertiser-assigned user ID for Customer Match upload, or third-party-assigned user ID for Store Sales. Accepted only for Customer Match and Store Sales.

address_info

OfflineUserAddressInfo

Address information. Accepted only for Customer Match, Store Sales, and ConversionAdjustmentUploadService.