Skip to content

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 不影响已创建的配置。

参数可选值说明
gdprConsentStatusNOT_APPLICABLE / GRANTED / DENIEDGDPR 广告相关数据处理同意状态。
doNotSellStatusNOT_APPLICABLE / OPTED_OUT / NOT_OPTED_OUT用户是否退出个人信息销售或共享。
lgpdConsentStatusNOT_APPLICABLE / GRANTED / DENIED巴西 LGPD 同意状态。
ageRestrictedTreatmentUNSPECIFIED / 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 传入。