Функції видають результати, які називаються значенням, що повертається. Це може бути число, текст, значення "Правда/неправда" або тип даних (залежно від функції). Для більшості функцій потрібно вводити параметри. Це вхідні дані для функції, що вводяться в дужках відразу після її назви й відокремлюються комами. Важливо враховувати послідовність параметрів і формат даних кожного з них. Якщо ввести функцію з меню, буде вставлено текст заповнювача для кожного параметра. Щоб додати функцію, слід замінити текст заповнювача для кожного параметра. Функції з трьома крапками (…) можуть приймати будь-яку кількість додаткових параметрів.
Вказівки щодо використання фільтрів у спеціальних стовпцях із формулами наведено в цій статті.
| Категорія | Тип повернутого значення | Функція | Опис |
| Арифметика | Число | round(x) |
Округлює x до найближчого цілого числа. Докладніше |
| Арифметика | Число | floor(x) |
Повертає найбільше ціле число, яке менше ніж |
| Арифметика | Число | ceiling(x) |
Повертає найменше ціле число, яке більше ніж |
| Логіка | Міняється | if(condition, if_true, if_false) |
Оцінює умову condition і повертає відповідь if_true, якщо умову виконано, і відповідь if_false, якщо умову не виконано. Тип значення, що повертається, відповідатиме типу if_true або if_false. Докладніше |
| Логіка | Правда/неправда | or(x, y, ...) |
Повертає відповідь True, якщо один із параметрів правдивий. Докладніше |
| Логіка | Правда/неправда | not(x) |
Повертає відповідь True, якщо параметр x неправдивий, або відповідь False, якщо параметр x правдивий. Докладніше |
| Логіка | Правда/неправда | and(x, y, ...) |
Повертає відповідь True, якщо всі параметри правдиві. Докладніше |
| Логіка | Логічне значення | is_not_finite(value) |
Визначає, чи число натуральне, і повертає значення true або false. Докладніше |
| Логіка | Логічне значення, число або текст | if_error(value, error_value) |
Знаходить значення value. Якщо значення "value" повертає помилку, функція знаходить альтернативне значення alternate. Докладніше |
| Логіка | Логічне значення, число або текст | is_error(value) |
Повертає true, якщо значення value є помилкою. Докладніше |
| Логіка | Логічне значення або число | if_not_finite(value, alternate) |
Знаходить значення value. Якщо значення value не є натуральним числом, функція знаходить альтернативне значення alternate. Докладніше |
| Текст | Текст | concat(text1, text2, ...) |
Поєднує кілька рядків тексту. Докладніше |
| Текст | Текст | Substitute_all |
Замінює кілька значень у рядку одним значенням. Докладніше |
| Текст | Текст | replace("string", start, length, "new_text") |
Замінює символи в рядку новим текстом, починаючи з позиції start і відраховуючи кількість символів, указану в length. Докладніше |
| Текст | Текст | mid("text", start, length) |
Повертає підрядок указаного рядка, починаючи з указаного символу й включаючи вказану кількість символів. Докладніше |
| Текст | Текст | clean_keyword("text", "replacement") |
Сканує рядок і замінює рядком replacement ті символи, які Search Ads 360 не підтримує для ключового слова text. Докладніше |
| Текст | Число | string_len_byte("value") |
Повертає кількість байтів у рядку. Докладніше |
| Текст | Число | search_byte("needle", "haystack") |
Повертає початкову позицію (у байтах) першого екземпляра значення needle у haystack. Докладніше |
| Текст | Текст | regex_extract("value", "regular_expression") |
Шукає рядок і повертає текст, який збігається з указаним у regular_expression. Докладніше |
| Текст | Логічне значення | regex_match("value", "regular_expression") |
Повертає true, якщо рядок повністю або частково збігається з регулярним виразом. Докладніше |
| Текст | Текст | regex_replace("value", "regular_expression", "replacement") |
Шукає в рядку текст, який збігається з указаним у regular_expression, а потім замінює текст збігу на new_text. Докладніше |
| Текст | Текст | bmm("value") |
Додає символ "+" на початку кожного слова в рядку. Докладніше |
| Текст | Текст | reduce_word("value", length, "delimiter") |
Повертає якомога більше символів, починаючи з початку рядка й рахуючи до роздільника, залишаючись у межах указаної максимальної довжини. Докладніше |
| Текст | Текст | title_case("value") |
Перетворює рядок у регістр заголовка. Докладніше |
| Текст | Текст | unescape("value") |
Розкодовує URL-адресу, яку було закодовано. Докладніше |
| Текст | Текст | & |
Об’єднує два рядки (лише для шаблонів). Докладніше |
| Текст | Текст | substitute_case_insensitive("haystack", "needle", "replacement") |
Замінює всі екземпляри needle у тексті haystack (не враховуючи регістр) текстом заміни. Немає варіанта для параметра "випадок". Докладніше |
| Текст | Текст | escape("value") |
Кодує URL-адресу. Докладніше |
| Текст | Правда/неправда | is_empty(text) |
Повертає відповідь "Правда", якщо в тексті text немає символів. Докладніше |
| Текст | Текст | trim(text) |
Вилучає пробіли навколо рядка тексту. Докладніше |
| Текст | Правда/неправда | starts_with(needle, haystack) |
Повертає відповідь |
| Текст | Правда/неправда | ends_with(needle, haystack) |
Повертає відповідь True, якщо рядок тексту haystack закінчується на needle. Докладніше |
| Текст | Число | search(needle, haystack) |
Повертає початкову позицію першого екземпляра needle у тексті haystack. Докладніше |
| Текст | Правда/неправда | contains(needle, haystack) |
Повертає відповідь "Правда", якщо рядок тексту haystack містить needle. Докладніше |
| Текст | Текст | right(text, length) |
Повертає останні символи length тексту text. Докладніше |
| Текст | Текст | left(text, length) |
Повертає перші символи length тексту text. Докладніше |
| Текст | Текст | substitute(haystack, needle, replacement) |
Замінює всі екземпляри needle у тексті haystack на replacement. Докладніше |
| Текст | Текст | upper(text) |
Конвертує всі символи в тексті text у ВЕРХНІЙ РЕГІСТР. Докладніше |
| Текст | Текст | lower(text) |
Конвертує всі символи в тексті text у нижній регістр. Докладніше |
| Текст | Число | length(text) |
Повертає кількість символів у тексті. Докладніше |
| Конверсія | Текст | to_text(value) |
Конвертує значення value в текст. Докладніше |
| Конверсія | Текст | to_text_with_precision(value, precision) |
Перетворює числові дані в рядок із точною кількістю знаків після десяткового роздільника. Докладніше |
| Конверсія | Число | extract_percent("XX%") |
Зчитує відсоток і повертає значення у вигляді десяткового дробу. Докладніше |
| Конверсія | Число | to_number(value) |
Перетворює значення value в число. Докладніше |
| Дата | Дата | date(year, month, day) |
Повертає дату з указаним роком, місяцем і днем. Докладніше |
| Дата | Число | day(date) |
Повертає день місяця з дати date. Докладніше |
| Дата | Число | month(date) |
Повертає місяць року (від 1 до 12) з дати date. Докладніше |
| Дата | Число | quarter(date) |
Повертає квартал року (від 1 до 4) з дати date. Докладніше |
| Дата | Число | year(date) |
Повертає рік дати date як число. Докладніше |
| Дата | Число | weekday(date) |
Повертає день тижня (від 1 до 7) для дати date, де неділя становить 1. Докладніше |
| Дата | Число | weeknum(date(year, month, day)) |
Повертає номер поточного тижня в році (від 1 до 54) для дати date, де тижні починаються в неділю. Докладніше |
| Дата | Число | daynum(date(year, month, day)) |
Повертає день року (від 1 до 355 або 356) для дати date. Докладніше |
| Дата | Число | days_between(date1, date2) |
Повертає кількість днів між date1 і date2. Докладніше |
| Дата | Дата | offset_days(date(year, month, day), days) |
Додає дні [days] до date, обчислюючи майбутні/минулі дні в календарі. Докладніше |
| Дата | Дата | offset_months(date(year, month, day), months) |
Додає months у компонент місяця date; якщо отриманий місяць має недостатньо днів для компонента дня, повертається останній день нового місяця. Докладніше |
| Дата | Дата | offset_years(date(year, month, day), years) |
Додає years у компонент року date. Докладніше |
| Дата | Дата | today() |
Повертає поточну дату в часовому поясі облікового запису власника спеціального стовпця. Докладніше |
| Дата | Дата | yesterday() |
Повертає попередній день у часовому поясі облікового запису власника спеціального стовпця. Докладніше |
| Дата | Дата | week_start_sunday() |
Повертає дату найближчої минулої неділі в часовому поясі облікового запису власника спеціального стовпця. Докладніше |
| Дата | Дата | week_start_monday() |
Повертає дату найближчого минулого понеділка в часовому поясі облікового запису власника спеціального стовпця. Докладніше |
| Дата | Дата | month_start() |
Повертає перший день поточного місяця в часовому поясі облікового запису власника спеціального стовпця. Докладніше |
| Дата | Дата | year_start() |
Повертає перший день поточного року (1 січня) у часовому поясі облікового запису власника спеціального стовпця. Докладніше |
| Дата | Дата | report_range_start() |
Повертає дату на початку діапазону поточного часу звіту Докладніше |
| Дата | Дата | report_range_end() |
Повертає дату в кінці діапазону поточного часу звіту. Докладніше |
| Дата | Число | report_days_count() |
Повертає кількість днів, охоплених звітом, на основі дати початку й дати завершення. Докладніше |
| Агрегація | Міняється | any_with_max(value, order_value) |
Повертає значення з об’єкта, що має найбільше значення для вказаного атрибута. Докладніше |
| Агрегація | Міняється | any_with_min(value, order_value) |
Повертає значення з об’єкта, що має найменше значення для вказаного атрибута. Докладніше |
| Агрегація | Міняється | max_with_max(value, order_value) |
Повертає найбільше значення з групи об’єктів, що має найбільше значення для вказаного атрибута. Докладніше |
| Агрегація | Міняється | max_with_min(value, order_value) |
Повертає найбільше значення з групи об’єктів, що має найнижче значення для вказаного атрибута. Докладніше |
| Агрегація | Міняється | min_with_max(value, order_value) |
Повертає найменше значення з групи об’єктів, що має найбільше значення для вказаного атрибута. Докладніше |
| Агрегація | Міняється | min_with_min(value, order_value) |
Повертає найменше значення з групи об’єктів, що має найнижче значення для вказаного атрибута. Докладніше |
| Агрегація | Міняється | any(value) |
Вибирає значення value для атрибута ресурсу з одного з об’єктів, вибраних шаблоном. Докладніше |
| Агрегація | Міняється | max(value) |
Повертає найбільше значення атрибута з групи об’єктів. Докладніше |
| Агрегація | Міняється | min(value) |
Повертає найменше значення атрибута з групи об’єктів. Докладніше |
| Агрегація | Число | count() |
Повертає кількість унікальних об’єктів асортименту, вибраних за допомогою коефіцієнтів і фільтрів шаблона асортименту. Докладніше |
| Агрегація | Число | count_with_max(value, order_value) |
Повертає кількість об’єктів із найвищим значенням для вказаного атрибута. Докладніше |
| Агрегація | Число | count_with_min(value, order_value) |
Повертає кількість об’єктів із найменшим значенням для вказаного атрибута. Докладніше |
| Інше | ПРАВДА | True |
Постійне правдиве значення. Докладніше |
| Інше | НЕПРАВДА | False |
Постійне неправдиве значення. Докладніше |
| Інше | Логічне значення | =, <>, <, >, <=, >= |
Порівнює два об’єкти даних і повертає значення true або false. Докладніше |