セレクターとは

  • [アーティクル]

セレクターを使用すると、キーワードやキャンペーンなどの Microsoft Advertising エンティティを取得するときにフィルター条件と並べ替え条件を適用できます。 セレクターは、SQL WHERE 句と句とほぼ ORDER BY 同等の機能を提供します。 セレクターには、次のメソッドが含まれます。

  • withCondition() — エンティティが選択するために満たす必要がある条件を指定するために使用します。 これは SQL WHERE 句と同じです。

    例: withCondition('Name STARTS_WITH "Contoso"')

    セレクターに 1 つ以上の条件を適用できます。 複数の条件を指定することは、AND 操作と見なされます。 たとえば、条件 A が true の場合にのみエンティティが選択され、条件 B が true です。

  • withIds() — を使用して、選択するエンティティの ID を指定します。 これは SQL IN 句と同じです。

    例: withIds(["1","2","3","4"])

  • forDateRange() — を使用して、指定した日付範囲に一致するパフォーマンス データを持つエンティティを返します。 条件でメトリック列が指定されている場合は、セレクターのチェーンにを含める forDateRange 必要があります。

    例: forDateRange("LAST_14_DAYS")

  • orderBy() — セレクターから返されるエンティティを指定されたフィールドで並べ替える場合に使用します。 これは SQL ORDER BY 句と同じです。

    例: orderBy("Clicks DESC")

  • withLimit() — を使用して、指定された数のエンティティを返します。 これは SQL TOP 句と同じです。

    例: withLimit(50)

各メソッドはフィルター条件が適用されたセレクターを返すので、複数の条件を連結 (ドット表記) してフィルター条件を絞り込むことができます。 例:

var selector = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10);

スクリプトのパフォーマンスを向上させるには、特定のフィルター条件を使用して、必要なエンティティのみを確実に取得します。 セレクターを取得した後、 メソッドを get() 呼び出して、エンティティの一覧を反復処理するために使用する反復子を取得します。

var campaigns = selector.get();

または

var campaigns = AdsApp.campaigns()
    .withCondition("ClickConversionRate > 0.5")
    .withCondition("Cost > 4.0")
    .forDateRange("LAST_WEEK")
    .withLimit(10)
    .get();

セレクターの一覧を次に示します。

次の手順

反復子について学習する