Skip to content

ref-preparing-emails-and-phone-numbers-for-processing.md

Latest commit

 

History

History
54 lines (44 loc) · 2.52 KB

ref-preparing-emails-and-phone-numbers-for-processing.md

File metadata and controls

54 lines (44 loc) · 2.52 KB
title Preparing DII for Processing
description Summary of key steps to prepare your input data for conversion to UID2s.
hide_table_of_contents false
sidebar_position 1
displayed_sidebar docs

import Link from '@docusaurus/Link';

Preparing Emails and Phone Numbers for Processing

The input data that you provide to the UID2 Service must be in the correct format so that the data is correctly converted to valid UID2s that you can use for targeted advertising.

This is true in all cases, whichever of these solutions you're using to convert your emails and phone numbers to UID2s:

  • By making direct calls to the UID2 APIs.
  • Via your own Private Operator.
  • By using any of the UID2 SDK integrations, Prebid.js integration, or Android/iOS integration.
  • By using Snowflake.

Processing Steps

The exact steps for preparing your data to be consumed by the UID2 service are laid out in the Normalization and Encoding documentation. The steps, in sequence, are as follows:

  1. Normalize the raw data.
  2. Create a 32-byte SHA-256 hash of the normalized raw data.
  3. Apply Base64-encoding to the 32-byte SHA-256 value.

If you're making direct calls to the UID2 APIs, or calling the UID2 APIs via your own Private Operator, you must complete each step, exactly as described and in the correct sequence.

Valid Input

If you're using a UID2 SDK, or other integration solution such as the Prebid.js integration, Android/iOS integration, or Snowflake, the options for your input data are shown in the following table.

Type of DII Input Format Instructions
Email Must be one of the following:
  • Raw email
  • Normalized email
  • Normalized, then hashed, then base64-encoded
 [Email Address Normalization](../getting-started/gs-normalization-encoding#email-address-normalization)
[Email Address Hash Encoding](../getting-started/gs-normalization-encoding#email-address-hash-encoding)
Phone Number Must be one of the following:
  • Normalized, including country code
  • Normalized, then hashed, then base64-encoded
 [Phone Number Normalization](../getting-started/gs-normalization-encoding#phone-number-normalization)
[Phone Number Hash Encoding](../getting-started/gs-normalization-encoding#phone-number-hash-encoding)