Penggunaan Data Terbatas adalah opsi pemrosesan data yang memberi Anda kontrol lebih atas cara penggunaan data Anda di sistem Meta dan memberikan dukungan yang lebih baik dalam upaya kepatuhan Anda terhadap berbagai peraturan privasi negara bagian AS. Untuk menggunakan fitur ini, Anda harus secara proaktif mengaktifkan Penggunaan Data Terbatas. Saat Meta menerima data dengan Penggunaan Data Terbatas diaktifkan dari orang-orang di negara bagian tempat berlakunya Penggunaan Data Terbatas, kami akan memproses data tersebut sesuai dengan peran kami sebagai penyedia atau pengolah layanan, sebagaimana berlaku, dan membatasi penggunaan data tersebut sebagaimana ditentukan dalam Ketentuan Khusus Negara Bagian kami.
Produk Meta berikut menawarkan tanda Penggunaan Data Terbatas. Ketersediaan berbeda-beda di setiap negara bagian. Lihat bagian di bawah ini untuk detailnya:
California | Colorado | Connecticut | Florida | Texas | Oregon | |
---|---|---|---|---|---|---|
| ✓ | ✓ Berlaku 1 Juni 2023 | ✓ Berlaku 1 Juni 2023 | ✓ Berlaku 24 Juni 2024 | ✓ Berlaku 24 Juni 2024 | ✓ Berlaku 24 Juni 2024 |
✓ | ✓ Berlaku 1 Juni 2023 | ✓ Berlaku 1 Juni 2023 | ✓ Berlaku 24 Juni 2024 | ✓ Berlaku 24 Juni 2024 | ✓ Berlaku 24 Juni 2024 | |
✓ Berlaku 1 Juni 2023 | ❌ | ❌ | ❌ | ❌ | ❌ |
Penggunaan Data Terbatas dikirim melalui parameter yang disebut Opsi Pemrosesan Data, dan secara opsional dapat dikirim bersama negara dan negara bagian pengguna. Jika pengiklan tidak yakin dengan negara atau negara bagian, mereka dapat memilih Meta untuk menentukan apakah peristiwa atau rekaman tersebut berasal dari negara bagian yang berlaku.
Untuk Fitur Bisnis dan Audience Network, Penggunaan Data Terbatas hanya tersedia untuk orang yang tinggal di California, Colorado, Connecticut, Florida, Texas, atau Oregon. Jika bisnis mengaktifkan Penggunaan Data Terbatas tetapi tidak mengatur parameter lokasi ke AS dan California, Colorado, Connecticut, Florida, Texas, atau Oregon, kami akan menentukan apakah peristiwa tersebut berasal dari salah satu negara bagian tersebut. Jika Penggunaan Data Terbatas diaktifkan untuk sebuah peristiwa di California, Colorado, Connecticut, Florida, Texas, atau Oregon, kami akan memproses data sesuai dengan peran kami sebagai penyedia atau pengolah layanan dan membatasi penggunaan data tersebut sesuai dengan Ketentuan Khusus Negara Bagian kami.
Pelaku bisnis mungkin melihat dampak terhadap kinerja dan efektifitas kampanye, serta kemampuan penargetan ulang dan pengukuran akan terbatas ketika Penggunaan Data Terbatas diaktifkan.
Untuk Pemirsa Khusus Daftar Pelanggan, Penggunaan Data Terbatas hanya tersedia bagi orang-orang di California. Jika Penggunaan Data Terbatas diaktifkan untuk sebuah rekaman dalam daftar pelanggan di California, kami akan memproses data sesuai dengan peran kami sebagai penyedia layanan dan membatasi penggunaan data tersebut sesuai dengan Ketentuan Khusus Negara Bagian. Jika bisnis mengaktifkan Penggunaan Data Terbatas tetapi tidak menetapkan parameter lokasi ke AS dan California, kami akan menentukan apakah rekaman tersebut berasal dari California.
Bisnis mungkin melihat dampak terhadap ukuran pemirsa ketika Penggunaan Data Terbatas diaktifkan.
API yang didukung tercantum di bawah ini.
Pelajari selengkapnya tentang Opsi Pemrosesan Data:
Kolom | Deskripsi |
---|---|
Opsi Pemrosesan Data array | Opsi pemrosesan yang ingin Anda aktifkan untuk peristiwa atau rekaman tertentu. Nilai yang diterima saat ini adalah Nama kolom ini dapat disajikan secara berbeda, bergantung pada API dan penerapan yang Anda gunakan. Contoh: ini adalah Array kosong dapat dikirim untuk secara eksplisit menentukan bahwa peristiwa atau rekaman ini sebaiknya tidak diproses dengan batasan Penggunaan Data Terbatas. |
Negara Opsi Pemrosesan Data integer | Opsional untuk sebagian besar API. Baca catatan di bawah untuk detailnya. Negara yang ingin Anda kaitkan dengan opsi pemrosesan data ini. Nilai yang diterima saat ini adalah |
Negara Bagian Opsi Pemrosesan Data integer | Opsional untuk sebagian besar API. Lihat catatan di bawah untuk detailnya. Negara bagian yang ingin Anda kaitkan dengan opsi pemrosesan data ini. Nilai yang diterima saat ini adalah Catatan:
|
Penerapan | Menambahkan Opsi Pemrosesan Data |
---|---|
Pixel Browser | Perbarui kode inisialisasi Pixel untuk menentukan metode Untuk secara eksplisit tidak mengaktifkan Penggunaan Data Terbatas (LDU): fbq('dataProcessingOptions', []); fbq('init', '{pixel_id}'); fbq('track', 'PageView'); Untuk mengaktifkan LDU dan meminta Meta melakukan geolokasi: fbq('dataProcessingOptions', ['LDU'], 0, 0); Untuk mengaktifkan LDU dan menentukan lokasi, misalnya, untuk California: fbq('dataProcessingOptions', ['LDU'], 1, 1000); |
Tanda gambar | Tambahkan hal berikut ke tanda gambar Pixel:
Lihat Referensi untuk nilai yang diterima. Untuk secara eksplisit tidak mengaktifkan LDU, teruskan nilai kosong untuk parameter <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=" /> Untuk mengaktifkan LDU dan meminta Meta melakukan geolokasi: <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&vdpo=LDU&dpoco=0&dpost=0" /> Untuk mengaktifkan LDU dan menentukan lokasi secara manual, contoh, untuk California: <img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=LDU&dpoco=1&dpost=1000" /> |
Untuk kedua API ini, terapkan opsi pemrosesan data dengan menambahkan data_processing_options
, data_processing_options_country
, dan data_processing_options_state
di dalam tiap peristiwa dengan parameter data peristiwa Anda.
Catatan: Peristiwa Aplikasi dan Offline Conversions API tidak lagi direkomendasikan untuk integrasi baru. Sebagai gantinya, Anda direkomendasikan untuk menggunakan Conversions API karena sekarang API ini mendukung web, aplikasi, dan peristiwa offline. Lihat <Conversions API untuk Peristiwa Aplikasi dan <Conversions API untuk Peristiwa Offline untuk informasi selengkapnya.
Untuk secara eksplisit tidak mengaktifkan Penggunaan Data Terbatas (LDU), tentukan array kosong untuk setiap peristiwa atau cukup hapus kolom di payload:
{ "data": [ { "event_name": "Purchase", "event_time": <EVENT_TIME>, "user_data": { "em": "<EMAIL>" }, "custom_data": { "currency": "<CURRENCY>", "value": "<VALUE>" }, "data_processing_options": [] } ] }
Untuk mengaktifkan LDU dan meminta Meta melakukan geolokasi:
{ "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 } ] }
Untuk mengaktifkan LDU dan menentukan lokasi secara manual, contoh, untuk California:
{ "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 } ] }
Offline Conversions API menawarkan opsi untuk secara manual mengunggah peristiwa dari file .csv
. Dalam hal ini, tambahkan Opsi Pemrosesan Data, Negara Pemrosesan Data, dan Negara Bagian Pemrosesan Data sebagai kolom dalam file. Informasi selengkapnya tentang ini dapat ditemukan di antarmuka pengguna unggah.
To implement Data Processing Options using the Graph API, add data_processing_options
, data_processing_options_country
, and data_processing_options_state
to your API call.
To explicitly not enable LDU, send an empty data_processing_options
array:
{ "event": "CUSTOM_APP_EVENTS", "application_tracking_enabled": "1", "advertiser_tracking_enabled": "1", "custom_events": ["fb_mobile_purchase"], "data_processing_options": [] }
To enable LDU and have Meta perform geolocation, you can send an event with the following code:
{ "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 }
To enable LDU and manually specify the location, e.g., for California, you can send an event with the following code:
{ "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 }
We recommend using our latest versions to ensure the functionality of Data Processing Options. The below implementation instructions are accurate for the following SDK versions:
Please update if you are using any versions below the ones listed above.
As of July 1, 2023, we are ending the Transition Period for older versions of App Events via the Facebook SDK, whereby we applied Limited Data Use to all personal information shared about people in California. The ability to enable default Limited Data Use will no longer be available for any versions below iOS Facebook SDK v7.1.1, Android Facebook SDK v7.1.0 and Unity SDK v7.21.0. If you choose to use Limited Data Use for a person in California, Colorado, Connecticut, Florida, Texas, or Oregon on or after July 1, 2023, you must update your SDK and implement Data Processing Options as set forth in this document.
Implementation | Adding Data Processing Options |
---|---|
Facebook SDK for iOS v7.1.1+ (Objective-C) | With Objective-C, use To explicitly not enable Limited Data Use (LDU), use: [FBSDKSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, e.g., for California, use: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
Facebook SDK for iOS v7.1.1+ (Swift) | With Swift, use To explicitly not enable LDU, use: Settings.setDataProcessingOptions(modes: []) To enable LDU and have Meta perform geolocation, use: Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0) To enable LDU and manually specify the location, e.g., for California, use: Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000) |
Facebook SDK for Android v7.1.0+ | Use the To explicitly not enable LDU, use: FacebookSdk.setDataProcessingOptions(new String[] {}); To enable LDU and have Meta perform geolocation, use: FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, e.g., for California, use: FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); |
Unity SDK v7.21.1+ | To explicitly not enable LDU, send an event with: FB.Mobile.SetDataProcessingOptions(new string[] {}); To enable LDU and have Meta perform geolocation, send an event with: FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, e.g., for California, send an event with: FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000); |
We recommend using our latest Audience Network SDK versions to ensure the functionality of Data Processing Options. The below implementation instructions are accurate for Audience Network SDK versions 5.10 and above.
As of July 1, 2023, we are ending the Transition Period for older versions of Audience Network SDK, whereby we limited the data for all personal information that businesses share about people in California and the ability to enable default Limited Data Use will not be available for Audience Network SDK versions below 5.10. If you choose to use Limited Data Use to indicate a person in California, Colorado, Connecticut, Florida, Texas, or Oregon or on or after July 1, 2023, you must update your SDK and implement Data Processing Options as set forth in this document.
Implementation | Adding Data Processing Options |
---|---|
Facebook SDK for iOS, v5.10+ | Use To explicitly not enable Limited Data Use (LDU), use: [FBAdSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
Facebook SDK for Android, v5.10+ | Use the To explicitly not enable Limited Data Use (LDU), use: AdSettings.setDataProcessingOptions(new String[] {}) To enable LDU and have Meta perform geolocation, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); |
Unity SDK, v5.10+ (not using the Audience Network-supplied Unity wrapper) | If you are not using the Audience Network-supplied Unity wrapper, enter the following code. 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 } } After entering this code, you can follow the Unity SDK instructions in the row below as if you are using the Unity wrapper. |
Unity SDK, v5.10+ (using the Audience Network-supplied Unity wrapper) | If you are using the Audience Network-supplied Unity wrapper, use the following To explicitly not enable LDU, use: AdSettings.SetDataProcessingOptions(new string[]{}) To enable LDU and have Meta perform geolocation, use:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000); |
Publishers using a Mediation Partner must set the Data Processing Options (Limited Data Use) on the Meta Audience Network SDK before initializing the Mediation SDK so that it is received by us in the bidding request.
Implementation | Adding Data Processing Options |
---|---|
Android | To explicitly not enable LDU for the event, use: AdSettings.setDataProcessingOptions(new String[] {}) To enable LDU and have Meta perform geolocation, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); After setting LDU, initialize the Mediation Partner SDK as per usual. |
iOS | To explicitly not enable Limited Data Use (LDU), use: FBAdSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; After setting the LDU for the event, initialize the Mediation Partner SDK as per usual. |
For publishers that are working with us through Bidding Kit and other Server-side Bidding, please follow the implementation methods below.
Implementation | Adding Data Processing Options |
---|---|
Android/Bidding Kit 2.0 | To explicitly not enable LDU, use: AdSettings.setDataProcessingOptions(new String[] {}) To enable LDU and have Meta perform geolocation, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); After setting the LDU for the event, generate the bidder token: String token = BidderTokenProvider.getBidderToken(Context); |
iOS/Bidding Kit 2.0 | To explicitly not enable Limited Data Use (LDU), use: [FBAdSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; After setting the LDU for the event, generate the bidder token: NSString *token = [FBAdSettings bidderToken]; |
Other Server-Side Bidding | For each platform follow the instructions below to specify LDU for the event and retrieve the bidder token before making the server-side bid request. For Android client: To explicitly not enable LDU, use: AdSettings.setDataProcessingOptions(new String[] {}) To enable LDU and have Meta perform geolocation, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); After setting the LDU for the event, generate the bidder token: String token = BidderTokenProvider.getBidderToken(Context); For iOS client: To explicitly not enable Limited Data Use (LDU), use: [FBAdSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; After setting the LDU for the event, generate the bidder token: NSString *token = [FBAdSettings bidderToken]; |
Jika Anda ingin mengaktifkan Penggunaan Data Terbatas bagi orang-orang di California melalui pemirsa khusus daftar pelanggan pada atau setelah 1 Juni 2023, Anda harus mengunggah pemirsa baru atau memperbarui pemirsa yang ada dengan tanda Penggunaan Data Terbatas. Secara rutin perbarui dan pertahankan pemirsa Anda dan status Penggunaan Data Terbatas orang-orang sesuai kebutuhan.
Harap diperhatikan bahwa tanda Penggunaan Data Terbatas diterapkan pada seorang pengguna dalam satu pemirsa tidak akan secara otomatis dibawa ke pemirsa yang berbeda. Dengan cara yang sama, pengiklan harus mengelola masing-masing daftar pelanggan yang ada secara terpisah berdasarkan kriteria yang mereka pilih, tanda Penggunaan Data Terbatas harus diterapkan secara terpisah untuk setiap pemirsa yang mereka manfaatkan untuk iklan mereka.
Untuk secara eksplisit TIDAK mengaktifkan LDU
untuk rekaman, Anda dapat mengirim array data_processing_options
kosong atau menghapus kolom di payload. Contoh array kosong:
{ "payload": { "schema": [ "EMAIL", "DATA_PROCESSING_OPTIONS" ], "data": [ [ "<HASHED_DATA> ", [] ] ] } }
Untuk secara eksplisit mengaktifkan LDU
, dan minta Meta melakukan geolokasi (dengan tidak menyertakan negara bagian dan negara dari rekaman yang diberikan), tentukan array yang berisi LDU
untuk setiap rekaman:
{ "payload": { "schema": [ "EMAIL", "DATA_PROCESSING_OPTIONS" ], "data": [ [ "<HASHED_DATA> ", ["LDU"] ] ] } }
Untuk mengaktifkan LDU dan menentukan lokasi secara manual:
{ "customer_consent": true, "payload": { "schema": [ "EMAIL", "DATA_PROCESSING_OPTIONS", "DATA_PROCESSING_OPTIONS_COUNTRY", "DATA_PROCESSING_OPTIONS_STATE" ], "data": [ [ "<HASHED_DATA>", ["LDU"], 1, 1000 ] ] } }