‏API التسويق‏

خيارات معالجة البيانات لمستخدمي الولايات المتحدة

الاستخدام المحدود للبيانات هو خيار معالجة بيانات يمنحك المزيد من التحكم في استخدام بياناتك ضمن أنظمة Meta ويدعمك بشكل أفضل في جهودك للالتزام بمختلف لوائح الخصوصية في الولايات المتحدة. للاستفادة من هذه الميزة، يجب تمكين الاستخدام المحدود للبيانات بشكل استباقي. عندما تتلقى Meta بيانات تم تمكين الاستخدام المحدود للبيانات بها من جانب الأشخاص في الولايات حيث يتم تطبيق الاستخدام المحدود للبيانات، سنعمل على معالجة تلك البيانات وفقًا لدورنا كموفر أو معالج خدمات، حسب الاقتضاء، وسنقيد استخدام تلك البيانات كما هو موضح في الشروط الخاصة بالولاية.

منتجات Meta التي توفر الاستخدام المحدود للبيانات

توفر منتجات Meta التالية الاستخدام المحدود للبيانات. يختلف التوفر حسب الولاية. راجع الجدول أدناه للتفاصيل:

كاليفورنياكولورادوكونيتيكتفلوريداتكساسأوريغون

أدوات Meta للأعمال

  • بيكسل 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 المدعومة مدرجة أدناه.

تعرف على المزيد حول خيارات معالجة البيانات:

المرجع

الحقلالوصف

خيارات معالجة البيانات

array (مصفوفة)

خيارات المعالجة التي تريد تمكينها في حدث أو سجل محدد. علمًا بأن القيمة الحالية المقبولة هي LDU فيما يتعلق بالاستخدام المحدود للبيانات.


يمكن عرض اسم هذا الحقل بشكل مختلف حسب API والتنفيذ الذي تستخدمه. على سبيل المثال، يكون ذلك dataProcessingOptions في استدعاء JavaScript لبيكسل Meta، في حين يكون data_processing_options في استدعاء واجهة API التحويلات. يُرجى الاطلاع على مثال الاستدعاءات أدناه.


يمكن إرسال مصفوفة فارغة لتحديد أنه لا يجب معالجة هذا الحدث أو السجل بوضوح مع فرض تقييدات الاستخدام المحدود للبيانات.

خيارات معالجة البيانات في بلد معين

integer (عدد صحيح)

اختياري لمعظم واجهات API. للحصول على التفاصيل، اطلع على الملاحظة أدناه.


البلد الذي تريد ربطه بخيار معالجة البيانات هذا. علمًا بأن القيم الحالية المقبولة هي 1 للولايات المتحدة الأمريكية، أو 0 لطلب من Meta تحديد الموقع الجغرافي.

خيارات معالجة البيانات في ولاية معينة

integer (عدد صحيح)

اختياري لمعظم واجهات 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
        }
    ]
}

تحميل واجهة المستخدم يدويًا

تقدم واجهة API التحويلات بلا اتصال خيار تحميل الأحداث يدويًا من ملف بتنسيق .csv. في هذه الحالة، أضف خيارات معالجة البيانات وبلد معالجة البيانات وولاية معالجة البيانات كأعمدة داخل الملف لديك. كما يمكن العثور على المزيد من المعلومات حول هذا الأمر في دليل تحميل واجهة مستخدم.

واجهة API أحداث التطبيق

إذا كنت تستدعي واجهة API أحداث التطبيق ولا ترسل البيانات مباشرة من أجهزة المستخدم، فيجب إرسال عنوان IP للعميل باستخدام العنوان HTTP X-Forwarded-For، أو تحديد المنطقة الجغرافية بوضوح.

واجهة Graph API

لتنفيذ خيارات معالجة البيانات باستخدام واجهة Graph 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);

مجموعة SDK لمنصة Unity

لتعطيل وضع 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

يجب على الناشرين الذين يحاولون الترقية إلى الإصدار 5.10 من مجموعة Audience Network SDK أو الإصدارات الأحدث تعيين علامة الاستخدام المحدود للبيانات بحيث يتمكّن 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);

مجموعة SDK لمنصة Unity بالإصدار 5.10 والإصدارات الأحدث (لا تستخدم أداة التضمين Unity المتوفرة من Audience Network)

إذا لم تكن تستخدم أداة التضمين Unity المتوفرة من 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
            }
            }

بعد إدخال هذا الرمز البرمجي، يمكنك متابعة تعليمات مجموعة SDK لمنصة Unity في الصف أدناه وكأنك تستخدم أداة التضمين Unity.

مجموعة SDK لمنصة Unity بالإصدار 5.10 والإصدارات الأحدث (تستخدم أداة التضمين Unity المتوفرة من Audience Network)

إذا كنت تستخدم أداة التضمين Unity المتوفرة من 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);

يجب على الناشرين الذين يستخدمون شريك خدمة وسيطة تعيين علامة خيارات معالجة البيانات (الاستخدام المحدود للبيانات) في مجموعة Audience Network SDK من Facebook قبل تهيئة مجموعة 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/Bidding Kit 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/Bidding Kit 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 الأقدم من الإصدار 5.10، يمكن للأنشطة التجارية تجاوز التطبيق التلقائي لفترة تقييدات الاستخدام المحدود للبيانات من خلال إعداد في مدير الأرباح. ويرجى ملاحظة أن إعداد التجاوز هذا لن يتم تطبيقه إلا في حالة عدم توفر علامة 'الاستخدام المحدود للبيانات' في طلب يتعلق بشخص ما يقيم في كاليفورنيا (مثل، أي طلب وارد من إصدارات مجموعة SDK الأقدم من الإصدار 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
            ]
        ]
    }
}