API การตลาด

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

"การใช้ข้อมูลแบบจำกัด" เป็นตัวเลือกการประมวลผลข้อมูลที่ช่วยให้คุณสามารถควบคุมการใช้งานข้อมูลของคุณในระบบของ 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 เหตุการณ์ในแอพ

หากคุณกำลังเรียก API เหตุการณ์ในแอพและไม่ได้ส่งข้อมูลจากอุปกรณ์ของผู้ใช้โดยตรง คุณต้องส่งที่อยู่ IP ของไคลเอ็นต์โดยใช้ส่วนหัว X-Forwarded-For HTTP หรือระบุตำแหน่งทางภูมิศาสตร์อย่างชัดแจ้ง อย่างใดอย่างหนึ่ง

API กราฟ

เพื่อนำตัวเลือกการประมวลผลข้อมูลไปใช้งานโดยใช้ API กราฟ ให้เพิ่ม data_processing_options, data_processing_options_country และ data_processing_options_state ในการเรียก API ของคุณ หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ส่งอาร์เรย์ data_processing_options ที่ว่างเปล่า: 
{
  "event": "CUSTOM_APP_EVENTS",
  "application_tracking_enabled": "1",
  "advertiser_tracking_enabled": "1",
  "custom_events": ["fb_mobile_purchase"],
  "data_processing_options": []
}
หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ คุณสามารถส่งเหตุการณ์ด้วยโค้ดต่อไปนี้: 
{
  "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
}
หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ คุณสามารถส่งเหตุการณ์ด้วยโค้ดต่อไปนี้: 
  {
  "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 บนมือถือ

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

iOS SDK (Objective C)

หากใช้ Objective C ให้ใช้ FBSDKSettings setDataProcessingOptions


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

[FBSDKSettings setDataProcessingOptions:@[]];

หากต้องการเปิดใช้งาน LDU ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

[FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

[FBSDKSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

iOS SDK (Swift)

หากใช้ Swift ให้ใช้ setDataProcessingOptions


หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

Settings.setDataProcessingOptions(modes: [])

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

Settings.setDataProcessingOptions(modes: ["LDU"], country: 0, state: 0)

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

Settings.setDataProcessingOptions(modes: ["LDU"], country: 1, state: 1000)

Android SDK

ใช้เมธอด setDataProcessingOptions


หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

FacebookSdk.setDataProcessingOptions(new String[] {});

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่ระบุตำแหน่งทางภูมิศาสตร์ ให้ใช้:

FacebookSdk.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

Unity SDK

หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ส่งเหตุการณ์ด้วย:

FB.Mobile.SetDataProcessingOptions(new string[] {});

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ส่งเหตุการณ์ด้วย:

FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ส่งเหตุการณ์ด้วย:

FB.Mobile.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

Audience Network SDK

ผู้เผยแพร่ที่อัพเกรดเป็น Audience Network SDK เวอร์ชั่น 5.10 หรือใหม่กว่าต้องกำหนดการรายงานปัญหาการใช้งานข้อมูลโดยจำกัดเพื่อให้ Facebook ใช้ข้อจำกัดเกี่ยวกับข้อมูลส่วนตัวที่พวกเขาแชร์เกี่ยวกับผู้คนในแคลิฟอร์เนีย

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

iOS SDK เวอร์ชั่น 5.10 ขึ้นไป

ใช้ FBAdSettings setDataProcessingOptions


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

[FBAdSettings setDataProcessingOptions:@[]];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

Android SDK เวอร์ชั่น 5.10 ขึ้นไป

ใช้เมธอด setDataProcessingOptions


หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

AdSettings.setDataProcessingOptions(new String[] {})

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

Unity SDK เวอร์ชั่น 5.10 ขึ้นไป (ไม่ใช้ Unity Wrapper ที่ให้มากับ Audience Network)

หากคุณไม่ใช้ Unity Wrapper ที่ให้มากับ Audience Network ให้ป้อนโค้ดต่อไปนี้


            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
            }
            }

เมื่อป้อนโค้ดนี้แล้ว คุณสามารถทำตามคำแนะนำของ Unity SDK ในแถวด้านล่างนี้ได้เหมือนกับว่าคุณกำลังใช้ Unity Wrapper อยู่

Unity SDK เวอร์ชั่น 5.10 ขึ้นไป (ใช้ Unity Wrapper ที่ให้มากับ Audience Network)

หากคุณใช้ Unity Wrapper ที่ให้มากับ Audience Network ให้ใช้โค้ด SetDataProcessingOptions


หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

AdSettings.SetDataProcessingOptions(new string[]{})

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 1, 1000);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0);

