/ /

Sending the IAB US National Privacy String (USNAT) with Osano Cookie Consent

Updated 6 minutes ago

If your organization has signed the IAB Multi-State Privacy Agreement (MSPA), Osano can send the IAB US National Privacy string, known as USNAT, to your advertising partners. The string tells partners whether you gave each US visitor notice and whether that visitor opted out of the sale or sharing of their personal information and of targeted advertising.

You turn USNAT on from the IAB tab of a Cookie Consent configuration. It needs no code changes and nothing new on your banner. Osano builds the string from settings you already have and from the choices your visitors already make.

USNAT is for MSPA signatories and certified partners only. If your organization has not signed the MSPA, do not enable it. Your configuration keeps sending the US Privacy String (USPv1) as it does today.

Before you start

  • You are an MSPA signatory or certified partner. Check with your privacy or legal team if you are not sure.
  • You have your MSPA ID. This is the numeric identifier IAB assigned when your organization registered. You can find it in the IAB MSPA identification list. It is a whole number with no letters.
  • Your plan includes IAB / GPP. USNAT is included wherever the IAB Global Privacy Platform is included.
  • Do Not Sell / Share is set up. USNAT notice and opt-out values come from your Do Not Sell / Share configuration and your Marketing consent category. While USNAT is on, Do Not Sell / Share must be on in every US state.
  • Your configuration has been saved at least once. USNAT cannot be enabled on a new, unsaved configuration.
  • You can edit and publish the configuration.

USNAT is currently only available for websites. The Osano mobile SDKs do not send it yet but it is planned for early 2027 release.

What Osano sends, and where the values come from

When USNAT is on, Osano adds the US National section (section 7) to the IAB Global Privacy Platform (GPP) string for visitors in the United States. Visitors outside the US do not receive it.

You do not edit the values in the string. Osano sets them from two things: your answer to one question on the IAB tab, and each visitor's choices.

The question: Does your organization sell or share personal information, or process it for targeted advertising?

You answer Yes (default)You answer No
What it meansYour site visitors are shown a Do Not Sell / Share notice and can opt out. Osano signals that notice and each visitor's choice to your ad partners.Osano signals that no opt-out notice is required for your organization. Your ad partners must then treat the data they receive from you as service providers under the MSPA.
NoticeSignalled as givenSignalled as not applicable
Opt-out, visitor has not opted outSignalled as "did not opt out"Signalled as not applicable
Opt-out, visitor has opted outSignalled as "opted out"Signalled as not applicable

A visitor counts as opted out when any one of these is true:

  • They opted out through your Do Not Sell / Share control.
  • They declined the Marketing category.
  • Their browser sent a Global Privacy Control (GPC) signal, and GPC support is on for the configuration.

Any one of these opts the visitor out of sale, sharing, and targeted advertising together. If the visitor later accepts again, the string returns to "did not opt out".

What Osano does not signal. Osano does not signal consent for sensitive data, consumers under 18, or secondary-use consent in this string; those fields are sent as "Not applicable" in v2, and are removed in v3 of the USNAT string.

Turn on USNAT

  1. In Osano, open Cookie Consent and select the configuration you want to change.
  2. Go to the IAB tab.
  3. Turn on IAB Global Privacy Platform (GPP) if it is not already on. The IAB US National Privacy (USNAT) card appears once GPP is on.
  4. Turn on IAB US National Privacy (USNAT). A dialog opens and asks you to review four points before enabling:
    • Confirm with your privacy and legal teams that your organization is an MSPA signatory or certified partner.
    • Confirm your Do Not Sell / Share configuration is correct, because USNAT notice and opt-out values are derived from it and from your Marketing consent category.
    • Understand that sensitive data, consumers under 18, and secondary-use consent are sent as "Not applicable" (see above).
    • Understand that while USNAT is enabled, Do Not Sell / Share must be on in every US state, and the per-state Do Not Sell / Share settings are locked.
  5. Select the attestation checkbox. Osano records the attestation with your user and the date.
  6. Enter your MSPA ID. The Enable button stays unavailable until the attestation is selected and an MSPA ID is entered.
  7. Click Enable.
  8. On the USNAT card, answer the sell or share question. Yes is selected by default.
  9. Save Changes, then Publish. USNAT is live for US visitors once the publish completes.

After you enable USNAT, the card shows who attested and when. The MSPA ID is read-only on the card; click Edit to change it, which reopens the dialog.

What changes for Do Not Sell / Share

A valid USNAT string depends on every US visitor having been shown your notice. Before you enable USNAT, make sure Do Not Sell/Share is turned on for your configuration. It must remain on for as long as USNAT is enabled.

USNAT and the US Privacy String (USPv1)

