SUDOPPrivacyConfig
SUDOPPrivacyConfig 是 OP SDK 初始化时可选的广告隐私配置。它只承载宿主通过 CMP 或自身合规流程已经确认的状态。
Builder 创建方式
java
public static Builder builder();
// Builder
public Builder setGdprConsentStatus(GdprConsentStatus value);
public Builder setDoNotSellStatus(DoNotSellStatus value);
public Builder setLgpdConsentStatus(LgpdConsentStatus value);
public Builder setAgeRestrictedTreatment(AgeRestrictedTreatment value);
public SUDOPPrivacyConfig build();参数说明
通过 builder() 创建 Builder,按需设置已确认的状态,最后调用 build() 创建不可变配置。未设置的字段默认为 null;后续修改 Builder 不影响已创建的配置。
| 参数 | 可选值 | 说明 |
|---|---|---|
gdprConsentStatus | NOT_APPLICABLE / GRANTED / DENIED | GDPR 广告相关数据处理同意状态。 |
doNotSellStatus | NOT_APPLICABLE / OPTED_OUT / NOT_OPTED_OUT | 用户是否退出个人信息销售或共享。 |
lgpdConsentStatus | NOT_APPLICABLE / GRANTED / DENIED | 巴西 LGPD 同意状态。 |
ageRestrictedTreatment | UNSPECIFIED / CHILD / TEEN | 儿童或青少年广告处理方式。 |
整个配置或任一参数都可以为 null。null 表示 OP SDK 不主动设置对应广告 SDK 的状态,不表示同意、拒绝或不适用。
前三项的 NOT_APPLICABLE 不设置对应状态;年龄项的 UNSPECIFIED 表示未指定年龄限制,会设置该选项,与 null 不同。撤回选择时请传入明确的 DENIED 或 OPTED_OUT 等状态,不要用空配置代替。
示例
java
// 先从宿主 CMP 或隐私流程取得用户已确认的选择,再构造本次隐私配置。
// 以下值仅演示写法,不是默认授权;不要直接按示例值替用户作出选择。
// 任一参数可传 null:不主动设置该状态。null 不代表拒绝、撤回或重置第三方状态。
SUDOPPrivacyConfig privacyConfig = SUDOPPrivacyConfig.builder()
// GDPR 广告相关数据处理同意:GRANTED 已同意;DENIED 拒绝或已撤回。
// NOT_APPLICABLE 表示不适用,此项不设置;不是“默认同意”。
.setGdprConsentStatus(SUDOPPrivacyConfig.GdprConsentStatus.GRANTED)
// 是否退出个人信息销售或共享:OPTED_OUT 已退出;NOT_OPTED_OUT 未退出。
// NOT_APPLICABLE 表示不适用;注意“已退出”不是“已同意”。
.setDoNotSellStatus(SUDOPPrivacyConfig.DoNotSellStatus.OPTED_OUT)
// 巴西 LGPD 同意状态:GRANTED 已同意;DENIED 拒绝或已撤回。
// NOT_APPLICABLE 表示不适用;应单独确认,不能直接复制 GDPR 的选择。
.setLgpdConsentStatus(SUDOPPrivacyConfig.LgpdConsentStatus.NOT_APPLICABLE)
// 年龄处理:CHILD 按儿童处理;TEEN 按青少年处理,不等同于儿童。
// UNSPECIFIED 显式指定未设置年龄限制;null 则不主动设置,与前者不同。
.setAgeRestrictedTreatment(SUDOPPrivacyConfig.AgeRestrictedTreatment.TEEN)
.build();注意事项
- 接入方负责判断法律适用性并取得用户选择;本对象不展示同意弹窗,也不替代 CMP。
- IAB TCF、GPP 等标准字符串仍由接入方选择的 CMP 按各广告平台要求维护。
- 初始化时通过 initSDK 传入。
