เอกสารนี้นี้ได้รับการอัพเดตแล้ว
คำแปลเป็น ภาษาไทย ยังไม่เสร็จสมบูรณ์
ภาษาอังกฤษที่อัพเดต: 14 พ.ค.

ตัวเลือกการประมวลผลข้อมูลสำหรับผู้ใช้ในสหรัฐฯ

"การใช้ข้อมูลแบบจำกัด" เป็นตัวเลือกการประมวลผลข้อมูลที่ช่วยให้คุณสามารถควบคุมการใช้งานข้อมูลของคุณในระบบของ Meta ได้มากยิ่งขึ้น และช่วยสนับสนุนให้คุณปฏิบัติตามข้อกำหนดด้านความเป็นส่วนตัวของรัฐต่างๆ ในสหรัฐฯ ได้ดียิ่งขึ้น โดยคุณต้องเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" ด้วยตนเองเพื่อใช้งานฟีเจอร์ดังกล่าว เมื่อ Meta ได้รับข้อมูลที่เปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" จากผู้คนที่อยู่ในรัฐที่มีการใช้ "การใช้ข้อมูลแบบจำกัด" เราจะประมวลผลข้อมูลนั้นตามบทบาทของเราในฐานะผู้ให้บริการหรือผู้ประมวลผลตามความเหมาะสม และจำกัดการใช้ข้อมูลนั้นตามที่ระบุไว้ในข้อกำหนดเฉพาะของรัฐของเรา

ผลิตภัณฑ์ในเครือ Meta ที่เปิดให้ใช้ "การใช้ข้อมูลแบบจำกัด"

ผลิตภัณฑ์ในเครือ Meta ต่อไปนี้เปิดให้ใช้ "การใช้ข้อมูลแบบจำกัด" โดยความพร้อมให้ใช้งานจะแตกต่างกันไปตามแต่ละรัฐ ดูรายละเอียดได้ที่ตารางด้านล่าง

แคลิฟอร์เนียโคโลราโดคอนเนตทิคัตฟลอริดาเท็กซัสออริกอน

เครื่องมือ Meta Business

  • พิกเซลของ Meta
  • เหตุการณ์ในแอพผ่าน Facebook SDK
  • API เหตุการณ์ในแอพ
  • API คอนเวอร์ชั่น
  • API คอนเวอร์ชั่นแบบออฟไลน์

มีผลตั้งแต่วันที่ 1 มิถุนายน 2023


มีผลตั้งแต่วันที่ 1 มิถุนายน 2023


มีผลตั้งแต่วันที่ 24 มิถุนายน 2024


มีผลตั้งแต่วันที่ 24 มิถุนายน 2024


มีผลตั้งแต่วันที่ 24 มิถุนายน 2024

Audience Network SDK


มีผลตั้งแต่วันที่ 1 มิถุนายน 2023


มีผลตั้งแต่วันที่ 1 มิถุนายน 2023


มีผลตั้งแต่วันที่ 24 มิถุนายน 2024


มีผลตั้งแต่วันที่ 24 มิถุนายน 2024


มีผลตั้งแต่วันที่ 24 มิถุนายน 2024

กลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้า


มีผลตั้งแต่วันที่ 1 มิถุนายน 2023

"การใช้ข้อมูลแบบจำกัด" จะถูกส่งผ่านอาร์เรย์ที่เรียกว่าตัวเลือกการประมวลผลข้อมูล ซึ่งอาจส่งไปพร้อมกับประเทศและรัฐของผู้ใช้หรือไม่ก็ได้ หากผู้ลงโฆษณาไม่แน่ใจว่าผู้ใช้อยู่ในประเทศหรือรัฐ���ด ผู้ลงโฆษณาสามารถเลือกให้ Meta พิจารณาว่าเหตุการณ์หรือรายการข้อมูลนั้นมาจากรัฐที่บังคับใช้หรือไม่

สำหรับเครื่องมือธุรกิจและ Audience Network SDK

