Синтаксис функций

Область применения функций

Функции изменяют значение тегов из фида. Функции могут применяться к тегам во всех разделах кампании, где допустимо использовать теги:

  • Шаблоны для ключевых слов (вкладка Фразы)
  • Шаблоны для текстов объявлений и заголовков (вкладка Объявления)
  • Выражение для URL (вкладка ссылки)
  • Шаблоны дополнительных ссылок (вкладка Ссылки)
  • Шаблоны расширений (вкладка Расширения для Google Ads)
  • Шаблоны для названия кампаний и для регионов (вкладка Параметры кампаний)

Синтаксис

Функции имеют строгий синтаксис. Ниже представлены основные требования к написанию функций:

  1. Функция пишется после тега и отделяется от него знаком * (звездочка)

#тег*Функция()#

Пример:#model*УбратьСпецсимволы('')#

  1. К тегу можно применить несколько функций, в таком случае функции перечисляются через запятую

#тег*Функция1(),Функция2(),Функция3()#

Пример: #model*УбратьСпецсимволы(''),ЦифраБуква()#

  1. У функций есть аргументы, они записываются внутри круглых скобок () и отделяются друг от друга запятыми. Функции делятся на несколько видов: без аргументов, с одним аргументом, с несколькими аргументами.

Пример функции без аргументов:#model*ЦифраБуква()# Пример функции с одним аргументом: #model*ВзятьТолько('цифры')# Пример функции с несколькими аргументами: #model*ВзятьДо(1,'цифры','слева','не включая')#

  1. Аргументы функции могут быть:

    • фиксированнами значениями, их необходимо употреблять в том написании, которое предложено, например: латиница,кириллица,цифры и тд

    Пример: #model*ВзятьТолько(цифры)#

    • значениями, записанными в ручную

    Пример: #model*Заменить(Samsung,Самсунг)#

    • тегами. Чтобы употребить тег в качестве аргумента, необходимо использовать специальную функцию Тег()

#vendor*Сцепить(Тег(model))#

  1. Функции применяются к тегу последовательно, то есть каждая следующая функция применяется к результату предыдущей генерации. Разберем данную особенность на примере формирования ключевого слова из тега model:

    • тег #model# имеет значение эллиптический тренажер hasttings q600
    • с помощью функции ВзятьПосле() мы получили два варианта генерации: эллиптический тренажер hasttings q600, hasttings q600. Значение тега в оригинальном написании, и значение тега под действием функции.
    • вторая функция ЦифраБуква() применяется к предыдущим результатам генерации и дает еще два новых значения: эллиптический тренажер hasttings q600, hasttings q600, эллиптический тренажер hasttings q 600, hasttings q 600. Значение тега под действием второй функции и значение тега под действием одновременно и первой, и второй функции
    • итого, под действием двух функций получится 4 ключевых слова:

Пример:

Выражение Результат
#model# эллиптический тренажер hasttings q600
#model*ВзятьПосле(2,'кириллица','слева','не включая')# эллиптический тренажер hasttings q600, hasttings q600
#model*ВзятьПосле(2,'кириллица','слева','не включая'),ЦифраБуква()# эллиптический тренажер hasttings q600, hasttings q600, эллиптический тренажер hasttings q 600, hasttings q 600
Выражение Результат
#model# эллиптический тренажер hasttings q600
#model*ВзятьПосле(2,'кириллица','слева','не включая')# эллиптический тренажер hasttings q600, hasttings q600
#model*ВзятьПосле(2,'кириллица','слева','не включая'),ЦифраБуква()# эллиптический тренажер hasttings q600, hasttings q600, эллиптический тренажер hasttings q 600, hasttings q 600
  1. Чтобы несколько функций, которые применяются к одному тегу, не множили варианты, а действовали одновременно, перед названием функции необходимо поставить ! (восклицательный знак). В таком случае получится только один результат генерации - значение тега под действием одновременно всех функций, в нашем случае двух.
Выражение Результат
#model# эллиптический тренажер hasttings q600
#model*!ВзятьПосле('2','кириллица','слева','не включая'),!ЦифраБуква()# hasttings q 600
Выражение Результат
#model# эллиптический тренажер hasttings q600
#model*!ВзятьПосле('2','кириллица','слева','не включая'),!ЦифраБуква()# hasttings q 600

Тестер выражений

Проверить результат генерации функций можно в каждом разделе, для этого необходимо нажать на карандаш рядом с полем ввода выражения или на кнопку «Тестер Выражений» внизу страниц «Объявления» и «Фраза»

Синтаксис

В тестере выражений вы можете:

  • выбрать из выпадающего меню теги;
  • просмотреть краткую информацию по использованию функций
  • просмотреть результат применения тегов на одном примере, а также заменить значение примера

Синтаксис

1
Фильтр функций

Все функции сгруппированы по тематическим группам (Обрезка, Замена и т.д.), в данном выпадающем меню вы можете выбрать необходимую группу функций.

2
Выбор тега

В данном выпадающем меню вы можете просмотреть и выбрать один из тегов из вашего фида.

3
Тип шаблона

Выбор шаблона, который необходимо протестировать.

4
Добавление функции к тегу

По нажатию на => напротив функции, она добавится к тегу из правого окна.

5
Добавленные теги

Все добавленные теги отразятся в данном блоке в той же последовательности, что они стоят в окне ниже. По нажатию на крестик около названия тега, она удалится вместе с примененными функциями

6
Список аргументов

В случае, если у функций есть аргументы, их можно будет выбрать или заполнить в данном блоке.

7
Поле для редактирования выражения

В данном поле можно вручную создать или отредактировать общее выражение.

8
Теги и их значения

В данную таблицу подтянутся значения тегов из первого офера YML файла или из первой строки CSV. Если тег незаполнен, то поле значение останется пустым. Значения тегов можно вносить вручную, тем самым проверяя варианты применения функции для разных значений тегов.

9
Результат генерации

В данном поле будет отображен результат генерации и количество символов.

10
Проверка выражения и сохранение

После того, как вы сформировали все интересующие теги и функции в поле сверху, нажмите кнопку "Проверить выражение". Результат сформируется в поле 9.

Нажмите "Сохранить и закрыть", для сохранения набора тегов и функций.