Opsi Pemrosesan Data bagi Pengguna di AS
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 yang menawarkan Penggunaan Data Terbatas
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 SDK
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
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:
Referensi
| 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:
|
Fitur dan API yang Didukung
Meta Pixel
| 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" /> |
Conversions API dan Offline Conversions API
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
}
]
}UI Unggahan Manual
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.
App Events API
HTTP X-Forwarded-For, atau secara eksplisit menentukan geografinya.
Graph API
Untuk menerapkan Opsi Pemrosesan Data menggunakan Graph API, tambahkandata_processing_options, data_processing_options_country, dan data_processing_options_state ke panggilan API. Untuk secara eksplisit tidak mengaktifkan mode LDU, kirim deret data_processing_options: {
"event": "CUSTOM_APP_EVENTS",
"application_tracking_enabled": "1",
"advertiser_tracking_enabled": "1",
"custom_events": ["fb_mobile_purchase"],
"data_processing_options": []
} Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, Anda dapat mengirim peristiwa dengan kode berikut: {
"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
} Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, Anda dapat mengirim peristiwa dengan kode berikut: {
"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
} SDK Seluler
| Implementasi | Menambahkan Opsi Pemrosesan Data |
|---|---|
SDK iOS (Objective C) | Dengan Objective C, gunakan Untuk secara eksplisit tidak mengaktifkan mode Penggunaan Data Terbatas (LDU), gunakan: [FBSDKSettings setDataProcessingOptions:@[]]; Untuk mengaktifkan LDU dengan geolokasi, gunakan: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan: [FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
SDK iOS (Swift) | Dengan Swift, gunakan Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: Settings.setDataProcessingOptions(modes: []) Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan: Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0) Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan: Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000) |
Android SDK | Gunakan metode Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: FacebookSdk.setDataProcessingOptions(new String[] {}); Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan: FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); Untuk mengaktifkan LDU bagi pengguna dengan geografi yang ditentukan, gunakan: FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000); |
Unity SDK | Untuk secara eksplisit tidak mengaktifkan mode LDU, kirim peristiwa dengan: FB.Mobile.SetDataProcessingOptions(new string[] {});Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, kirim peristiwa dengan: FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, kirim peristiwa dengan: FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000); |
Audience Network SDK
Penerbit yang melakukan peningkatan ke Audience Network SDK versi 5.10 atau yang lebih tinggi harus mengatur bendera Penggunaan Data Terbatas agar Facebook terus menerapkan batasan terhadap informasi pribadi yang mereka bagikan tentang orang-orang di California.
| Penerapan | Menambahkan Opsi Pemrosesan Data |
|---|---|
iOS SDK, v5.10+ | Gunakan Untuk secara eksplisit tidak mengaktifkan mode Penggunaan Data Terbatas (LDU), gunakan: [FBAdSettings setDataProcessingOptions:@[]]; Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; |
Android SDK, v5.10+ | Gunakan metode Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: AdSettings.setDataProcessingOptions(new String[] {}) Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); |
Unity SDK, v5.10+ (tidak menggunakan pembungkus Unity yang disediakan Audience Network) | Jika Anda tidak menggunakan pembungkus Unity yang disediakan Audience Network, masukkan kode berikut.
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
}
}
Setelah memasukkan kode ini, Anda dapat mengikuti petunjuk Unity SDK di baris di bawah ini seolah-olah Anda menggunakan pembungkus Unity. |
Unity SDK, v5.10+ (menggunakan pembungkus Unity yang disediakan Audience Network) | Jika Anda menggunakan pembungkus Unity yang disediakan Audience Network, gunakan Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: AdSettings.SetDataProcessingOptions(new string[]{})Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); |
Penerbit yang menggunakan Partner Mediasi harus mengatur bendera Opsi Pemrosesan Data (Penggunaan Data Terbatas) pada Facebook Audience Network SDK sebelum menginisialisasi SDK Mediasi agar SDK diterima oleh kami dalam permintaan penawaran.
| Penerapan | Menambahkan Opsi Pemrosesan Data |
|---|---|
Android | Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: AdSettings.setDataProcessingOptions(new String[] {}) Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);Setelah mengatur bendera LDU, inisialisasi SDK partner mediasi seperti biasa. |
iOS | Untuk secara eksplisit tidak mengaktifkan mode Penggunaan Data Terbatas (LDU), gunakan: FBAdSettings setDataProcessingOptions:@[]]; Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Setelah mengatur bendera LDU, inisialisasi SDK partner mediasi seperti biasa. |
Untuk penerbit yang bekerja dengan kami melalui Bidding Kit dan Tawaran Sisi Server lainnya, harap ikuti metode penerapan di bawah.
| Penerapan | Menambahkan Opsi Pemrosesan Data |
|---|---|
Android/Bidding Kit 2.0 | Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: AdSettings.setDataProcessingOptions(new String[] {})Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);Setelah mengatur bendera LDU, buat token penawar: String token = BidderTokenProvider.getBidderToken(Context); |
iOS/Bidding Kit 2.0 | Untuk secara eksplisit tidak mengaktifkan mode Penggunaan Data Terbatas (LDU), gunakan: [FBAdSettings setDataProcessingOptions:@[]]; Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Setelah mengatur bendera LDU, buat token penawar: NSString *token = [FBAdSettings bidderToken]; |
Tawaran Sisi Server Lainnya | Untuk setiap platform, ikuti instruksi di bawah untuk mengatur bendera LDU dan mengambil token penawar sebelum membuat permintaan penawaran sisi server. Untuk klien Android: Untuk secara eksplisit tidak mengaktifkan mode LDU, gunakan: AdSettings.setDataProcessingOptions(new String[] {}) Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);Setelah mengatur bendera LDU, buat token penawar: String token = BidderTokenProvider.getBidderToken(Context); Untuk klien iOS: Untuk secara eksplisit tidak mengaktifkan mode Penggunaan Data Terbatas (LDU), gunakan: [FBAdSettings setDataProcessingOptions:@[]]; Untuk mengaktifkan LDU bagi pengguna dan menentukan geografi pengguna, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; Untuk mengaktifkan LDU bagi pengguna dengan geolokasi, gunakan:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; Setelah mengatur bendera LDU, buat token penawar: NSString *token = [FBAdSettings bidderToken]; |
Untuk Audience Network SDK di bawah versi 5.10, bisnis dapat mengabaikan penerapan otomatis periode pembatasan Penggunaan Data Terbatas melalui pengaturan di Pengelola Monetisasi. Harap diingat, pengaturan pengabaian ini hanya akan berlaku saat permintaan terkait dengan seseorang di California tidak memiliki bendera "Penggunaan data terbatas" (yaitu, permintaan yang berasal dari versi Audience Network SDK di bawah 5.10).
Pemirsa Khusus Daftar Pelanggan
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
]
]
}
}