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

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

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

Вкладка Шаблоны Яндекс Директ
Объявления Название группыРасширенное объявление
Фразы Ключевые словаПодстановочная переменнаяМинус-слова группы
Ссылки СсылкаОтображаемая ссылкаutm_campaign
Расширения Стандартное полеДополнительная ссылка
Параметры кампании Название кампанииРегионы
Вкладка Шаблоны Яндекс Директ
Объявления Название группыРасширенное объявление
Фразы Ключевые словаПодстановочная переменнаяМинус-слова группы
Ссылки СсылкаОтображаемая ссылкаutm_campaign
Расширения Стандартное полеДополнительная ссылка
Параметры кампании Название кампанииРегионы

Синтаксис

  • Пишите функцию после тега и отделяйте от него знаком * (звездочка):

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

    Пример
    #model*УбратьСпецсимволы('')#
  • Применяя несколько функций к тегу, перечислите их через запятую:

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

    Пример
    #model*УбратьСпецсимволы(''),ЦифраБуква()#
  • Аргументы функции указывайте внутри круглых скобок () и разделяйте запятыми, если их несколько.

    Количество аргументов Пример
    Ни одного #model*ЦифраБуква()#
    Один #model*ВзятьТолько('цифры')#
    Несколько #model*ВзятьДо(1,'цифры','слева','не включая')#
    Количество аргументов Пример
    Ни одного #model*ЦифраБуква()#
    Один #model*ВзятьТолько('цифры')#
    Несколько #model*ВзятьДо(1,'цифры','слева','не включая')#
    Значения аргументов Пример
    Фиксированные (написание нельзя изменять): латиница, кириллица, цифры и т.д. #model*ВзятьТолько(цифры)#
    Произвольные #model*Заменить(Samsung,Самсунг)#
    Теги. Используйте функцию Тег() #vendor*Сцепить(Тег(model))#
    Значения аргументов Пример
    Фиксированные (написание нельзя изменять): латиница, кириллица, цифры и т.д. #model*ВзятьТолько(цифры)#
    Произвольные #model*Заменить(Samsung,Самсунг)#
    Теги. Используйте функцию Тег() #vendor*Сцепить(Тег(model))#
  • Функции применяются к тегу последовательно в порядке написания.

    Пример

    Разберем эту особенность сформировав ключевые слова из тега #model#.

    Выражение Результат
    #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
    • тег #model# имеет значение эллиптический тренажер hasttings q600;

    • применив к тегу функцию ВзятьПосле(2,'кириллица','слева','не включая') мы получим два значения: эллиптический тренажер hasttings q600 (оригинальное написание) и hasttings q600 (под действием функции);

    • применение второй функции ЦифраБуква() к предыдущим результатам дает еще два значения: эллиптический тренажер hasttings q 600 (под действием второй функции) и hasttings q 600 (под действием первой, а затем второй функции).

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

Проверка результата

Чтобы проверить результат выполнения функций, нажмите:

  • значок справа от поля ввода;

  • кнопку Тестер выражений внизу вкладок Объявления и Фраза.


Синтаксис
Возможности тестера выражений
  • Поиск и выбор тегов, сформированных генератором на основе фида.

  • Функции: краткая справка, фильтрация, применение к тегам.

  • Формирование выражения и замена значений тегов вручную.

  • Просмотр результата генерации (один пример).


Синтаксис
  1. Фильтр функций

    Набор фильтров, сгруппированных по темам (Обрезка, Замена и т.д.).

  2. Выбор тега

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

  3. Тип шаблона

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

  4. Функции

    При нажатии значка с буквой i появится всплывающая подсказка по использованию функции. Чтобы добавить функцию к тегу в поле 7, нажмите на название функции или значок со стрелкой справа. Аргументы функции (если они есть) автоматически добавятся в список 6.

  5. Теги

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

  6. Аргументы

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

  7. Выражение

    Поле для создания и редактирования выражения. Правки можно вносить вручную.

  8. Теги и Значения

    Таблица используемых тегов и соответствующих им значений. Изменяйте значения тегов, проверяя варианты применения функции.

  9. Результат

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

  10. Проверка и Сохранение

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

    Кнопка Сохранить и закрыть доступна только при вызове тестера из поля ввода. Нажмите кнопку для сохранения выражения.

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

    Пример

    Для генерации ключей мы используем тег name. Допустим он содержит значение «эллиптический тренажер hasttings q600». Добавляем функцию ВзятьПосле, в аргументах прописываем, что хотим обрезать содержимое тега после второго слова слева, включая это второе слово.

    Модификатор не ставим, поэтому система сгенерирует два варианта:

    • без применения функции к содержимому тега, т. е. получится ключ «эллиптический тренажер hasttings q600»;
    • с применением функции к содержимому тега, т. е. получим ключ «тренажер hasttings q600».

    Если ставим модификатор !, то система сгенерирует только один ключ с применением функции к содержимому тега:

    Пример с последовательным применением функций

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

    Например, сначала мы добавили функцию ВзятьПосле, потом функцию ВзятьТолько (в аргументе этой функции выбрали Цифры), и первую и вторую функцию используем без модификатора. В данном случае система применит первую функцию и мы получим два варианта ключа:

    • без применения функции к содержимому тега, т. е. получится ключ «эллиптический тренажер hasttings 2q 600»;
    • с применением функции к содержимому тега, т. е. получим ключ «тренажер hasttings 2q 600».

    Дальше к варианту с применением функции будет применена следующая функция и мы получим еще два варианта:

    •  с применением функции ВзятьПосле, но без применения ВзятьТолько, т. е. получим ключ «тренажер hasttings 2q 600»:
    • с применением функции ВзятьПосле и с применением ВзятьТолько, т. е. получим ключ «2 600».

    Так как варианты 2 и 3 совпадают, в итоге мы получим три ключа:

    Если у функции ВзятьТолько поставить модификатор, то сгененрируется только ключ «2 600»: