限定データ利用は、Metaのシステムにおけるデータ利用について、ビジネスの管理権限を拡大するとともに、米国のさまざまな州のプライバシー規制を遵守する取り組みをさらに効果的にサポートするためのデータ処理オプションです。この機能を利用するには、限定的データ使用を事前に有効にしておく必要があります。限定データ利用が適用される州の利用者から限定データ利用が有効な状態でデータを受け取った場合、Metaは、必要に応じて、サービスプロバイダーまたは処理事業者としての役割に従ってそのデータを処理し、Metaの州別規約に従って、そのデータの利用を制限します。
限定データ利用を提供するMeta製品は以下のとおりです。利用可能かどうかは州によって異なります。詳しくは、以下の表をご覧ください。
カリフォルニア州 | コロラド州 | コネチカット州 | フロリダ州 | テキサス州 | オレゴン州 | |
---|---|---|---|---|---|---|
| ✓ | ✓ 発効日: 2023年6月1日 | ✓ 発効日: 2023年6月1日 | ✓ 発効日: 2024年6月24日 | ✓ 発効日: 2024年6月24日 | ✓ 発効日: 2024年6月24日 |
✓ | ✓ 発効日: 2023年6月1日 | ✓ 発効日: 2023年6月1日 | ✓ 発効日: 2024年6月24日 | ✓ 発効日: 2024年6月24日 | ✓ 発効日: 2024年6月24日 | |
✓ 発効日: 2023年6月1日 | ❌ | ❌ | ❌ | ❌ | ❌ |
限定データ利用は、データ処理オプションと呼ばれるパラメーターを通じて送信され、任意でユーザーが居住する国と州にも同時に送信できます。国や州がわからない広告主は、イベントや記録が該当する州のものかどうかをMetaが判断するというオプションを選択できます。
ビジネスツールおよびAudience Networkについては、カリフォル���ア州、コロラド州、コネチカット州、フロリダ州、テキサス州、オレゴン州の方のみ、限定データ利用が可能です。事業者が限定データ利用を有効にしたものの、ロケーションパラメーターを米国のカリフォルニア州、コロラド州、コネチカット州、フロリダ州、テキサス州、オレゴン州に設定していない場合、Metaの方でイベントがいずれの州のものかどうかを判断します。カリフォルニア州、コロラド州、コネチカット州、フロリダ州、テキサス州、オレゴン州のイベントについて限定データ利用が有効になっている場合、Metaは、サービスプロバイダーまたは処理事業者としての役割に従ってそのデータを処理し、Metaの州別規約に従ってそのデータの利用を制限します。
推察されるとおり、データ使用制限は事業者のキャンペーンのパフォーマンスと効果に影響を及ぼします。また、限定データ利用が有効な場合、リターゲティング機能と効果測定機能は制限されます。
カスタマーリストに基づくカスタムオーディエンスによる限定データ利用はカリフォルニア州の方のみご利用いただけます。限定データ利用がカリフォルニア州のカスタマーリストの記録に対して有効になっている場合、サービスプロバイダーとしての役割に基づいてデータを処理し、州固有の条件に従ってそのデータの使用を制限します。事業者が限定データ利用を有効にしたものの、ロケーションパラメーターを米国およびカリフォルニア州に設定していない場合、Metaの方で記録がカリフォルニア州のものかどうかを判断します。
限定データ利用を有効にした後、オーディエンスサイズに影響が見られる場合があります。
対応しているAPIは以下のリストをご覧ください。
データ処理オプションの詳細については、以下をご覧ください。
フィールド | 説明 |
---|---|
データ処理オプション 配列 | 特定のイベントまたは記録に対して有効にする処理オプション。現在指定可能な値は、データ使用制限を表す このフィールドは、使用しているAPIと実装に応じて、異なる名前で提示される可能性があります。例えば、MetaピクセルJavaScript呼び出しでは 空の配列を送信すれば、このイベントまたは記録が限定データ利用の制限により処理されないよう明示的に指定できます。 |
データ処理オプションを適用する国 整数 | ほとんどのAPIでは任意。詳しくは下記の注を参照してください。 このデータ処理オプションに関連付ける国。現在指定可能な値は、米国の場合は |
データ処理オプションを適用する州 整数 | ほとんどのAPIでは任意。詳しくは下記の注を参照してください。 このデータ処理オプションに関連付ける州。現在認められている値は、カリフォルニア州の場合は 注:
|
実装 | データ処理オプションの追加 |
---|---|
ブラウザーピクセル | ピクセル初期化コードを更新して、 データ使用制限(LDU)を明示的に無効にするには、次のコードを使用します。 fbq('dataProcessingOptions', []); fbq('init', '{pixel_id}'); fbq('track', 'PageView'); LDUを有効にしてMetaに地理的位置情報を使用させるには、次のコードを使用します。 fbq('dataProcessingOptions', ['LDU'], 0, 0); LDUを有効にしてカリフォルニア州など位置情報を特定するには、次のコードを使用します。 fbq('dataProcessingOptions', ['LDU'], 1, 1000); |
imageタグ | ピクセルのimageタグに以下を追加します。
指定可能な値についてはリファレンスをご覧ください。 LDUを明示的に無効にするには、 <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" /> |
これらの2つの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
ファイルからイベントを手動でアップロードするオプションを提供します。その場合は、データ処理オプション、データ処理国、データ処理州をファイル内に列として追加します。詳細については、アップロードのユーザーインターフェイスをご覧ください。
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 }
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:
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.
Implementation | Adding Data Processing Options |
---|---|
Facebook SDK for iOS v7.1.1+ (Objective-C) | With Objective-C, use 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 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 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); |
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.
Implementation | Adding Data Processing Options |
---|---|
Facebook SDK for iOS, v5.10+ | Use To explicitly not enable Limited Data Use (LDU), use: [FBAdSettings setDataProcessingOptions:@[]]; To enable LDU and have Meta perform geolocation, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; |
Facebook SDK for Android, v5.10+ | Use the To explicitly not enable Limited Data Use (LDU), use: AdSettings.setDataProcessingOptions(new String[] {}) To enable LDU and have Meta perform geolocation, use:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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 To explicitly not enable LDU, use: AdSettings.SetDataProcessingOptions(new string[]{}) To enable LDU and have Meta perform geolocation, use:
AdSettings.SetDataProcessingOptions(new string[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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.
Implementation | Adding 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:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[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.
Implementation | Adding 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:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[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:
AdSettings.setDataProcessingOptions(new String[] {"LDU"}, 0, 0); To enable LDU and manually specify the location, use:
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:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:0 state:0]; To enable LDU and manually specify the location, use:
[FBAdSettings setDataProcessingOptions:@[@"LDU"] country:1 state:1000]; After setting the LDU for the event, generate the bidder token: NSString *token = [FBAdSettings bidderToken]; |
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 ] ] } }