AssetGroupSelector

資産グループの一覧をフィルター処理および並べ替えするためのメソッドが含まれています。 セレクターの詳細については、「 セレクター」を参照してください。

使用例:

    var iterator = Campaign.assetGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var assetGroup = iterator.next();
        var metrics = assetGroup.getStats();
    }

メソッド

取得

資産グループの一覧を反復処理するために使用される 反復子 を取得します。

戻り値

orderBy(String orderBy)

選択した資産グループに指定した順序を適用します。

"columnName orderDirection" という形式で orderBy パラメーターを指定します。

• columnName は、 サポートされている列の 1 つです。
• orderDirection は、結果を並べ替える順序です。 結果を昇順に並べ替える場合は ASC に、結果を降順に並べ替える場合は DESC に設定します。 既定値は ASC です。

たとえば、次の呼び出しでは、AverageCpc によって資産グループが昇順で返されます。

selector = selector.orderBy("AverageCpc");

セレクターでは、1 つのフィールドによるエンティティの並べ替えのみがサポートされます。 フィールド x、x 内のエンティティの一覧をフィールド y ごとに並べ替えすることはできません。 チェーンまたは個別のセレクター呼び出しで複数の orderBy() 呼び出しを指定した場合、スクリプトは最後の orderBy() 呼び出しで指定されたフィールドを使用してエンティティの一覧を並べ替えます。 

引数

戻り値

withCondition(String condition)

資産グループにフィルター条件を適用します。

"columnName 演算子値" という形式で condition パラメーターを指定します。

• columnName は、 サポートされている列の 1 つです。
• operator は、サポートされている演算子の 1 つです。

演算子

使用する演算子は、列の型によって異なります。 演算子では大文字と小文字が区別されます。 たとえば、starts_withの代わりに STARTS_WITH を使用します。

整数と長い値を含む列の演算子:

<
<=
>
>=
=
!=

二重値を含む列の演算子:

<
>

文字列値を含む列の演算子:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

列挙値を含む列の演算子:

=
!=
IN []
NOT_IN []

文字列の配列を含む列の演算子:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

サポートされる列

資産グループのフィルター処理でサポートされている列。 名前では大文字と小文字が区別されます。

指定できるパフォーマンス メトリック列を次に示します。

指定できるエンティティ プロパティを次に示します。

引数

戻り値

withIds(string[] ids)

指定した ID を持つ資産グループを取得します。

セレクターに 1 つ以上の条件を適用できます。 条件のチェーンは AND 演算と見なされます。 たとえば、条件 A が true の場合にのみエンティティが選択され、条件 B が true です。 たとえば、次の呼び出しでは、資産グループ 33333 のみが選択されます。

var selector = Campaign.assetGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

引数

戻り値

withLimit(int limit)

選択条件に一致する上位 n 個の資産グループを取得します。

引数

戻り値

関連項目

Campaign.assetGroups()