สำหรับเครื่องมือธุรกิจและ Audience Network "การใช้ข้อมูลแบบจำกัด" จะใช้ได้เฉพาะกับผู้คนที่อยู่ในรัฐแคลิฟอร์เนีย โคโลราโด คอนเนตทิคัต ฟลอริดา เท็กซัส หรือออริกอนเท่านั้น หากธุรกิจเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" แต่ไม่ได้ตั้งค่าพารามิเตอร์ตำแหน่งที่ตั้งเป็นสหรัฐฯ และรัฐแคลิฟอร์เนีย โคโลราโด คอนเนตทิคัต ฟลอริดา เท็กซัส หรือออริกอน เราจะพิจารณาว่าเหตุการณ์นั้นมาจากรัฐใดรัฐหนึ่งเหล่านี้หรือไม่ หากมีการเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" สำหรับเหตุการณ์ในรัฐแคลิฟอร์เนีย โคโลราโด คอนเนตทิคัต ฟลอริดา เท็กซัส หรือออริกอน เราจะประมวลผลข้อมูลตามบทบาทของเราในฐานะผู้ให้บริการหรือผู้ประมวลผล และจำกัดการใช้ข้อมูลนั้นตามข้อกำหนดเฉพาะรัฐของเรา

ทั้งนี้ ธุรกิจอาจสังเกตเห็นผลกระทบต่อประสิทธิภาพและประสิทธิผลของแคมเปญ อีกทั้งขีดความสามารถในการกำหนดเป้าหมายซ้ำและการวัดผลจะถูกจำกัดเมื่อเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด"

สำหรับกลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้า

สำหรับกลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้า "การใช้ข้อมูลแบบจำกัด" จะใช้ได้เฉพาะกับผู้คนที่อยู่ในรัฐแคลิฟอร์เนียเท่านั้น หากมีการเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" สำหรับรายการข้อมูลในรายชื่อลูกค้าจากรัฐแคลิฟอร์เนีย เราจะประมวลผลข้อมูลตามบทบาทของเราในฐานะผู้ให้บริการและจำกัดการใช้ข้อมูลนั้นตามข้อกำหนดเฉพาะรัฐของเรา หากธุรกิจเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" แต่ไม่ได้ตั้งค่าพารามิเตอร์ตำแหน่งที่ตั้งเป็นสหรัฐฯ และรัฐแคลิฟอร์เนีย เราจะพิจารณาว่ารายการข้อมูลนั้นมาจากรัฐแคลิฟอร์เนียหรือไม่

ทั้งนี้ ธุรกิจอาจสังเกตเห็นผลกระทบต่อขนาดกลุ่มเป้าหมายเมื่อเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด"

API ที่รองรับมีอยู่ในรายการด้านล่าง

เรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกการประมวลผลข้อมูลดังนี้

ข้อมูลอ้างอิง

ช่องคำอธิบาย

ตัวเลือกการประมวลผลข้อมูล

อาร์เรย์

ตัวเลือกการประมวลผลที่คุณต้องการเปิดใช้งานสำหรับเหตุการณ์หรือรายการข้อมูลอย่างใดอย่างหนึ่ง ค่าที่ยอมรับในปัจจุบันคือ LDU ซึ่งหมายถึง "การใช้ข้อมูลแบบจำกัด"


ชื่อของช่องนี้อาจแสดงแตกต่างกันไปโดยขึ้นอยู่กับ API และการนำไปใช้งานที่คุณกำลังใช้ ตัวอย่างเช่น ชื่อจะเป็น dataProcessingOptions สำหรับการเรียกใช้ JavaScript พิกเซลของ Meta แต่จะเป็น data_processing_options สำหรับการเรียกใช้ API คอนเวอร์ชั่น โปรดดูตัวอย่างการเรียกใช้ด้านล่าง


ทั้งนี้ คุณสามารถส่งอาร์เรย์เปล่าเพื่อระบุอย่างชัดแจ้งว่าไม่ควรประมวลผลเหตุการณ์หรือรายการข้อมูลด้วยข้อจำกัด "การใช้ข้อมูลแบบจำกัด"

