Pasar palabras clave personalizadas en Android

Las palabras clave personalizadas son pares de clave-valor arbitrarios adjuntos a una solicitud de anuncio. Se pueden utilizar para:

Métodos

Palabras clave a nivel de unidad de anuncio

Estas palabras clave se limitan a un bloque de anuncios específico.

Método Descripción
public void addCustomKeywords(String key, String value) Agrega un valor único para la clave especificada.
public void addCustomKeywords(String key, ArrayList<String> values) Agrega varios valores para la clave especificada en una sola llamada.
public void removeCustomKeyword(String key) Quita todos los valores asociados a la clave dada.
public void clearCustomKeywords() Quita todas las palabras clave personalizadas.

Palabras clave de nivel de solicitud

Estas palabras clave se limitan a la solicitud de anuncio general, en lugar de a un bloque de anuncios específico. Al usar ANMultiAdRequest, establezca palabras clave de nivel de solicitud directamente en el ANMultiAdRequest objeto en lugar de en bloques de anuncios individuales.

Método Descripción
public void addCustomKeywordsTopLevel(String key, String value) Agrega un único valor de nivel de solicitud para la clave especificada.
public void addCustomKeywordsTopLevel(String key, ArrayList<String> values) Agrega varios valores de nivel de solicitud para la clave especificada en una sola llamada.
public void removeCustomKeywordTopLevel(String key) Quita todos los valores de nivel de solicitud asociados a la clave especificada.
public void clearCustomKeywordsTopLevel() Quita todas las palabras clave personalizadas de nivel de solicitud.

Ejemplo

Palabras clave a nivel de unidad de anuncio

Estas palabras clave se limitan a un bloque de anuncios específico.

// Banner
BannerAdView banner = new BannerAdView(this);
banner.addCustomKeywords("foo", "bar"); // Add single value
banner.addCustomKeywords("foo", new ArrayList<>(Arrays.asList("bar", "baz", "foe"))); // Add multiple values
banner.removeCustomKeyword("foo"); // Remove a specific key
banner.clearCustomKeywords(); // Remove all custom keywords
// Native
NativeAdRequest nativeAdRequest = new NativeAdRequest(this, "123456");
nativeAdRequest.addCustomKeywords("foo", "bar"); // Add single value
nativeAdRequest.addCustomKeywords("foo", new ArrayList<>(Arrays.asList("bar", "baz", "foe"))); // Add multiple values
nativeAdRequest.removeCustomKeyword("foo"); // Remove a specific key
nativeAdRequest.clearCustomKeywords(); // Remove all custom keywords

Palabras clave de nivel de solicitud

Usa palabras clave de nivel de solicitud para adjuntar la segmentación que se aplica a la solicitud de anuncio general en lugar de a un bloque de anuncios específico. Al usar ANMultiAdRequest, establece estas palabras clave directamente en el ANMultiAdRequest objeto en lugar de en bloques de anuncios individuales.

Nota:

Para ANMultiAdRequest, las palabras clave establecidas en el objeto reemplazarán las ANMultiAdRequest palabras clave de nivel de solicitud establecidas en bloques de anuncios individuales.

// Banner
banner.addCustomKeywordsTopLevel("foo", "bar"); // Add single request-level value
banner.addCustomKeywordsTopLevel("foo", new ArrayList<>(Arrays.asList("bar", "baz", "foe"))); // Add multiple request-level values
banner.removeCustomKeywordTopLevel("foo"); // Remove a specific key
banner.clearCustomKeywordsTopLevel(); // Remove all request-level keywords
// Native
nativeAdRequest.addCustomKeywordsTopLevel("foo", "bar"); // Add single request-level value
nativeAdRequest.addCustomKeywordsTopLevel("foo", new ArrayList<>(Arrays.asList("bar", "baz", "foe"))); // Add multiple request-level values
nativeAdRequest.removeCustomKeywordTopLevel("foo"); // Remove a specific key
nativeAdRequest.clearCustomKeywordsTopLevel(); // Remove all request-level keywords