UserIdentifier

  • The user_identifier_source field indicates the source of the user identifier when uploading from specific Google Ads services.

  • The identifier union field must contain exactly one of the listed identifier types.

  • Accepted identifier types include hashed email, hashed phone number, mobile ID, third-party user ID, and address information.

  • Different Google Ads services accept different subsets of the available identifier types.

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.