The US Privacy String (USPv1) is the older IAB signal. It is on by default and has its own card on the IAB tab.

  • With both on, Osano sends both. The sale opt-out value in USPv1 always matches the USNAT opt-out, so partners reading either string see the same choice.
  • You can turn USPv1 off. We recommend keeping it on until your ad partners confirm they read USNAT. When USPv1 is off, Osano stops sending the US Privacy String and removes it from the GPP string.
  • The US Privacy String notice confirmation now lives on the IAB tab under the USPv1 card. It was previously in Advanced Settings.

Check that the string is being sent

USNAT is only sent to visitors in the United States, so test from a US location.

  1. Publish the configuration and open your site.
  2. Open your browser's developer console and run:
__gpp('ping', console.log)
  1. In the result, copy the value of gppString.
  2. Paste it into the IAB GPP decoder at iabgpp.com and look for section 7 (usnat) in parsedSections.

Make a choice on the banner (for example, opt out through Do Not Sell / Share), run the command again, and confirm the opt-out values changed.

Turn off USNAT

Turn the IAB US National Privacy (USNAT) toggle off, save, and publish. Osano removes section 7 from the GPP string. Your other IAB settings are not affected. Do Not Sell/Share settings are not changed.

Osano and the MSPA

Turning on USNAT enables Osano to send signals on your behalf.

  • Osano acts as your consent management platform, and is not itself an MSPA signatory. The MSPA recognizes that a signal may be set by "a consent management platform acting on the First Party's behalf" (MSPA Appendix I, ยง1.69). Osano sets the signals from your configuration; you are responsible for their accuracy.
  • Sensitive data and personal data of consumers under 18. These are outside the MSPA's scope and are not signaled for consent by Osano.
  • Your MSPA ID. Keep it accurate. Osano may check the ID you enter against the IAB identification list. Using an invalid or incorrect MSPA ID will make your GPP strings invalid.

The move to USNAT v3.0

The USNAT card shows the version of the IAB specification your string uses. Today that is USNAT v2.0, which is compliant through January 31, 2027.

The MSPA Technical Signaling Implementation Guidelines require USNAT v3.0 by February 1, 2027. Osano will switch your string to v3.0 in January 2027, before the deadline, and will notify you before the change. The MSPA ID you enter when you enable USNAT is what v3.0 requires, so you do not need to reconfigure anything.

For details, see About the USNAT v3.0 transition.


Things to know

  • USNAT is per configuration. Each configuration is enabled, attested, and given an MSPA ID separately.
  • Nothing changes unless you turn it on. Configurations that never enable USNAT send exactly what they send today.
  • GPP and EU TCF are now separate settings. You can turn on GPP and USNAT without turning on IAB EU TCF, so a US-only site does not get the TCF consent drawer. If you had the previous combined IAB setting on, both GPP and TCF are on for you and behave as before.
  • Your IAB settings are all on the IAB tab. Advanced Settings now shows a link to it. The Global Privacy Control support setting remains in Advanced Settings.
  • Your visitors see no new controls. Their existing Do Not Sell / Share choice, Marketing choice, and GPC signal set the opt-out.
  • State-specific GPP sections are not supported. Osano sends the US National section, which is the MSPA approach. It does not send separate GPP sections for individual states.
  • Enabling USNAT is recorded. The attestation appears on the card and in your activity log.

Frequently asked questions

We have not signed the MSPA. Can we use USNAT? No. The US National string is only for MSPA signatories and certified partners. Your configuration may keep sending the US Privacy String as it does today.

Where do I find my MSPA ID? In the IAB MSPA identification list. The enable dialog links to it.

Do I need to change my banner or add anything to my site? No. Osano builds the string from your existing Do Not Sell / Share and Marketing category settings and end user interaction with them.

Will this change what I send to ad partners today? Only if you enable it. When you do, the US National string is added alongside your existing US Privacy String, and the opt-out value in both always matches.

Why can't I enable USNAT on my new configuration? Save the configuration first. USNAT can be enabled once the configuration has been saved.

Does a Global Privacy Control signal count as an opt-out? Yes, when GPC support is on for the configuration. A GPC signal opts the visitor out of sale, sharing, and targeted advertising in the string, and declines the Marketing category.

Does USNAT cover sensitive data or consent for minors? No. The string reports those as "Not applicable".

Should I turn off the US Privacy String once USNAT is on? Not straight away. Keep it on until your ad partners confirm they read USNAT.

Does USNAT work in our mobile app? Not yet. USNAT is currently available for websites.

I can't see the GPP or USNAT settings. If the GPP card shows "Not in your plan", your plan does not include IAB / GPP. Contact your Osano representative. The US Privacy String settings remain available on every plan.


Related articles

Was this article helpful?
Subscribe to receive updates on this article