UMP 将其输出写入此处SharedPreferences
概述的某些属性。您可以编写一些辅助方法来查询这些属性,以了解用户给予的广告许可级别或用户是否是 EEA,但您需要查看的不仅仅是字符串。VendorConsents
通常,您需要查找 5 个属性来确定是否会投放广告:
IABTCF_gdprApplies
- 一个整数(0 或 1),指示用户是否在 EEA
IABTCF_PurposeConsents
- 由 0 和 1 组成的字符串,最多 10 个条目,指示用户是否为 10 个不同的目的提供了同意
IABTCF_PurposeLegitimateInterests
- 由 0 和 1 组成的字符串,最多 10 个条目,指示应用程序是否对 10 个不同目的具有合法权益
IABTCF_VendorConsents
- 任意长度的 0 和 1 字符串,指示给定供应商是否已为上述目的获得同意。每个供应商都有一个 ID,表明他们在字符串中的位置。例如,Google 的 ID 是 755,因此如果 Google 已获得同意,则此字符串中的第 755 个字符将为“1”。
IABTCF_VendorLegitimateInterests
- 与供应商同意字符串类似,但它表明供应商是否对先前指定的目的具有合法权益。
根据此处的 Google 文档,UMP 资金选择表在投放广告方面实际上只有几个实际结果:
- 用户点击“同意所有人” - 上面的字符串将全为 1,并且将显示个性化广告
- 用户单击“不同意” - 根本不会显示任何广告
- 用户单击“管理”并选择存储同意(目的 1)并滚动浏览未按字母顺序列出的供应商的巨大列表以也选择“Google” - 将显示非个性化广告
- 用户单击“管理”并执行了比上一步少的操作(例如,选择了存储和基本广告,但没有从供应商列表中手动选择 Google) - 同样,根本不会显示任何广告
这是一组非常不理想的选项,因为 #3 极不可能发生,而 #2 和 #4 导致用户无需付费即可获得无广告应用。出于所有实际目的,这已删除旧版许可 SDK 中的“非个性化广告”选项(以及购买无广告应用程序的选项),并将其替换为完全禁用广告。
我已经编写了一些帮助方法,至少可以让您查询用户实际选择的内容并采取相应的行动。
fun isGDPR(): Boolean {
val prefs = PreferenceManager.getDefaultSharedPreferences(applicationContext)
val gdpr = prefs.getInt("IABTCF_gdprApplies", 0)
return gdpr == 1
}
fun canShowAds(): Boolean {
val prefs = PreferenceManager.getDefaultSharedPreferences(applicationContext)
//https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details
//https://support.google.com/admob/answer/9760862?hl=en&ref_topic=9756841
val purposeConsent = prefs.getString("IABTCF_PurposeConsents", "") ?: ""
val vendorConsent = prefs.getString("IABTCF_VendorConsents","") ?: ""
val vendorLI = prefs.getString("IABTCF_VendorLegitimateInterests","") ?: ""
val purposeLI = prefs.getString("IABTCF_PurposeLegitimateInterests","") ?: ""
val googleId = 755
val hasGoogleVendorConsent = hasAttribute(vendorConsent, index=googleId)
val hasGoogleVendorLI = hasAttribute(vendorLI, index=googleId)
// Minimum required for at least non-personalized ads
return hasConsentFor(listOf(1), purposeConsent, hasGoogleVendorConsent)
&& hasConsentOrLegitimateInterestFor(listOf(2,7,9,10), purposeConsent, purposeLI, hasGoogleVendorConsent, hasGoogleVendorLI)
}
fun canShowPersonalizedAds(): Boolean {
val prefs = PreferenceManager.getDefaultSharedPreferences(applicationContext)
//https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/blob/master/TCFv2/IAB%20Tech%20Lab%20-%20CMP%20API%20v2.md#in-app-details
//https://support.google.com/admob/answer/9760862?hl=en&ref_topic=9756841
val purposeConsent = prefs.getString("IABTCF_PurposeConsents", "") ?: ""
val vendorConsent = prefs.getString("IABTCF_VendorConsents","") ?: ""
val vendorLI = prefs.getString("IABTCF_VendorLegitimateInterests","") ?: ""
val purposeLI = prefs.getString("IABTCF_PurposeLegitimateInterests","") ?: ""
val googleId = 755
val hasGoogleVendorConsent = hasAttribute(vendorConsent, index=googleId)
val hasGoogleVendorLI = hasAttribute(vendorLI, index=googleId)
return hasConsentFor(listOf(1,3,4), purposeConsent, hasGoogleVendorConsent)
&& hasConsentOrLegitimateInterestFor(listOf(2,7,9,10), purposeConsent, purposeLI, hasGoogleVendorConsent, hasGoogleVendorLI)
}
// Check if a binary string has a "1" at position "index" (1-based)
private fun hasAttribute(input: String, index: Int): Boolean {
return input.length >= index && input[index-1] == '1'
}
// Check if consent is given for a list of purposes
private fun hasConsentFor(purposes: List<Int>, purposeConsent: String, hasVendorConsent: Boolean): Boolean {
return purposes.all { p -> hasAttribute(purposeConsent, p)} && hasVendorConsent
}
// Check if a vendor either has consent or legitimate interest for a list of purposes
private fun hasConsentOrLegitimateInterestFor(purposes: List<Int>, purposeConsent: String, purposeLI: String, hasVendorConsent: Boolean, hasVendorLI: Boolean): Boolean {
return purposes.all { p ->
(hasAttribute(purposeLI, p) && hasVendorLI) ||
(hasAttribute(purposeConsent, p) && hasVendorConsent)
}
}