Pasar palabras clave personalizadas en Android

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

Métodos

Palabras clave de nivel de unidad de anuncio

Estas palabras clave se limitan a una unidad de anuncio específica.

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 especificada.
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 una unidad de anuncios específica. Al usar ANMultiAdRequest, establezca palabras clave de nivel de solicitud directamente en el ANMultiAdRequest objeto en lugar de en unidades de anuncios individuales.

Método Descripción
public void addCustomKeywordsTopLevel(String key, String value) Agrega un valor de nivel de solicitud único 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 de nivel de unidad de anuncio

Estas palabras clave se limitan a una unidad de anuncio específica.

// 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

Use palabras clave de nivel de solicitud para adjuntar la segmentación que se aplica a la solicitud de anuncio general en lugar de a una unidad de anuncios específica. Al usar ANMultiAdRequest, establezca estas palabras clave directamente en el ANMultiAdRequest objeto en lugar de en unidades de anuncios individuales.

Nota:

En ANMultiAdRequestel caso de , las palabras clave establecidas en el ANMultiAdRequest objeto invalidarán las palabras clave de nivel de solicitud establecidas en unidades de anuncio 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