Повний список функцій, які можна використовувати в спеціальних стовпцях, і загальні відомості про них наведено в цій статті.
Створюючи формули для спеціальних стовпців у шаблонах, використовуйте опції підменю, які залежать від контексту, у меню Функції. Наведіть курсор на опцію, щоб побачити додаткову інформацію. Натисніть правою кнопкою миші в тексті формули, щоб відкрити меню функцій, які відповідають поточному контексту.
Стандартні функції спеціальних стовпців у шаблонах
Нижче наведено можливі опції.
- Логіка — опції для стандартних логічних функцій, як-от
if,and,not,or,if_error,is_error,is_not_finite. - Текст — опції для текстових функцій, як-от
concat,is_empty,trim,starts_with,ends_with,search,substitute,right,left,contains,upper,lower,length,clean_keyword,string_len_byte,regex_extract,regex_match,regex_replace,search_byte,bmm,reduce_word,title_case,unescape,substitute_all. - Арифметика — опції для арифметичних функцій, як-от
round,ceiling,floor. - Перетворення — опції для функцій перетворення, як-от
to_text,to_number,extract_percentage. - Дата — опції для функцій дати, як-от
date,day,month,quarter,year,weekday,weeknum,daynum,days_between,offset_days,offset_months,offset_years,today,yesterday,week_start_sunday,week_start_monday,month_start,year_start(докладнішу інформацію дивіться в статті Функції в спеціальних стовпцях із формулами). - Агрегація — опції для функцій агрегації, як-от
min,max,any.
Функції спеціальних стовпців у шаблонах
Ви можете використовувати різноманітні функції спеціальних стовпців, доступні саме для шаблонів. Ці функції описано в таблиці нижче.
Примітки
- Ці функції використовуються в шаблонах.
- Якщо слово "value" взято в лапки, потрібно ввести текстове значення.
- У деяких функціях у таблиці нижче використовуються терміни "needle", "needles" і "haystack". Терміни "needle" або "needles" указують на певне або певні значення, що можуть міститися в ряді значень, який позначається терміном "haystack".
| Підменю | Тип повернутого значення | Вираз функції автоматизації | Опис |
|---|---|---|---|
| Логіка | Логічне значення або число | is_not_finite(value, alternate) |
Знаходить значення value. Якщо value не є числом або кінцевим числом, функція знаходить значення alternate. В іншому разі функція повертає value. |
| Логічне значення, число або текст | if_error(value, error_value) |
value. Якщо value повертає помилку, функція знаходить альтернативне значення, указане в error_value. В іншому разі функція повертає value. |
|
| Логічне значення, число або текст | is_error(value) |
Повертає "правда", якщо значення value є помилкою. |
|
| Текст | Текст | clean_keyword("text", "replacement") |
Сканує рядок і замінює текстовим значенням replacement ті символи, які рекламна платформа не підтримує для ключового слова text. |
| Число | string_len_byte("value") |
Повертає кількість байтів в атрибуті фіду або текстовому значенні. | |
| Текст | regex_extract("value", "regular_expression") |
Шукає значення value і повертає текст, який збігається з указаним у regular_expression. |
|
| Логічне значення | regex_match("value", "regular_expression") |
Повертає "правда", якщо value збігається (повністю або частково) з указаним у regular_expression. Використовуйте цю функцію як умову у функції if. |
|
| Текст | regex_replace("value", "regular_expression", "replacement") |
Шукає значення value для тексту, який збігається з указаним у regular_expression, а потім замінює текст збігу на replacement. |
|
| Число або null | search_byte("needle", "haystack") |
Повертає початкову позицію (у байтах) першого екземпляра значення needle у haystack. Повертає null, якщо значення needle не входить у haystack. Рахунок починається з 1 (а не 0). Він завжди здійснюється в напрямку, який відповідає мові рекламодавця. Застосовується переважно для мов, які не використовують набір символів латиниці, наприклад японської та китайської. |
|
| Текст | reduce_word("value", length, "delimiter") |
Повертає якомога більше символів, починаючи з початку рядка й рахуючи до роздільника (але не включаючи його), залишаючись у межах max_length. Якщо значення value вже є в межах max_length, функція повертає значення value саме так, як його було передано. |
|
| Текст | title_case("value") |
Перетворює значення value в регістр заголовка. Можна вказати атрибут фіду або статичне текстове значення. |
|
| Текст | unescape("value") |
Розкодовує URL-адресу, яку було закодовано. | |
| Текст | substitute_all("haystack", replacement, "needles") |
Замінює кілька значень атрибута одним значенням. | |
| Перетворення | Число | extract_percent("x%") |
Перетворює співвідношення, число або текст у відсоткове значення. |
| Агрегація | Логічне значення, число або текст | max(value) |
Повертає максимальне значення value числового атрибута фіду серед об’єктів, вибраних шаблоном. |
| Логічне значення, число або текст | min(value) |
Повертає мінімальне значення value числового атрибута фіду серед об’єктів, вибраних шаблоном. |
|
| Логічне значення, число або текст | any(value) |
Вибирає значення value для атрибута з одного з об’єктів, вибраних шаблоном. Ця функція може повертати інше значення value для кожного застосування. |
Як використовувати функції в спеціальних стовпцях фідів і шаблонів
Для цього:
- Виберіть потрібні функції в меню
. Наведіть курсор на функцію в меню, щоб побачити додаткову інформацію про неї.
- Виберіть функцію, яку хочете включити у формулу. Відформатований текст функції відображається з чорними елементами-заповнювачами.
- Замініть елементи-заповнювачі інформацією, яка стосується вашого застосування. Приклади дивіться в розділах Логічна функція if і Текстова функція concat нижче.
Не змінюйте зелений текст – він є обов’язковою частиною функції.
Під час створення шаблонів у новій версії Search Ads 360 відображаються лише функції, доступні для поточної ситуації.
Логічна функція if
if(condition, if_true, if_false)
Це логічна функція, яка оцінює визначену умову як "правда" або "неправда", а потім повертає значення, указані вами у виразах if_true та if_false, залежно від того, чи виконується ця умова.
- Змініть умову
condition, щоб визначити критерії для оцінювання. - Змініть значення
if_true, щоб визначити, що станеться, якщо умова виконується. - Змініть значення
if_false, щоб визначити, що станеться, якщо умова не виконується.
Текстова функція concat
concat("text1", "text2")
Це текстова функція, яка об’єднує вміст двох (або більше) значень. Щоб додати більше значень, ставте кому перед кожним наступним. Значення мають бути текстовими, але можуть братися з інших функцій. Функція text_to перетворює значення стовпця в текст.
concat("Origin ", f:"Origin")," Destination ", f:"Destination_country", f:"Destination_name"," - ", text_to(f:"Price"))
Як виправляти помилки зі значеннями функцій
Нова версія Search Ads 360 не генеруватиме кампанії, оголошення й інші об’єкти, якщо функції повертають пусті або недійсні значення. Щоб виправити помилки, скористайтеся наведеними нижче способами.
- Включіть функції у функцію
if_error(parameter, alternate)
Параметром може бути: функція, стовпець фіду, текст або комбінація цих типів. Якщо функція повертає помилку або є пустою, ви натомість отримаєте значенняalternate.
Приклад:if_error(f:"brand", "Unbranded")
Результат: повертаєf:"brand", якщо для бренду виявлено значення, і"Unbranded", якщо ні.
Зазвичай уся функція стає недійсною, якщо таким виявиться її параметр.
Приклад:if(f:"product_type" = "shoes", 1, 2)
Якщо для позиції фіду не вказано значення атрибута "тип товару"product_type, увесь вираз if стає недійсним. Включіть функціюifу функціюif_error:
Приклад:if_error(if(f:"product_type" = "shoes", 1, 2), 3)
Результат: функція повертає значення "3", якщо для позиції фіду не вказано значення атрибута "тип товару"product_type.
- Включіть функції у функцію
is_error
Використовуйтеif(is_error(parameter), alternate, value)
Параметри можуть містити посилання на стовпець фіду. Наприклад,f:"column_name"містить посилання на стовпець фіду.
Якщо функція повертає помилку (наприклад, коли стовпець фіду пустий), використовується значенняalternate. В іншому разі використовується значенняvalue.
- Застосовуйте агрегацію
Використовуйте функціїmin(value),max(value)абоany(value)для всіх випадків, коли кожна група оголошень містить кілька значень одного атрибута. Укажітьmax(f:"price"), якщо в групі оголошень можуть бути товари з різними цінами.
Як виправляти логічні помилки
Для цього використовуйте функцію if(condition, true, false), щоб відфільтровувати або змінювати небажані результати. Наприклад, задовгий текст можна скоротити за допомогою функції if.