高级设置

GDPR

OpenMediation 聚合平台（Android SDK版本2.0.0及更高版本）支持发布商将用户的同意选择传达给中介网络（对于受支持的网络）。

要使用 OpenMediation 的API更新用户的同意状态，请使用以下方法（我们将会保存您最新的设置）：

如果用户同意接收个性化广告，请将以下标志设置为true：

OmAds.setGDPRConsent(true);

如果用户不同意接收个性化广告，请将以下标志设置为false：

OmAds.setGDPRConsent(false);

建议您在SDK初始化前设置。

OpenMediation SDK会保存之前设置的GDPR选择，开发者不需要每次初始化时都给SDK设置GDPR同意标志。可以使用AdTiming的API来获取用户的同意状态，请使用以下方法：

OmAds.getGDPRConsent();

建议您在SDK初始化之后调用。

COPPA

为了保护孩童隐私，OpenMediation 不投放广告于年纪小于13岁的青少年，请务必遵守以下规范：

如果您的应用是非儿童导向的移动应用程序，但是覆盖的用户有可能包含13岁以下人群，则请您首先在应用中实施流程来明确应用程序当前设备主体是否已满13岁，如果该设备主体未满13岁则请务必不要在应用程序中初始化 OpenMediation SDK并请求和展示广告。如果您的应用程序初始化了 OpenMediation SDK 并请求和展示广告，那我们默认为您已确认该应用程序当前的设备主体已满13岁。

OpenMediation 聚合平台支持 setAgeRestricted 标志，该标志可帮助发布者通过其用户基础获利，同时又遵守《儿童在线隐私保护法》（COPPA）。（我们将会保存您最新的设置）

您应该指出用户是否属于儿童。如果已知用户属于年龄限制类别（即13岁以下），请将以下标志设置为true。

OmAds.setAgeRestricted(true);

如果已知用户不在年龄限制的类别（即13岁或以上）中，请将以下标志设置为false。

OmAds.setAgeRestricted(false);

建议您在 SDK 初始化前设置。 

要使用 OpenMediation 的 API 获取用户的当前设置状态，请使用以下方法：

OmAds.getAgeRestricted();

建议您在SDK初始化之后调用。

CCPA

OpenMediation 聚合平台（Android SDK版本2.0.0及更高版本）支持发布商根据《加利福尼亚消费者隐私法》（CCPA）限制最终用户的个人信息销售。

应基于 setUSPrivacyLimit 设置（将其值设置为true或false）来处理位于加利福尼亚的特定用户的个人信息通知。（我们将会保存您最新的设置）

如果用户不允许出售个人信息：

OmAds.setUSPrivacyLimit(true);

如果用户允许出售个人信息：

OmAds.setUSPrivacyLimit(false);

建议您在SDK初始化前设置。

要使用 OpenMediation 的 API 获取用户的当前设置状态，请使用以下方法：

OmAds.getUSPrivacyLimit();

建议您在SDK初始化之后调用。

细分流量

您需要将用户的详细信息告知我们的服务器，以便SDK能够根据用户所属的细分来投放广告。

OpenMediation 支持两种将数据传输到我们的服务器以概述用户细分的方法，即：

• 设备属性：OpenMediation SDK自动收集与用户设备有关的某些标准参数，例如国家和地区、设备型号、设备制造商、应用程序版本、操作系统等。您无需将此数据传达给我们。
• 用户属性：必须通过API上报全面的用户数据，例如年龄、性别、IAP等（请参阅受支持的详细属性完整列表以及以下说明）。请按照说明向我们发送您的用户详细信息，以便我们的SDK可以根据您在OpenMediation 平台上定义的信息对不同的用户进行分类。

在 OpenMediation 平台上定义用户详细信息后，您应该将用户的详细信息通知给我们的服务器。

支持的用户属性

设置用户年龄（我们将会保存您最新的设置）

OmAds.setUserAge(20);

获取用户年龄（建议在初始化之后调用）

OmAds.getUserAge();

设置用户性别（我们将会保存您最新的设置）

OmAds.setUserGender("male");

获取用户性别（建议在初始化之后调用）

OmAds.getUserGender();

上报IAP数据

IAP是 in-App Purchase的缩写，中文称为“应用内购买”，表示该设备的用户在应用内购买虚拟商品的花费。您可以通过SDK的 setIAP 接口上报用户购买虚拟商品的金额数据，这些IAP数据可以帮助我们为您的用户更加精准的投放广告，从而获得更好的广告收益。

OmAds.setIAP(float iapCount, String currency); 

currency 是一个代表货币代码的字符串类型参数，按ISO国际标准组织的 ISO 4217:2008 标准定义。

您可以在SDK初始化后的任何时候上报IAP数据，比如在初始化回调 InitCallback 的 onSuccess 方法中处理，在用户发生IAP购买行为的时候，您可以调用该方法及时更新IAP数据。

OmAds.setIAP(12.30f, "USD");

设置自定义用户标识符

应用可以通过 SDK v2.1.0 及以上版本上报自定义的用户标识，只需要在初始化之前调用 setUserId 方法设置。

OmAds.setUserId(String userId);

设置自定义参数

应用可以通过 SDK v2.1.1 及以上版本上报自定义参数。您可以在任何时间设置和修改自定义参数，我们建议您在初始化之前进行设置。该参数会在用户级别的数据中体现。

// Set app defined user tags
OmAds.setCustomTag(String key, String... values);
OmAds.setCustomTag(String key, Number... values);
OmAds.setCustomTags(Map<String, Object> map);
// Return the tags set by the user, return null if not set
OmAds.getCustomTags();
// Remove app defined user tag
OmAds.removeCustomTag(String key);
// Remove all app defined user tags
OmAds.clearCustomTags();