Skip to content

Developer Platform

Search docs & API
Log in
Sign up

Use Limited Data Processing flag

Advertisers can use a Limited Data Processing flag to help them comply with State Privacy Laws as described in the U.S. State-Specific Data Terms attached as Exhibit C to the Pinterest Advertising Services Agreement.
  • With this flag, Pinterest will limit how we use certain data to help advertisers comply with user privacy settings for users to whom a state privacy law applies.
  • For example, an advertiser might implement the Limited Data Processing flag for users who have opted out of the sale or sharing of their data.
  • When the flag is used, Pinterest will act as a service provider or processor, as applicable, with respect to flagged data from users to whom a state privacy law applies.
Advertisers are responsible for complying with user opt-outs, as well as identifying the user's state of residency when implementing the Limited Data Processing flag.
Advertisers are responsible for complying with user opt-outs, as well as identifying the user's state of residency when implementing the Limited Data Processing flag.

Ingestion sources and data fields

Pinterest advertisers can send flags in multiple ways. See the currently available ingestion sources and data fields below.

Limited data processing CPRA data fields

FieldsDescription
opt_out_type
  • Type: String
  • Optional
opt_out_type
is the field where we accept opt outs for privacy preference. It can handle multiple values with commas separated. Current accepted value is
LDP
for Limited Data Processing.
Notes:
  • Please leave this field blank or don't include at all in payload if we explicitly specify that these events are not subject to LDP.
  • We only process opt-outs if the value passed is LDP.
  • For detailed field name, please refer to ingestion sources and implementation.
st
  • Type: String
  • Optional
st
is the field for sharing a user's state of residency in connection with use of the LDP flag. Please note that the LDP flag does not currently have any effect for users outside of the State of California, Colorado, Connecticut, Delaware, Florida, Iowa, Maryland, Minnesota, Montana, Nebraska, New Hampshire, New Jersey, Oregon, Tennessee, Texas, Utah, or Virginia.
  • The state names we accept are SHA256 hashed, standard USPS state abbreviations with two characters:
    CA
    CO
    CT
    DE
    FL
    IA
    MD
    MN
    MT
    NE
    NH
    NJ
    OR
    TN
    TX
    UT
    VA
    .
  • Example: 15cbe5f066da796145940479d571424695e3077a1de270cb04972942d5b16260
    CT
country
  • Type: String
  • Optional
country
is the field in which you pass a user's country of residency in connection with use of the LDP flag. Note that the LDP flag does not currently have any effect for users outside of the United States.
  • The country names we accept are SHA256 hashed, standard ISO-3166 country codes with two characters (e.g.,
    US
    ).
  • Example: 9b202ecbc6d45c6d8901d989a918878397a3eb9d00e8f48022fc051b19d21a1d
    US

Limited data processing ingestion sources and implementation

Ingestion sourcesLimited Data Processing Implementation
Pinterest API for Conversions
Enable the LDP flag
  1. Pass
    LDP
    value through field
    opt_out_type
    for Pinterest API (v5). For more details, please refer to the
    POST
    Send conversions
    .
  2. Pass
    LDP
    value through field
    opt_out_type
    for v1/v3 API if you haven't switched to v5. For more details, please refer to the developer docs for v5, v3, or v1 (web, mobile in-app, offline events).
  • opt_out_type
    for v3/v5 is under custom_data object.
  • opt_out_type
    for v1 is under event_custom_data object.
To pass
st
country
value: refer to the data→ user data section in the developer docs for v5 v3 or v1 (web mobile in-app offline events).
Pinterest Tag - JS Tag (browser pixel)
Enable the LDP flag and pass
st
country
value
  1. Add the below script before all event code. Once set in the page, all page loads will include this.
  2. Leave
    st
    and
    country
    blank or do not include in request payload if you don't have the user's location information.
Note:
st
and
country
values need to be hashed using SHA-256. The below example is for the state of California.
  <script>
    pintrk('set', {
      opt_out_type: 'LDP',
      st: '4b650e5c4785025dee7bd65e3c5c527356717d7a1c0bfef5b4ada8ca1e9cbe17',
      country : '9b202ecbc6d45c6d8901d989a918878397a3eb9d00e8f48022fc051b19d21a1d'
    });
  </script>
To specifically not to process LDP for events, please empty the array or not include the fields at all in payload:
<script>
  pintrk('set', {
    opt_out_type: '',
    st: '',
    country: ''
  });
</script>
Pinterest Tag - Image Tag
Enable the LDP flag and pass
st
country
value
  1. Add
    &pd[opt_out_type]
    ,
    &pd[st]
    ,
    &pd[country]
    in src attribute.
Note:
st
and
country
values need to be hashed using SHA-256. The below example is for the state of California.
  <noscript>
    <img height="1" width="1"
    style="display:none;"
    alt=""
    src="https://ct.pinterest.com/v3/?tid=YOUR_TAG_ID&event=checkout
      &pd[opt_out_type]=LDP
      &pd[st]=4b650e5c4785025dee7bd65e3c5c527356717d7a1c0bfef5b4ada8ca1e9cbe17
      &pd[country]=9b202ecbc6d45c6d8901d989a918878397a3eb9d00e8f48022fc051b19d21a1d
      &ed[value]=10.00
      &ed[order_quantity]=2
      &ed[currency]=USD
      &ed[event_id]=YOUR_EVENT_ID
      &noscript=1"/>
  </noscript>
Upload Conversion with Ads manager
Follow the instructions and guides in our Ads Manager for applying the LDP flag to event data you upload.
API for conversions with third party
  • For managed measurement partners, partners should follow the instructions in the API for conversions section and enable this for you.
  • For unmanaged measurement partners, please follow the instructions in the above Pinterest API for conversions section.
Pinterest tag with third party
  • For non-GTM tag integration, follow the implementation instructions in the above Pinterest Tag, JS Tag, and Image Tag sections.
  • For GTM tag integration, please follow the instructions in the Send in a Limited Data Processing Flag section in Set up the Pinterest tag with Google Tag Manager.
Upload Conversion with third party
For managed measurement partners, Pinterest has asked the partner to enable this for you. Include the information below to implement the LDP flag with St and Country Value.
  • Field : 'opt_out_type'
  • Type: String
  • Value: 'LDP'
  • Required: NO
  • Field :'st'
  • Type: String
  • Value: '4b650e5c4785025dee7bd65e3c5c527356717d7a1c0bfef5b4ada8ca1e9cbe17'
  • Required: NO
  • Field :'country'
  • Type: String
  • Value: '9b202ecbc6d45c6d8901d989a918878397a3eb9d00e8f48022fc051b19d21a1d'
  • Required: NO
Note:
st
and
country
values need to be hashed using SHA-256.
Mobile measurement partner
Pinterest has asked the partner to enable this for you. Please include the information below to implement the LDP flag.
  • Field : 'opt_out_type'
  • Type: String
  • Value: 'LDP'
  • Required: NO Note: MMP integrations already include
    st
    and
    country
    values.
Was this page helpful?