ประเทศของตัวเลือกการประมวลผลข้อมูล

จำนวนเต็ม

ระบุหรือไม่ก็ได้สำหรับ API ส่วนใหญ่ โปรดดูรายละเอียดที่หมายเหตุด้านล่าง


ประเทศที่คุณต้องการเชื่อมโยงกับตัวเลือกการประมวลผลข้อมูลนี้ ค่าที่ยอมรับในปัจจุบัน ได้แก่ 1 ซึ่งหมายถึงสหรัฐอเมริกา หรือ 0 เพื่อส่งคำขอให้ Meta กำหนดตำแหน่งทางภูมิศาสตร์

รัฐของตัวเลือกการประมวลผลข้อมูล

จำนวนเต็ม

ระบุหรือไม่ก็ได้สำหรับ API ส่วนใหญ่ โปรดดูรายละเอียดที่หมายเหตุด้านล่าง


รัฐที่คุณต้องการเชื่อมโยงกับตัวเลือกการประมวลผลข้อมูลนี้ ค่าที่ยอมรับในปัจจุบัน ได้แก่ 1000 ซึ่งหมายถึงรัฐแคลิฟอร์เนีย, 1001 ซึ่งหมายถึงรัฐโคโลราโด, 1002 ซึ่งหมายถึงรัฐคอนเนตทิคัต, 1003 ซึ่งหมายถึงรัฐฟลอริดา, 1004 ซึ่งหมายถึงรัฐออริกอน, 1005 ซึ่งหมายถึงรัฐเท็กซัส หรือ 0 เพื่อส่งคำขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์


หมายเหตุ:

  • หากคุณกำหนดประเทศ คุณจะต้องกำหนดรัฐด้วย มิฉะนั้น เราจะทำการกำหนดตำแหน่งทางภูมิศาสตร์

เครื่องมือและ API ที่รองรับ

พิกเซลของ Meta

การนำไปใช้การเพิ่มตัวเลือกการประมวลผลข้อมูล

พิกเซลของเบราว์เ��อร์

อัพเดตโค้ดการเริ่มต้นทำงานของพิกเซลเพื่อระบุเมธอด dataProcessingOptions ก่อนที่คุณจะเรียกใช้ fbq('init')


หากต้องการไม่เปิดใช้งานการใช้ข้อมูลแบบจำกัด (LDU) อย่างชัดแจ้ง ให้ใช้โค้ดต่อไปนี้

fbq('dataProcessingOptions', []);
fbq('init', '{pixel_id}');
fbq('track', 'PageView');

หากต้องการเปิดใช้งาน LDU และให้ Meta ทำการระบุตำแหน่งทางภูมิศาสตร์ ให้ใช้โค้ดต่อไปนี้

fbq('dataProcessingOptions', ['LDU'], 0, 0);

หากต้องการเปิดใช้งาน LDU และระบุตำแหน่งที่ตั้ง เช่น สำหรับรัฐแคลิฟอร์เนีย ให้ใช้โค้ดต่อไปนี้

fbq('dataProcessingOptions', ['LDU'], 1, 1000);

แท็กรูปภาพ

เพิ่มค่าต่อไปนี้ให้กับแท็กรูปภาพของพิกเซล

  • dpo: ตัวเลือกการประมวลผลข้อมูล
  • dpoco: ประเทศของตัวเลือกการประมวลผลข้อมูล
  • dpost: รัฐของตัวเลือกการประมวลผลข้อมูล

ดูค่าที่ยอมรับได้ที่ข้อมูลอ้างอิง


หากต้องการไม่เปิดใช้งาน LDU อย่างชัดแจ้ง ให้ส่งค่าว่างสำหรับพารามิเตอร์ dpo

<img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=" />

หากต้องการเปิดใช้งาน LDU และให้ Meta ทำการระบุตำแหน่งทางภูมิศาสตร์ ให้ใช้โค้ดต่อไปนี้

<img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&vdpo=LDU&dpoco=0&dpost=0" />

