Package 

Class TargetingParams


  • 
    public class TargetingParams
    
                        

    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 Detail

      • setPublisherName

         static void setPublisherName(String publisherName)

        Sets publisher name

        Parameters:
        publisherName - Publisher name
      • getDomain

         static synchronized String getDomain()

        Get the domain of your app

      • setDomain

         static synchronized void setDomain(String domain)

        Set the domain of your app for targeting purpose

        Parameters:
        domain - domain of your app
      • setStoreUrl

         static synchronized void setStoreUrl(String storeUrl)

        Set the store url of your app

        Parameters:
        storeUrl - store url
      • getBundleName

         static synchronized String getBundleName()

        Get the platform-specific identifier, should be bundle/package name

      • setBundleName

         static synchronized void setBundleName(String bundleName)

        Set the platform-specific identifier for targeting purposeShould be bundle/package name

      • setUserExt

         static void setUserExt(Ext ext)

        Sets user Ext

        Parameters:
        ext - Placeholder for exchange-specific extensions to OpenRTB.
      • setSendSharedId

         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 idis to be added to outgoing auction requests
      • setLocationDecimalPrecision

         static void setLocationDecimalPrecision(@Nullable() 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
      • setUserLatLng

         static void setUserLatLng(Float latitude, Float longitude)

        Sets user latitude and longitude

        Parameters:
        latitude - User latitude
        longitude - User longitude
      • addUserKeyword

         static void addUserKeyword(String keyword)

        This method obtains the user keyword for global user targetingInserts the given element in the set if it is not already present.

      • addUserKeywords

         static void addUserKeywords(Set<String> keywords)

        This method obtains the user keyword set for global user targetingAdds the elements of the given set to the set.

      • removeUserKeyword

         static void removeUserKeyword(String keyword)

        This method allows to remove specific user keyword from global user targeting

      • clearUserKeywords

         static void clearUserKeywords()

        This method allows to remove all keywords from the set of global user targeting

      • getSharedId

         static ExternalUserId getSharedId()

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

      • resetSharedId

         static void resetSharedId()

        Resets and clears out of local storage the existing SharedID value, after which `TargetingParams.sharedId` willreturn a new randomized value.

      • addExtData

         static void addExtData(String key, String value)

        This method obtains the context data keyword & value context for global context targetingif the key already exists the value will be appended to the list. No duplicates will be added(app.ext.data)

      • updateExtData

         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

         static void removeExtData(String key)

        This method allows to remove specific context data keyword & values set from global context targeting

      • clearExtData

         static void clearExtData()

        This method allows to remove all context data set from global context targeting

      • addBidderToAccessControlList

         static void addBidderToAccessControlList(String bidderName)

        This method obtains a bidder name allowed to receive global targeting(ext.prebid.data)

      • clearAccessControlList

         static void clearAccessControlList()

        This method allows to remove all the bidder name set

      • isSubjectToGDPR

        @Nullable() 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 initializeSdk.

      • getGDPRConsentString

        @Nullable() 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 initializeSdk.

      • getPurposeConsent

        @Nullable() 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 initializeSdk.

      • getPurposeConsents

        @Nullable() 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 initializeSdk.

      • getDeviceAccessConsent

        @Nullable() 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 initializeSdk.

      • setGlobalOrtbConfig

         static void setGlobalOrtbConfig(String config)

        Sets global OpenRTB JSON string for merging with the original request.Expected format: {@code "{"new_field": "value"}"}.

        Parameters:
        config - JSON OpenRTB string.