Package org.prebid.mobile

Class TargetingParams

java.lang.Object
org.prebid.mobile.TargetingParams
public class TargetingParams extends Object
TargetingParams class sets the Targeting parameters like yob, gender, location and other custom parameters for the adUnits to be made available in the auction.

  • Method Details

    • setUserLatLng

      public static void setUserLatLng(Float latitude, Float longitude)
      Sets user latitude and longitude
      Parameters:
      latitude - User latitude
      longitude - User longitude

    • getUserLatLng

      public static android.util.Pair<Float,Float> getUserLatLng()

    • setLocationDecimalPrecision

      public static void setLocationDecimalPrecision(Integer precision)
      Sets the decimal precision for location coordinates (latitude/longitude) in geo-targeting. This helps control the precision of location data sent in ad requests for privacy purposes.

      Precision levels and their practical meaning:

      • null = No precision limit (default, maintains current behavior)
      • 0 = Whole numbers (~111 km precision)
      • 1 = ~11.1 km precision
      • 2 = ~1.1 km precision
      • 3 = ~110 m precision
      • 4 = ~11 m precision
      • 5 = ~1.1 m precision
      • 6 = ~0.11 m precision (maximum recommended)

      Values outside the 0-6 range will be clamped to valid range.

      Parameters:
      precision - Number of decimal places to keep, or null for no limit

    • getLocationDecimalPrecision

      public static Integer getLocationDecimalPrecision()
      Gets the current decimal precision setting for location coordinates.
      Returns:
      Current precision setting (null for no limit, 0-6 for decimal places)

    • addUserKeyword

      public static void addUserKeyword(String keyword)
      This method obtains the user keyword for global user targeting Inserts the given element in the set if it is not already present.

    • addUserKeywords

      public static void addUserKeywords(Set<String> keywords)
      This method obtains the user keyword set for global user targeting Adds the elements of the given set to the set.

    • removeUserKeyword

      public static void removeUserKeyword(String keyword)
      This method allows to remove specific user keyword from global user targeting

    • clearUserKeywords

      public static void clearUserKeywords()
      This method allows to remove all keywords from the set of global user targeting

    • getUserKeywords

      public static String getUserKeywords()

    • getUserKeywordsSet

      public static Set<String> getUserKeywordsSet()

    • setExternalUserIds

      public static void setExternalUserIds(List<ExternalUserId> userIds)
      Sets external user ids. Set null for clearing. See: ExternalUserId.

    • getExternalUserIds

      public static List<ExternalUserId> getExternalUserIds()
      Returns external user ids.

    • setSendSharedId

      public static void setSendSharedId(Boolean sendSharedId)
      When true, the SharedID external user id is added to outgoing auction requests. App developers are encouraged to consult with their legal team before enabling this feature. See `TargetingParams.sharedId` for details.
      Parameters:
      sendSharedId - the Boolean flag to determine if the SharedID external user id is to be added to outgoing auction requests

    • getSendSharedId

      public static Boolean getSendSharedId()

    • getSharedId

      public static ExternalUserId getSharedId()
      A randomly generated Prebid-owned first-party identifier Unless reset, SharedID remains consistent throughout the current app session. The same id may also persist indefinitely across multiple app sessions if local storage access is allowed. SharedID values are NOT consistent across different apps on the same device. Note: SharedId is only sent with auction requests if `TargetingParams.sendSharedId` is set to true.

    • resetSharedId

      public static void resetSharedId()
      Resets and clears out of local storage the existing SharedID value, after which `TargetingParams.sharedId` will return a new randomized value.

    • setPublisherName

      public static void setPublisherName(String publisherName)
      Sets publisher name
      Parameters:
      publisherName - Publisher name

    • getPublisherName

      public static String getPublisherName()

    • setDomain

      public static void setDomain(String domain)
      Set the domain of your app for targeting purpose
      Parameters:
      domain - domain of your app

    • getDomain

      public static String getDomain()
      Get the domain of your app
      Returns:
      domain of your app

    • setStoreUrl

      public static void setStoreUrl(String storeUrl)
      Set the store url of your app
      Parameters:
      storeUrl - store url

    • getStoreUrl

      public static String getStoreUrl()
      Get the store url of your app
      Returns:
      store url

    • getBundleName

      public static String getBundleName()
      Get the platform-specific identifier, should be bundle/package name

    • setBundleName

      public static void setBundleName(String bundleName)
      Set the platform-specific identifier for targeting purpose Should be bundle/package name

    • addExtData

      public static void addExtData(String key, String value)
      This method obtains the context data keyword & value context for global context targeting if the key already exists the value will be appended to the list. No duplicates will be added (app.ext.data)

    • updateExtData

      public static void updateExtData(String key, Set<String> value)
      This method obtains the context data keyword & values set for global context targeting. the values if the key already exist will be replaced with the new set of values

    • removeExtData

      public static void removeExtData(String key)
      This method allows to remove specific context data keyword & values set from global context targeting

    • clearExtData

      public static void clearExtData()
      This method allows to remove all context data set from global context targeting

    • getExtDataDictionary

      public static Map<String,Set<String>> getExtDataDictionary()

    • addBidderToAccessControlList

      public static void addBidderToAccessControlList(String bidderName)
      This method obtains a bidder name allowed to receive global targeting (ext.prebid.data)

    • removeBidderFromAccessControlList

      public static void removeBidderFromAccessControlList(String bidderName)
      This method allows to remove specific bidder name

    • clearAccessControlList

      public static void clearAccessControlList()
      This method allows to remove all the bidder name set

    • getAccessControlList

      public static Set<String> getAccessControlList()

    • getOmidPartnerName

      public static String getOmidPartnerName()
      OMID signaling

    • setOmidPartnerName

      public static void setOmidPartnerName(String omidPartnerName)

    • getOmidPartnerVersion

      public static String getOmidPartnerVersion()

    • setOmidPartnerVersion

      public static void setOmidPartnerVersion(String omidPartnerVersion)

    • setSubjectToCOPPA

      public static void setSubjectToCOPPA(Boolean value)
      Sets subject to COPPA. Null to set undefined.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • isSubjectToCOPPA

      public static Boolean isSubjectToCOPPA()
      Gets subject to COPPA. Null is undefined.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • setSubjectToGDPR

      public static void setSubjectToGDPR(Boolean value)
      Sets subject to GDPR for Prebid. It uses custom static field, not IAB.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • isSubjectToGDPR

      public static Boolean isSubjectToGDPR()
      Gets any given subject to GDPR in that order.
      1) Prebid subject to GDPR custom value, if present.
      2) IAB subject to GDPR TCF 2.0.
      Otherwise, null.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • setGDPRConsentString

      public static void setGDPRConsentString(String consent)
      Sets GDPR consent for Prebid. It uses custom static field, not IAB.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • getGDPRConsentString

      public static String getGDPRConsentString()
      Gets any given GDPR consent in that order.
      1) Prebid GDPR consent custom value, if present.
      2) IAB GDPR consent TCF 2.0.
      Otherwise, null.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • setPurposeConsents

      public static void setPurposeConsents(String purposeConsents)
      Sets Prebid custom GDPR purpose consents (device access consent).

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • getPurposeConsent

      public static Boolean getPurposeConsent(int index)
      Gets any given purpose consent for set index in that order.
      1) Prebid GDPR purpose consent custom value, if present.
      2) IAB GDPR TCF 2.0 purpose consent.
      Returns null if purpose consent isn't set or index is out of bounds.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • getPurposeConsents

      public static String getPurposeConsents()
      Gets any given purpose consent for set index in that order.
      1) Prebid GDPR purpose consent custom value, if present.
      2) IAB GDPR TCF 2.0 purpose consent.
      Otherwise, null.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • getDeviceAccessConsent

      public static Boolean getDeviceAccessConsent()
      Gets the device access consent set by the publisher.

      If custom Prebid subject and purpose consent set, gets device access from them. Otherwise, from IAB standard.

      Must be called only after PrebidMobile.initializeSdk(Context, String, SdkInitializationListener).

    • getGlobalOrtbConfig

      public static String getGlobalOrtbConfig()

    • setGlobalOrtbConfig

      public static void setGlobalOrtbConfig(String config)
      Sets global OpenRTB JSON string for merging with the original request. Expected format: "{"new_field": "value"}".
      Parameters:
      config - JSON OpenRTB string.

    • setUserExt

      public static void setUserExt(Ext ext)
      Sets user Ext
      Parameters:
      ext - Placeholder for exchange-specific extensions to OpenRTB.

    • getUserExt

      public static Ext getUserExt()