หากต้องการเปิดใช้งาน LDU และระบุตำแหน่งที่ตั้งด้วยตนเอง เช่น สำหรับรัฐแคลิฟอร์เนีย ให้ใช้โค้ดต่อไปนี้

<img src="https://www.facebook.com/tr?id={pixel_id}&ev=Purchase&dpo=LDU&dpoco=1&dpost=1000" />

API คอนเวอร์ชั่นและ API คอนเวอร์ชั่นแบบออฟไลน์

สำหรับ API ทั้งสองนี้ ให้ใช้ตัวเลือกการประมวลผลข้อมูลด้วยการเพิ่ม data_processing_options, data_processing_options_country และ data_processing_options_state ในแต่ละเหตุการณ์ภายในพารามิเตอร์ข้อมูลของเหตุการณ์ของคุณ

หมายเหตุ: เราไม่แนะนำให้ใช้เหตุการณ์ในแอพและ API คอนเวอร์ชั่นแบบออฟไลน์สำหรับการผสานการทำงานใหม่ๆ อีกต่อไป แต่เราขอแนะนำให้คุณใช้ API คอนเวอร์ชั่นเนื่องจากขณะนี้รองรับเว็บ แอพ และเหตุการณ์ออฟไลน์ ดูข้อมูลเพิ่มเติมได้ที่ API คอนเวอร์ชั่นสำหรับเหตุการณ์ในแอพและ API คอนเวอร์ชั่นสำหรับเหตุการณ์แบบออฟไลน์

หากต้องการไม่เปิดใช้งานการใช้ข้อมูลแบบจำกัด (LDU) อย่างชัดแจ้ง ให้ระบุอาร์เรย์ว่างสำหรับแต่ละเหตุการณ์หรือเพียงแค่ลบช่องในเพย์โหลดออก:

{
    "data": [
        {
            "event_name": "Purchase",
            "event_time": <EVENT_TIME>,
            "user_data": {
                "em": "<EMAIL>"
            },
            "custom_data": {
                "currency": "<CURRENCY>",
                "value": "<VALUE>"
            },
            "data_processing_options": []
        }
    ]
}

หากต้องการเปิดใช้งาน LDU และให้ Meta ทำการระบุตำแหน่งทางภูมิศาสตร์ ให้ใช้โค้ดต่อไปนี้

{
    "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
        }
    ]
}

หากต้องการเปิดใช้งาน LDU และระบุตำแหน่งที่ตั้งด้วยตนเอง เช่น สำหรับรัฐแคลิฟอร์เนีย ให้ใช้โค้ดต่อไปนี้

{
    "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 การอัพโหลดด้วยตนเอง

API คอนเวอร์ชั่นแบบออฟไลน์มีตัวเลือกให้อัพโหลดเหตุการณ์ของคุณด้วยตนเองจากไฟล์ .csv ในกรณีนี้ ให้เพิ่มตัวเลือกการประมวลผลข้อมูล ประเทศที่ประมวลผลข้อมูล และรัฐที่ประมวลผลข้อมูลเป็นคอลัมน์ในไฟล์ของคุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับเรื่องนี้ได้ในอินเทอร์เฟซผู้ใช้ของการอัพโหลด

API เหตุการณ์ในแอพ

Graph API

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
}  

Mobile SDKs

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:

  • iOS Facebook SDK v7.1.1 or higher
  • Android Facebook SDK v7.1.0 or higher
  • Unity SDK v7.21.0 or higher

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.

ImplementationAdding Data Processing Options

Facebook SDK for iOS v7.1.1+ (Objective-C)

With Objective-C, use FBSDKSettings setDataProcessingOptions.


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 setDataProcessingOptions.


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 setDataProcessingOptions method.


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);  

Audience Network SDK

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.

ImplementationAdding Data Processing Options

Facebook SDK for iOS, v5.10+

Use FBAdSettings setDataProcessingOptions.


To explicitly not enable Limited Data Use (LDU), use:

[FBAdSettings setDataProcessingOptions:@[]];

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

Facebook SDK for Android, v5.10+

Use the setDataProcessingOptions method.