ผู้เผยแพร่ที่ใช้พาร์ทเนอร์สื่อกลางต้องตั้งค่าการรายงานปัญหาตัวเลือกการประมวลผลข้อมูล (การใช้ข้อมูลโดยจำกัด) บน Facebook Audience Network SDK ก่อนเริ่มใช้ SDK สื่อกลางเพื่อให้เรารับ SDK ได้ในคำขอการประมูล

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

Android

หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

AdSettings.setDataProcessingOptions(new String[] {})

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

หลังจากตั้งค่าการรายงานปัญหา LDU แล้ว ให้เริ่มใช้งาน SDK พาร์ทเนอร์สื่อกลางตามปกติ

iOS

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

FBAdSettings setDataProcessingOptions:@[]];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

หลังจากตั้งค่าการรายงานปัญหา LDU แล้ว ให้เริ่มใช้งาน SDK พาร์ทเนอร์สื่อกลางตามปกติ

สำหรับผู้เผยแพร่ที่ทำงานร่วมกับเราผ่านทางชุดการประมูลและการประมูลฝั่งเซิร์ฟเวอร์อื่นๆ โปรดทำตามวิธีการนำไปใช้งานด้านล่างนี้

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

Android/ชุดการประมูล 2.0

หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

AdSettings.setDataProcessingOptions(new String[] {})

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

หลังจากตั้งค่าการรายงานปัญหา LDU แล้ว ให้สร้างโทเค็นผู้ประมูล:

String token = BidderTokenProvider.getBidderToken(Context);

iOS/ชุดการประมูล 2.0

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

[FBAdSettings setDataProcessingOptions:@[]];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

หลังจากตั้งค่าการรายงานปัญหา LDU แล้ว ให้สร้างโทเค็นผู้ประมูล:

NSString *token = [FBAdSettings bidderToken];

การประมูลฝั่งเซิร์ฟเวอร์อื่นๆ

สำหรับแต่ละแพลตฟอร์ม ให้ทำตามคำแนะนำด้านล่างเพื่อตั้งค่าการรายงานปัญหา LDU และเรียกดูโทเค็นผู้ประมูลก่อนที่จะสร้างคำขอประมูลฝั่งเซิร์ฟเวอร์


สำหรับไคลเอ็นต์ Android:

หากต้องการไม่เปิดใช้งานโหมด LDU อย่างชัดแจ้ง ให้ใช้:

AdSettings.setDataProcessingOptions(new String[] {})

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 1, 1000);

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0);

หลังจากตั้งค่าการรายงานปัญหา LDU แล้ว ให้สร้างโทเค็นผู้ประมูล:

String token = BidderTokenProvider.getBidderToken(Context);

สำหรับไคลเอ็นต์ iOS:

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

[FBAdSettings setDataProcessingOptions:@[]];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้และระบุตำแหน่งทางภูมิศาสตร์ของผู้ใช้ ให้ใช้:

  • ประเทศ:1 เพื่อระบุว่าเป็นสหรัฐฯ
  • รัฐ:1000 เพื่อระบุว่าเป็นแคลิฟอร์เนีย
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000];

หากต้องการเปิดใช้งาน LDU สำหรับผู้ใช้ที่มีตำแหน่งทางภูมิศาสตร์ ให้ใช้:

  • ประเทศ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
  • รัฐ:0 เพื่อขอให้เรากำหนดตำแหน่งทางภูมิศาสตร์ของเหตุการณ์นั้น
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0];

หลังจากตั้งค่าการรายงานปัญหา LDU แล้ว ให้สร้างโทเค็นผู้ประมูล:

NSString *token = [FBAdSettings bidderToken];

สำหรับ SDK ของ AN เวอร์ชั่นต่ำกว่า 5.10 ธุรกิจสามารถแทนที่การใช้งานอัตโนมัติของช่วงจำกัดการใช้ข้อมูลผ่านการตั้งค่าในตัวจัดการการสร้างรายได้ โปรดทราบว่าการแทนที่การตั้งค่านี้จะมีผลต่อเมื่อคำขอที่เกี่ยวข้องกับผู้คนในแคลิฟอร์เนียไม่มีการรายงานปัญหา "การใช้งานข้อมูลโดยจำกัด" (เช่น คำขอใดๆ ที่มาจาก SDK ของ AN เวอร์ชั่นต่ำกว่า 5.10)

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

หากคุณต้องการเปิดใช้งาน "การใช้ข้อมูลแบบจำกัด" สำหรับผู้คนที่อยู่ในรัฐแคลิฟอร์เนียผ่านกลุ่มเป้าหมายที่กำหนดเองจากรายชื่อลูกค้าตั้งแต่วันที่ 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
            ]
        ]
    }
}