Opções de processamento de dados para usuários nos EUA
O Uso Limitado de Dados permite maior controle sobre como seus dados são usados nos sistemas da Meta e oferece melhor suporte para garantir a conformidade com vários regulamentos de privacidade estaduais nos EUA. Para usar esse recurso, você precisa habilitar o Uso Limitado de Dados. Quando receber dados com Uso Limitado de Dados habilitado de pessoas nos estados onde o recurso está disponível, a Meta fará o processamento de acordo com nossa função de provedor ou operador do serviço, conforme aplicável, e limitará o uso dessas informações com base nos Termos específicos do estado.
Produtos da Meta que oferecem o Uso Limitado de Dados
Os produtos da Meta a seguir oferecem o Uso Limitado de Dados. A disponibilidade varia de acordo com o estado. Consulte a tabela abaixo para ver os detalhes:
| Califórnia | Colorado | Connecticut | Flórida | Texas | Oregon | |
|---|---|---|---|---|---|---|
Ferramentas da Meta para Empresas
| ✓ | ✓ Em vigor desde 1º de junho de 2023 | ✓ Em vigor desde 1º de junho de 2023 | ✓ Em vigor a partir de 24 de junho de 2024 | ✓ Em vigor a partir de 24 de junho de 2024 | ✓ Em vigor a partir de 24 de junho de 2024 |
✓ | ✓ Em vigor desde 1º de junho de 2023 | ✓ Em vigor desde 1º de junho de 2023 | ✓ Em vigor a partir de 24 de junho de 2024 | ✓ Em vigor a partir de 24 de junho de 2024 | ✓ Em vigor a partir de 24 de junho de 2024 | |
✓ Em vigor desde 1º de junho de 2023 | ❌ | ❌ | ❌ | ❌ | ❌ |
O Uso Limitado de Dados é enviado por meio de um parâmetro chamado Opções de processamento de dados. Ele também pode ser enviado com o país e o estado do usuário. Se um anunciante não tiver certeza do país ou estado, ele poderá solicitar que a Meta determine se o evento ou registro é proveniente de uma localização aceita.
Para Ferramentas para Empresas e SDK do Audience Network
No caso das Ferramentas para Empresas e do Audience Network, o Uso Limitado de dados está disponível apenas para pessoas na Califórnia, no Colorado, em Connecticut, na Flórida, no Texas ou em Oregon. Se uma empresa habilitar o Uso Limitado de Dados, mas não definir os parâmetros de localização como EUA e Califórnia, Colorado, Connecticut, Flórida, Texas ou Oregon, a Meta determinará se o evento é proveniente de um desses estados. Caso o Uso Limitado de Dados esteja habilitado para um evento na Califórnia, no Colorado, em Connecticut, na Flórida, no Texas ou em Oregon, faremos o processamento de acordo com nossa função de provedor ou operador do serviço e limitaremos o uso dessas informações com base nos Termos específicos do estado.
As empresas talvez notem um impacto no desempenho e na eficácia da campanha, e os recursos de redirecionamento e mensuração ficarão restritos quando o Uso Limitado de Dados estiver habilitado.
Para públicos personalizados de lista de clientes
No caso de públicos personalizados de lista de clientes, o Uso Limitado de Dados está disponível apenas para pessoas na Califórnia. Se o Uso Limitado de Dados estiver habilitado para registro em uma lista de clientes da Califórnia, faremos o processamento de acordo com nossa função de provedor de serviços e limitaremos o uso dessas informações com base nos Termos específicos do estado. Se uma empresa habilitar o Uso Limitado de Dados, mas não definir os parâmetros de localização como EUA e Califórnia, a Meta determinará se o registro é proveniente desse estado.
As empresas talvez notem um impacto no tamanho do público quando o Uso Limitado de Dados estiver habilitado.
Veja as APIs compatíveis listadas abaixo.
Saiba mais sobre as opções de processamento de dados:
Referência
| Campo | Descrição |
|---|---|
Opções de processamento de dados matriz | As opções de processamento que você quer habilitar para um evento ou registro específico. O valor aceito atualmente é Dependendo da API e da implementação sendo usada, o nome desse campo pode ser diferente. Por exemplo, Uma matriz vazia pode ser enviada para especificar de modo explícito que esse evento ou registro não deve ser processado com as restrições de Uso Limitado de Dados. |
País para opções de processamento de dados número inteiro | Opcional para a maioria das APIs. Veja mais detalhes nas observações a seguir. Um país que você quer associar a essa opção de processamento de dados. No momento, os valores aceitos são |
Estado para opções de processamento de dados número inteiro | Opcional para a maioria das APIs. Veja mais detalhes nas observações a seguir. Um estado que você deseja associar a essa opção de processamento de dados. No momento, os valores aceitos são Nota:
|
Ferramentas e APIs compatíveis
Pixel da Meta
| Implementação | Inclusão das opções de processamento de dados |
|---|---|
Pixel do navegador | Atualize o código de inicialização do Pixel para especificar o método Para não habilitar o Uso Limitado de Dados de modo explícito:
fbq('dataProcessingOptions', []);
fbq('init', '{pixel_id}');
fbq('track', 'PageView');
Para habilitar o Uso Limitado de Dados e fazer com que a Meta realize a geolocalização:
fbq('dataProcessingOptions', ['LDU'], 0, 0);
Para habilitar o Uso Limitado de Dados e especificar a localização, por exemplo, para a Califórnia:
fbq('dataProcessingOptions', ['LDU'], 1, 1000);
|
Tag de imagem | Adicione o seguinte à tag de imagem do pixel:
Consulte Referência para conferir os valores aceitos. Para não habilitar o Uso Limitado de Dados de modo explícito, transmita um valor vazio para o parâmetro <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=" />Para habilitar o Uso Limitado de Dados e fazer com que a Meta realize a geolocalização: <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&vdpo=LDU&dpoco=0&dpost=0" />Para habilitar o Uso Limitado de Dados e especificar manualmente a localização (por exemplo, para a Califórnia): <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=LDU&dpoco=1&dpost=1000" /> |
API de Conversões e API de Conversões Offline
Para estas duas APIs, implemente opções de processamento de dados adicionando data_processing_options, data_processing_options_country e data_processing_options_state a cada evento no parâmetro de dados dos seus eventos.
Observação: as APIs de Eventos do App e Conversões Offline não são mais recomendadas para novas integrações. Em vez dessas opções, use a API de Conversões, que agora é compatível com eventos da web, de apps e offline. Consulte Conversions API for App Events e Conversions API for Offline Events para saber mais.
Para não habilitar o Uso Limitado de Dados de modo explícito, especifique uma matriz vazia para cada evento ou simplesmente remova o campo na carga:
{
"data": [
{
"event_name": "Purchase",
"event_time": <EVENT_TIME>,
"user_data": {
"em": "<EMAIL>"
},
"custom_data": {
"currency": "<CURRENCY>",
"value": "<VALUE>"
},
"data_processing_options": []
}
]
}Para habilitar o Uso Limitado de Dados e fazer com que a Meta realize a geolocalização:
{
"data": [
{
"event_name": "Purchase",
"event_time": <EVENT_TIME>,
"user_data": {
"em": "<EMAIL>",
"client_ip_address": "256.256.256.256"
},
"custom_data": {
"currency": "<CURRENCY>",
"value": "<VALUE>"
},
"data_processing_options": ["LDU"],
"data_processing_options_country": 0,
"data_processing_options_state": 0
}
]
}Para habilitar o Uso Limitado de Dados e especificar manualmente a localização (por exemplo, para a Califórnia):
{
"data": [
{
"event_name": "Purchase",
"event_time": <EVENT_TIME>,
"user_data": {
"em": "<EMAIL>"
},
"custom_data": {
"currency": "<CURRENCY>",
"value": "<VALUE>"
},
"data_processing_options": ["LDU"],
"data_processing_options_country": 1,
"data_processing_options_state": 1000
}
]
}Interface do usuário para carregamento manual
A API de Conversões Offline oferece a opção de carregar manualmente seus eventos a partir de um arquivo .csv. Nesse caso, adicione "Opções de processamento de dados", "País para processamento de dados" e "Estado para processamento de dados" como colunas dentro do seu arquivo. Para saber mais, consulte a interface do usuário para carregamento.
API de Eventos do App
HTTP ou explicitamente especificar a geografia.
Graph API
Para implementar as Opções de Processamento de Dados usando a Graph API, adicionedata_processing_options, data_processing_options_country e data_processing_options_state à sua chamada de API. Para explicitamente habilitar o modo LDU, envie uma matriz data_processing_options vazia: {
"event": "CUSTOM_APP_EVENTS",
"application_tracking_enabled": "1",
"advertiser_tracking_enabled": "1",
"custom_events": ["fb_mobile_purchase"],
"data_processing_options": []
} Para habilitar o LDU para os usuários com geolocalização, você pode enviar um evento com o seguinte código: {
"event": "CUSTOM_APP_EVENTS",
"application_tracking_enabled": "1",
"advertiser_tracking_enabled": "1",
"custom_events": ["fb_mobile_purchase"],
"data_processing_options": ["LDU"],
"data_processing_options_country": 0,
"data_processing_options_state": 0
} Para habilitar o LDU para os usuários e especificar a geografia do usuário, você pode enviar um evento com o seguinte código: {
"event": "CUSTOM_APP_EVENTS",
"application_tracking_enabled": "1",
"advertiser_tracking_enabled": "1",
"custom_events": ["fb_mobile_purchase"],
"data_processing_options": ["LDU"],
"data_processing_options_country": 1,
"data_processing_options_state": 1000
} SDKs móveis
| Implementação | Adicionar opções de processamento de dados |
|---|---|
SDK para iOS (Objective C) | Com Objective C, use Para explicitamente não habilitar o modo de Uso Limitado de dados (LDU), use: [FBSDKSettings setDataProcessingOptions:@[]]; Para habilitar o LDU com geolocalização, use: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Para habilitar o LDU para os usuários e especificar a geografia do usuário, use: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
SDK para iOS (Swift) | Com Swift, use Para explicitamente não habilitar o modo LDU, use: Settings.setDataProcessingOptions(modes: []) Para habilitar o LDU para os usuários com geolocalização, use: Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0) Para habilitar o LDU para os usuários e especificar a geografia do usuário, use: Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000) |
SDK do Android | Use o método Para explicitamente não habilitar o modo LDU, use: FacebookSdk.setDataProcessingOptions(new String[] {}); Para habilitar o LDU para os usuários com geolocalização, use: FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); Para habilitar o LDU para os usuários com uma geografia específica, use: FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); |
SDK do Unity | Para explicitamente não habilitar o modo LDU, envie um evento com: FB.Mobile.SetDataProcessingOptions(new string[] {});Para habilitar o LDU para os usuários com geolocalização, envie um evento com: FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); Para habilitar o LDU para os usuários e especificar a geografia do usuário, envie um evento com: FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000); |
SDK do Audience Network
Os gerenciadores de anúncios que atualizaram o SDK do Audience Network para a versão 5.10 ou superior precisam configurar a sinalização de Uso Limitado de Dados para que o Facebook continue aplicando restrições às informações pessoais que publicam sobre pessoas na Califórnia.
| Implementação | Adicionar opções de processamento de dados |
|---|---|
SDK para iOS, v5.10+ | Use Para explicitamente não ativar o modo LDU (Uso Limitado de Dados), use: [FBAdSettings setDataProcessingOptions:@[]]; Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Para ativar o LDU para os usuários com geolocalização, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; |
Android SDK, v5.10+ | Use o método Para explicitamente não ativar o modo LDU, use: AdSettings.setDataProcessingOptions(new String[] {}) Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Para ativar o LDU para os usuários com geolocalização, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); |
Unity SDK, v5.10+ (sem usar o wrapper para Unity fornecido pelo Audience Network) | Se você não estiver usando o wrapper para Unity fornecido pelo Audience Network, insira este código.
using UnityEngine;
using System.Runtime.InteropServices;
namespace AudienceNetwork
{
public static class AdSettings
{
public static void SetDataProcessingOptions(string[] dataProcessingOptions)
{
#if UNITY_ANDROID
AndroidJavaClass adSettings = new AndroidJavaClass("com.facebook.ads.AdSettings");
adSettings.CallStatic("setDataProcessingOptions", (object)dataProcessingOptions);
#endif
#if UNITY_IOS
FBAdSettingsBridgeSetDataProcessingOptions(dataProcessingOptions, dataProcessingOptions.Length);
#endif
}
public static void SetDataProcessingOptions(string[] dataProcessingOptions, int country, int state)
{
#if UNITY_ANDROID
AndroidJavaClass adSettings = new AndroidJavaClass("com.facebook.ads.AdSettings");
adSettings.CallStatic("setDataProcessingOptions", (object)dataProcessingOptions, country, state);
#endif
#if UNITY_IOS
FBAdSettingsBridgeSetDetailedDataProcessingOptions(dataProcessingOptions, dataProcessingOptions.Length, country, state);
#endif
}
#if UNITY_IOS
[DllImport("__Internal")]
private static extern void FBAdSettingsBridgeSetDataProcessingOptions(string[] dataProcessingOptions, int length);
[DllImport("__Internal")]
private static extern void FBAdSettingsBridgeSetDetailedDataProcessingOptions(string[] dataProcessingOptions, int length, int country, int state);
#endif
}
}
Depois de inserir o código, é possível seguir as instruções do SDK do Unity na linha abaixo como se estivesse usando o wrapper para Unity. |
Unity SDK, v5.10+ (usando o wrapper para Unity fornecido pelo Audience Network) | Se você estiver usando o wrapper para Unity fornecido pelo Audience Network, utilize estas Para explicitamente não ativar o modo LDU, use: AdSettings.SetDataProcessingOptions(new string[]{})Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);Para ativar o LDU para os usuários com geolocalização, use:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); |
Os publishers que usam um parceiro de mediação precisam configurar a sinalização de opções de processamento de dados (Uso Limitado de Dados) no SDK do Audience Network do Facebook antes de inicializar o SDK de Mediação, para que seja recebido na solicitação de lance.
| Implementação | Adicionar opções de processamento de dados |
|---|---|
Android | Para explicitamente não ativar o modo LDU, use: AdSettings.setDataProcessingOptions(new String[] {}) Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Para ativar o LDU para os usuários com geolocalização, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);Após configurar a sinalização de LDU, inicie o SDK do parceiro de mediação, como de costume. |
iOS | Para explicitamente não ativar o modo LDU (Uso Limitado de Dados), use: FBAdSettings setDataProcessingOptions:@[]]; Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Para ativar o LDU para os usuários com geolocalização, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Após configurar a sinalização de LDU, inicie o SDK do parceiro de mediação, como de costume. |
Se você for um gerenciador de anúncios que trabalha conosco por kit de lances ou outros lances do lado do servidor, siga os métodos de implementação abaixo.
| Implementação | Adicionar opções de processamento de dados |
|---|---|
Kit 2.0 para Android/lances | Para explicitamente não ativar o modo LDU, use: AdSettings.setDataProcessingOptions(new String[] {})Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Para ativar o LDU para os usuários com geolocalização, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);Após configurar a sinalização de LDU, gere o token do licitante: String token = BidderTokenProvider.getBidderToken(Context); |
Kit 2.0 para iOS/lances | Para explicitamente não ativar o modo LDU (Uso Limitado de Dados), use: [FBAdSettings setDataProcessingOptions:@[]]; Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Para ativar o LDU para os usuários com geolocalização, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Após configurar a sinalização de LDU, gere o token do licitante: NSString *token = [FBAdSettings bidderToken]; |
Outros lances do lado do servidor | Para cada plataforma, siga as instruções abaixo se quiser configurar a sinalização de LDU e recuperar o token do licitante antes de fazer uma solicitação de lance do lado do servidor. Para o cliente Android: Para explicitamente não ativar o modo LDU, use: AdSettings.setDataProcessingOptions(new String[] {}) Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Para ativar o LDU para os usuários com geolocalização, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);Após configurar a sinalização de LDU, gere o token do licitante: String token = BidderTokenProvider.getBidderToken(Context); Para o cliente iOS: Para explicitamente não ativar o modo LDU (Uso Limitado de Dados), use: [FBAdSettings setDataProcessingOptions:@[]]; Para ativar o LDU para os usuários e especificar a geografia do usuário, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Para ativar o LDU para os usuários com geolocalização, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Após configurar a sinalização de LDU, gere o token do licitante: NSString *token = [FBAdSettings bidderToken]; |
Para uma versão de SDK inferior à 5.10, as empresas podem substituir a aplicação automática do período de restrições do Uso Limitado de Dados por meio de uma configuração no Gerenciador de Monetização. A configuração para substituição é aplicável somente quando uma solicitação relacionada a uma pessoa na Califórnia não foi sinalizada como Uso Limitado de Dados (por exemplo, solicitações de um SDK de versão inferior à 5.10).
Públicos personalizados a partir de um arquivo de cliente
Se você quiser habilitar o Uso Limitado de Dados para pessoas na Califórnia por meio de públicos personalizados de lista de clientes a partir de 1º de junho de 2023, carregue novos públicos ou atualize os existentes com a sinalização de Uso Limitado de Dados. Atualize e mantenha os status de Uso Limitado de Dados dos seus públicos e das pessoas, conforme necessário.
Uma sinalização de Uso Limitado de Dados aplicada a um usuário em um público não será transferida automaticamente para públicos diferentes. Da mesma forma que os anunciantes devem gerenciar cada um dos públicos personalizados de lista de clientes separadamente pelos critérios selecionados, a sinalização de Uso Limitado de Dados precisa ser aplicada de modo específico a cada público usado para publicidade.
Para NÃO habilitar o LDU de forma explícita para o registro, você pode enviar uma matriz de data_processing_options vazia ou remover o campo na carga. Exemplo de uma matriz vazia:
{
"payload": {
"schema": [
"EMAIL",
"DATA_PROCESSING_OPTIONS"
],
"data": [
[
"<HASHED_DATA>
",
[]
]
]
}
}
Para habilitar o LDU de forma explícita e fazer com que a Meta realize a geolocalização (ao não incluir o estado nem o país do registro), especifique uma matriz contendo LDU para cada registro:
{
"payload": {
"schema": [
"EMAIL",
"DATA_PROCESSING_OPTIONS"
],
"data": [
[
"<HASHED_DATA>
",
["LDU"]
]
]
}
}
Para habilitar o Uso Limitado de Dados e especificar manualmente a localização:
{
"customer_consent": true,
"payload": {
"schema": [
"EMAIL",
"DATA_PROCESSING_OPTIONS",
"DATA_PROCESSING_OPTIONS_COUNTRY",
"DATA_PROCESSING_OPTIONS_STATE"
],
"data": [
[
"<HASHED_DATA>",
["LDU"],
1,
1000
]
]
}
}