To explicitly not enable Limited Data Use (LDU), use:

AdSettings.setDataProcessingOptions(new String[] {}) 

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
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 SetDataProcessingOptions.


To explicitly not enable LDU, use:

AdSettings.SetDataProcessingOptions(new string[]{})

To enable LDU and have Meta perform geolocation, use:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
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.

ImplementationAdding 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:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
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:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[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.

ImplementationAdding 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:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
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:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[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:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
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:

  • Country: 0 to request that we determine the location
  • State: 0 to request that we determine the location
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

To enable LDU and manually specify the location, use:

  • Country: 1 to indicate USA
  • State: 1000 to indicate California, 1001 for Colorado, 1002 for Connecticut, 1003 for Florida, 1004 for Oregon, 1005 for Texas
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

After setting the LDU for the event, generate the bidder token:

NSString *token = [FBAdSettings bidderToken];

กลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้า

หากคุณต้องการเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" สำหรับผู้คนที่อยู่ในรัฐแคลิฟอร์เนียผ่านกลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้าตั้งแต่วันที่ 1 มิถุนายน 2023 เป็นต้นไป คุณจะต้องอัพโหลดกลุ่มเป้าหมายใหม่หรืออัพเดตกลุ่มเป้าหมายที่มีอยู่ของคุณให้มีแฟล็ก "การใช้ข้อมูลแบบจำกัด" โดยคุณสามารถอัพเดตและรักษาสถานะ "การใช้ข้อมูลแบบจำกัด" ของกลุ่มเป้าหมายและผู้คนได้อย่างสม่ำเสมอตามที่ต้องการ

โปรดทราบว่าแฟล็ก "การใช้ข้อมูลแบบจำกัด" ที่ใช้กับผู้ใช้ในกลุ่มเป้าหมายหนึ่งจะไม่มีผลกับกลุ่มเป้าหมายอื่นๆ โดยอัตโนมัติ ในทำนองเดียวกัน ผู้ลงโฆษณาต้องจัดการกลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้าแต่ละกลุ่มที่มีอยู่แบบแยกกันตามเกณฑ์ที่ตนเลือก โดยจะต้องใช้แฟล็ก "การใช้ข้อมูลแบบจำกัด" แบบแยกกันกับกลุ่มเป้าหมายแต่ละกลุ่มที่ตนใช้ในการโฆษณา

หากต้องการไม่เปิดใช้งาน LDU อย่างชัดแจ้งสำหรับรายการข้อมูล คุณสามารถส่งอาร์เรย์ data_processing_options ว่างหรือลบช่องในเพย์โหลดออก ตัวอย่างอาร์เรย์ว่าง:

{
   "payload": {
       "schema": [
           "EMAIL",
                    "DATA_PROCESSING_OPTIONS"
       ],
       "data": [
           [
               "<HASHED_DATA>
",
                           []
           ]
       ]
   }
}

หากต้องการไม่เปิดใช้งาน LDU อย่างชัดแจ้งและให้ Meta ทำการระบุตำแหน่งทางภูมิศาสตร์ (โดยไม่รวมรัฐและประเทศของรายการข้อมูลนั้นๆ) ให้ระบุอาร์เรย์ที่มี LDU สำหรับรายการข้อมูลแต่ละรายการ:

{
   "payload": {
       "schema": [
           "EMAIL",
                    "DATA_PROCESSING_OPTIONS"
       ],
       "data": [
           [
               "<HASHED_DATA>
",
                           ["LDU"]
           ]
       ]
   }
}

หากต้องการเปิดใช้งาน LDU และระบุตำแหน่งที่ตั้งด้วยตนเอง

{
    "customer_consent": true,
    "payload": {
        "schema": [
            "EMAIL",
            "DATA_PROCESSING_OPTIONS",
            "DATA_PROCESSING_OPTIONS_COUNTRY",
            "DATA_PROCESSING_OPTIONS_STATE"
        ],
        "data": [
            [
                "<HASHED_DATA>",
                ["LDU"],
                1,
                1000
            ]
        ]
    }
}