行銷 API

適用於美國用戶的資料處理選項

限制資料使用是一種資料處理選項，可讓您進一步控制 Meta 的系統如何使用您的資料，並且在遵守美國各州隱私法規的情況下提供更完善的支援。若要運用此功能，您必須主動啟用「限制資料使用」。針對美國適用「限制資料使用」地區已經啟用「限制資料使用」的用戶，當 Meta 收到這些用戶的資料時，我們會根據身為服務提供者或處理者的角色，依適用情況處理該資料，並依照我們各州專屬條款所述方式限制該資料的使用。

提供「限制資料使用」的 Meta 產品

下列 Meta 產品提供「限制資料使用」。可用情況會視州 / 省而改變。請查看以下表格以瞭解詳情：

加州科羅拉多州康乃狄克州佛羅里達州德州奧勒岡州

Meta 商業工具

  • Meta 像素
  • 經由 Facebook SDK 的應用程式事件
  • 應用程式事件 API
  • 轉換 API
  • 離線轉換 API
✓
✓

2023 年 6 月 1 日起生效

✓

2023 年 6 月 1 日起生效

✓

2024 年 6 月 24 日起生效

✓

2024 年 6 月 24 日起生效

✓

2024 年 6 月 24 日起生效

Audience Network SDK

✓
✓

2023 年 6 月 1 日起生效

✓

2023 年 6 月 1 日起生效

✓

2024 年 6 月 24 日起生效

✓

2024 年 6 月 24 日起生效

✓

2024 年 6 月 24 日起生效

顧客檔案自訂廣告受眾

✓

2023 年 6 月 1 日起生效

❌
❌
❌
❌
❌

「限制資料使用」將經由稱為「資料處理選項」的參數傳送，且可選擇包含用戶的國家／地區和州／省。若廣告主不確定國家 / 地區或州 / 省，可以選擇由 Meta 事件或記錄是否來自適用的州 / 省。

針對商業工具及 Audience Network SDK

針對商業工具及 Audience Network，「限制資料使用」僅適用於加州、科羅拉多州、康乃狄克州、佛羅里達州、德州或奧勒岡州的民眾。若企業商家啟用「限制資料使用」但位置參數並未設為美國和加州、科羅拉多州、康乃狄克州、佛羅里達州、德州或奧勒岡州，我們會判斷事件是否來自上述州別之一。如果加州、科羅拉多州、康乃狄克州、佛羅里達州、德州或奧勒岡州的事件已經啟用「限制資料使用」，我們會根據身為服務提供者或處理者的角色，並根據各州專屬條款的資料使用限制處理該資料。

企業商家可能會發現啟用「限制資料使用」會影響行銷活動的成效和效果，且再次鎖定目標受眾和成效衡量功能將會受到限制。

針對顧客名單自訂廣告受眾

針對顧客名單自訂廣告受眾，「限制資料使用」僅限加州民眾使用。如果來自加州的顧客名單中的記錄已經啟用「限制資料使用」，我們會根據身為服務提供者或處理者的角色，並根據各州專屬條款的資料使用限制處理該資料。若企業商家啟用「限制資料使用」但位置參數並未設為美國和加州，我們會判斷記錄是否來自上述州別之一。

企業商家可能會留意到啟用「限制資料使用」時，廣告受眾的規模會受到影響。

支援的 API 如下方所列。

深入瞭解資料處理選項：

參考資料

欄位說明

資料處理選項

陣列

您想為特定事件或記錄啟用的處理選項。目前可接受的值為 LDU，亦即「限制資料使用」。


此欄位的名稱可能會以不同的方式顯示，視您所使用的 API 和實作方式而定。例如，dataProcessingOptions 用於 Meta 像素 JavaScript 呼叫，data_processing_options 則用於轉換 API 呼叫。請參閱以下呼叫範例。


您可以傳送空白陣列，以明確指示不應使用「限制資料使用」模式來處理此事件或記錄。

資料處理選項國家／地區

整數

多數 API 的選用項目。如需詳細資訊，請見以下備註。


要與此資料處理選項建立關聯的國家／地區。目前適用於美國的可接受值為 1；或者，您也可以使用 0 來要求 Meta 指定地理位置。

資料處理選項州／省

整數

多數 API 的選用項目。如需詳細資訊，請見以下備註。


要與此資料處理選項建立關聯的州／省。目前適用於加州的可接受值為 1000、科羅拉多州為 1001、康乃狄克州為 1002、加州為 1003、奧勒岡州為 1004、德州為 1005，或者您也可以使用 0 來要求 Meta 指定地理位置。


備註：

  • 如果您設定國家／地區，必須同時設定州／省。否則，將由我們指定地理位置。

支援的工具和 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 參數中的每個事件內新增 data_processing_options、data_processing_options_country 和 data_processing_options_state 來實作資料處理選項。

注意：新整合不再建議使用應用程式事件及離線轉換 API。改為建議您使用轉換 API，因其現在支援 Web、應用程式及離線事件。請參閱應用程式事件適用的轉換 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 且不直接從用戶裝置傳送資料，必須使用 HTTP X-Forwarded-For 標頭傳送用戶端 IP 位址，或明確指定地理位置。

圖形 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 以上版本（沒有使用 Audience Network 提供的 Unity 包裝函式）

如果您沒有使用 Audience Network 提供的 Unity 包裝函式，請輸入下列程式碼。


            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 包裝函式一樣。

Unity SDK，5.10 以上版本（使用 Audience Network 提供的 Unity 包裝函式）

如果您使用 Audience Network 提供的 Unity 包裝函式，請使用下列 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，讓我們能夠在出價要求中接收該標示。

實作方式新增資料處理選項

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 為 5.10 之前的版本，企業可以透過營利管理工具中的設定來覆寫「限制資料使用」限制期間的自動應用程式。請注意，只有當要求與不具「限制資料使用」標示（即由 SDK 為 5.10 之前版本所發出的任何要求）的加州用戶相關時，才適用此覆寫設定。

顧客檔案自訂廣告受眾

如果您想要在 2023 年 6 月 1 日當日／之後透過顧客名單自訂廣告受眾，針對加州用戶啟用「限制資料使用」，您必須上傳新的廣告受眾，或更新帶有「限制資料使用」標示的現有廣告受眾。視需求定期更新及維護廣告受眾及用戶的「限制資料使用」狀態。

請注意：適用於一群廣告受眾用戶的「限制資料使用」標示，不會自動套用至不同的廣告受眾。廣告主必須透過他們選擇的條件，以相同的方式分別管理每群現有顧客清單自訂廣告受眾。「限制資料使用」標示必須分別套用至廣告主的廣告鎖定的各群廣告受眾。

若記錄明確「不」啟用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
            ]
        ]
    }
}