カスタム キーワードは、広告リクエストにアタッチされた任意のキーと値のペアです。 これらは、次の目的で使用できます。
- カスタム キャンペーンのターゲット設定 (詳細については、「 キーと値のターゲット設定 」を参照してください)
- レポート ( キー値分析レポートを参照)
メソッド
広告ユニットレベルのキーワード
これらのキーワードの範囲は特定の広告ユニットです。
| メソッド | 説明 |
|---|---|
public void addCustomKeywords(String key, String value) |
指定したキーに 1 つの値を追加します。 |
public void addCustomKeywords(String key, ArrayList<String> values) |
1 回の呼び出しで、指定されたキーに複数の値を追加します。 |
public void removeCustomKeyword(String key) |
指定したキーに関連付けられているすべての値を削除します。 |
public void clearCustomKeywords() |
すべてのカスタム キーワードを削除します。 |
要求レベルのキーワード
これらのキーワードの範囲は、特定の広告ユニットではなく、広告リクエスト全体に限定されます。
ANMultiAdRequestを使用する場合は、個々の広告ユニットではなく、ANMultiAdRequest オブジェクトに直接要求レベルのキーワードを設定します。
| メソッド | 説明 |
|---|---|
public void addCustomKeywordsTopLevel(String key, String value) |
指定したキーに対して 1 つの要求レベルの値を追加します。 |
public void addCustomKeywordsTopLevel(String key, ArrayList<String> values) |
1 回の呼び出しで、指定されたキーに対して複数の要求レベルの値を追加します。 |
public void removeCustomKeywordTopLevel(String key) |
指定したキーに関連付けられているすべての要求レベルの値を削除します。 |
public void clearCustomKeywordsTopLevel() |
すべての要求レベルのカスタム キーワードを削除します。 |
例
広告ユニットレベルのキーワード
これらのキーワードの範囲は特定の広告ユニットです。
// 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
要求レベルのキーワード
要求レベルのキーワードを使用して、特定の広告ユニットではなく、広告リクエスト全体に適用されるターゲティングをアタッチします。
ANMultiAdRequestを使用する場合は、個々の広告ユニットではなく、ANMultiAdRequest オブジェクトにこれらのキーワードを直接設定します。
注:
ANMultiAdRequestの場合、ANMultiAdRequest オブジェクトに設定されたキーワードは、個々の広告ユニットに設定された要求レベルのキーワードよりも優先されます。
// 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