Overview

PII Tokenized Sending is a patented (in-progress) MoEngage feature that allows you to engage with your customers without storing their Personally Identifiable Information (PII) within the MoEngage platform.

PII data includes:

• Customer contact details: Email ID, mobile number.
• Customer personalization information: First name, last name.

Tokenization replaces this sensitive data with non-sensitive, anonymous tokens. This feature enables you to segment, personalize, and run campaigns while MoEngage remains fully compliant with data privacy regulations like GDPR. 

For more information about MoEngage's data privacy compliance, refer to GDPR Compliance and PII Masking.

Use Cases

• Enhance Data Security: Engage your audience through targeted campaigns without storing sensitive PII, such as email addresses or phone numbers, in MoEngage.
• Ensure Compliance: Meet stringent data privacy regulations by anonymizing customer identities in your marketing platform.
• Maintain Personalization: Continue to use personalization in your campaigns by fetching data in real-time.

Configuration

You can configure a PII API to retrieve customer email IDs or mobile numbers during campaign dispatch.

1. Configure PII API

2. API Settings

You can fetch data for users individually or in batches.

Single  Bulk

By selecting single, you can fetch a response based on each request. This helps you fetch particular responses instead of huge data sets.

Perform the following steps:

• Method: Select the GET or POST method.
• Request URL: Type or paste the "Request URL" of the API.
• Parameters: Type or paste the relevant "URL parameters", "Headers", and/or "Body" details for the API as key-value pairs. You can personalize the URL parameters and request headers by typing @ in the placeholders while entering the key-value pairs.

By selecting bulk, you can fetch a maximum of 500 user attributes in a single request, significantly reducing the number of requests made to collect each customer data individually.

1. Enter the batch size of your request.
2. API configuration
   • Method: Only the POST method is supported in bulk.
   • Request URL: Type or paste the "Request URL" of the API.
   • Parameters: Type or paste the relevant "URL parameters," "Headers," and/or "Body" details for the API as the key-value pairs.

     info

     Note You cannot personalize the URL path parameters and headers in bulk requests. You can only personalize user attributes in the request body with the key-value pairs as follows: Customer hash: {{UserAttribute['ID']}} value, which is mandatory in input, and the same key will be returned in the output.

3. Sample Request: Your request will be processed in the backend, as shown below:
   JSON

   
                   {
                     "abcd": "abcd",
                     "CustomerInBulk": [
                     {
                       "Customer hash": "{{UserAttribute['ID']}}"
                     }
                   ]
                 }
                 

4. Customer hash is a key, and 456 {{UserAttribute['ID']}} is the value. You can have different key-value pairs, for example: Customer key and Customer ID.
   Sample Response: You will receive a response from the backend, as shown below:
   JSON

   { 
   “CustomerInBulk”: {
    { 
   Customer hash: “456”,
    First name: “John”, 
   Last name: “doe”,
    Email ID: “xyz@abc.com” 
   Phone number: “9876543210” 
   }, 
   { 
   Customer hash: “567”, 
   First name: “Joe”, 
   Last name: “Bloggs”,
    Email ID: “ioh@abc.com” 
   Phone number: “1234567890” 
   } 
   }, 
   }

   The data will be returned with the same key (user attribute) you requested.

   info	Note You can have multiple key sets but can make a personalized request based on user attributes from only one key set.

3. Test and Save Configuration

After defining your API settings, you must test the configuration to ensure MoEngage can correctly retrieve the data.

1. Enter a valid test value for the anonymous ID you configured (for example, 456).
2. Click Test to trigger the API call.
3. Review the API response to ensure it is successful and returns the correct data.
4. In the Email/Mobile Number field in API response list, select the response key that contains the customer's email or mobile number (for example, Email_ID).
5. Click Save to finalize the configuration.
   

PII-Based Campaign Workflow

The following diagram illustrates the data flow when sending a campaign with PII Tokenized Sending enabled.

1. A campaign is triggered in MoEngage.
2. MoEngage calls your configured PII API, passing the anonymous IDs of the eligible users.
3. Your API retrieves and returns the corresponding email address or mobile number for each anonymous ID.
4. MoEngage sends the campaign content and the fetched PII to your configured Email, SMS, RCS, or WhatsApp service provider.
5. MoEngage immediately deletes the fetched PII (email, mobile number, and any other data fetched via Content APIs for that campaign) after sending it to the provider.
6. The service provider delivers the message to the end customer.
7. The service provider sends delivery status data back to MoEngage.
8. MoEngage maps the delivery data back to the campaign using a unique message ID and deletes any PII that may have been returned in the delivery receipt.
9. Campaign analytics are updated on the MoEngage dashboard.

Anonymization Support

Here are a few other changes implemented to support customer anonymity in the MoEngage platform.

• Campaign Sending Logs-If Tokenized Sending has been configured for a specific channel, the campaign logs will stop storing email or mobile number data (depending on the channel for which PII Tokenized Sending is configured) from the next instance of the campaign run (post the configuration change).
• Campaign Delivery data - MoEngage tracks delivery data for all the native connectors and maps the delivery data back to a campaign using the message ID field.
  

  info	Information Delivery information is not tracked for custom (SMS, RCS, and Email) connectors.

• Segmentation - The 'show count' query lists the user count as part of both Segmentation from the Segment > Create Segment navigation and Segmentation in campaigns. However, the reachable user count cannot be shown in both cases as MoEngage does not store the mobile number or email address (which is the basis for calculating reachability).
• Current campaigns (live campaigns) - If there are any live campaigns for that channel (point channel or flows) when the PII API settings are configured, sending will be done by fetching the Email ID or Mobile number from the very next instance.
• Personalized Preview - This feature is automatically disabled for the channel after PII settings are saved. You can request to re-enable it by contacting your Customer Success Manager (CSM).
• Campaign Testing Failure Reason-When testing a campaign when it is being created (for the channel where PII configuration is set), if the API fails to respond, the API error will be shown in the UI.
• Campaign Analytics - The customers for whom the PII API configured above fails to retrieve the customer sending ID (Email ID or mobile number) will not be counted in the Campaign delivery stats in the Campaign Info or Analytics section. This is because this funnel accounts for users with a valid Email ID or Mobile number.
• Content Personalization when customer data is not available in MoEngage - While the PII API above focuses on retrieving the customer's sending ID (Email ID or Mobile number), MoEngage's Content API feature allows you to fetch any data (PII and/or other) directly from your database in real-time when the campaign is about to be sent to the end customer. For more information, refer to Personalization using Content APIs.

Frequently Asked Questions (FAQ)