Функция COUNT(…) подсчитывает число вложенных объектов, удовлетворяющих условиям произвольного фильтра. В функции задаются типы объектов, которые нужно подсчитать, и при необходимости дочерний фильтр с условиями, которым они должны удовлетворять. Объекты другого типа или те, что не соответствуют этим условиям, учитываться не будут. Если дочерний фильтр не добавлен, функция просто подсчитает все объекты заданного типа.
Синтаксис
COUNT(types, [filter])
types– типы включенных объектов, которые нужно подсчитать.filter(необязательно) – условие, которому должны удовлетворять подсчитываемые объекты.
В функции можно задать, сколько раз в объекте должны выполняться условия фильтрации, с помощью следующих операторов:
- больше (>);
- больше или равно (>=);
- меньше (<);
- меньше или равно (<=);
- равно (=);
- не равно (- =)
Примеры
COUNT(keywords, labels = ("abc", "xyz") ) < 5
Это условие отбирает кампании или группы объявлений, в которых есть менее пяти ключевых слов с ярлыками "abc" или "xyz". Переменная "ключевые слова" задает тип объектов, которые нужно подсчитать, а выражение labels = ("abc", "xyz") – условия дочернего фильтра.
COUNT(callextensions; sitelinks, approvalstatus = approved) >= 2
Эта функция проверяет, одобрены ли все связанные с кампанией объекты дополнительных ссылок или звонков.
COUNT(ads) > 3
Это условие отбирает кампании или группы объявлений, которые содержат больше трех объявлений любого типа.
COUNT(labels) = 2
Это условие отбирает объекты, у которых есть ровно два ярлыка. Оно может быть применено в том числе и для отбора неконтейнерных объектов, таких как ключевые слова.
Примечания
- Если дочерний фильтр содержит несколько условий, подсчитываемые объекты должны удовлетворять всем им. Если условия объединить функцией OR, объектам будет достаточно соответствовать любому из этих условий. Например, условие
COUNT(ads, OR(status = paused approvalstatus = disapproved)) > 10отберет объекты, которые содержат более десяти приостановленных или отклоненных объявлений (а также приостановленных отклоненных объявлений). - Фильтр может содержать условия, которые применяются только к определенным типам объектов (для остальных объектов эти условия будут игнорироваться). Например, условие
COUNT(keywords; sitelinks, keywordwordcount = 2 linktext : "local")вернет объекты с ключевыми словами, состоящими ровно из двух слов, а также дополнительными ссылками, которые содержат слово "local".
Использование функции COUNT с кампаниями и группами объявлений
Если применить функцию на уровне кампании к объектам, которые могут содержаться только в группах объявлений, будет учитываться общее количество таких объектов во всех группах объявлений. Например, функция COUNT(keywords), примененная на уровне кампании, вернет число ключевых слов во всех входящих в кампанию группах объявлений.
Если же объекты могут содержаться как на уровне групп объявлений, так и на уровне кампании, функция подсчитает только объекты на уровне кампании. Например, функция COUNT(audiences) вернет число аудиторий, добавленных на уровне кампании. Аудитории, добавленные в эту кампанию на уровне групп объявлений, учитываться не будут. То же самое касается объектов: функция COUNT(sitelinks) на уровне кампании будет искать только дополнительные ссылки на уровне кампании, не считая ссылки на уровне группы объявлений.