Типы функций

Подробнее про функции и их применение читайте в разделе Синтаксис функций.

Ниже представлены функции, которые разделены по типу использования.

Обрезающие

ВзятьДо

Обрезает значение тега до заданного объекта.

В Аргументах укажите:

  • Аргумент 1 — число, которое обозначает до какого объекта нужно обрезать значение тега. Если до первого встретившегося значения, то аргумент имеет значение 1.

  • Аргумент 2 — объект, до которого нужно обрезать значение.

  • Аргумент 3 — слева (с начала выражения) или справа (с конца выражения) надо отсчитывать номер, указанный в Аргумент 1.

  • Аргумент 4 — одно из двух значений: включая — результат действия функции будет содержать объект из Аргумент 2, и не включая — функция обрежет тег до объекта из Аргумент 2.

Аргумент 3 и Аргумент 4 — необязательные. Без Аргумент 3 подсчет начнется слева, а без Аргумент 4 функция будет обрезать значение тега, не включая объект из Аргумент 2.

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4
Порядковый номер элемента. слова символы цифры кириллица латиница значение (вводится вручную) тег слева справа включая не включая
Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4
Порядковый номер элемента. слова символы цифры кириллица латиница значение (вводится вручную) тег слева справа включая не включая
Пример 1

Условие: #model# = Samsung Galaxy S5 16Gb SM-G900F синий

Результат генерации: #model*ВзятьДо(1,кириллица,слева,не включая)# = Samsung Galaxy S5 16Gb SM-G900F

Пример 2

Условие: #name# = Атлант расправил плечи (комплект из 3 книг)

Результат генерации: Книга #name*ВзятьДо(1,'(','слева','не включая')# = Книга Атлант расправил плечи

ВзятьПосле

Позволяет взять значение тега после заданного объекта.

В Аргументах укажите:

  • Аргумент 1 — число, которое обозначает после какого объекта нужно взять значение тега.

  • Аргумент 2 — объект, после которого нужно обрезать значение.

  • Аргумент 3 — слева (с начала выражения) или справа (с конца выражения) надо отсчитывать номер, указанный в Аргумент 1.

  • Аргумент 4 — одно из двух значений: включая — результат действия функции будет содержать объект из Аргумент 2, и не включая — функция обрежет тег после объекта из Аргумент 2.

Аргумент 3 и Аргумент 4 — необязательные. Без Аргумент 3 подсчет начнется слева, а без Аргумент 4 функция будет обрезать значение тега, не включая объект из Аргумент 2.

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4
Порядковый номер элемента. слова символы цифры кириллица латиница значение (вводится вручную) тег слева справа включая не включая
Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4
Порядковый номер элемента. слова символы цифры кириллица латиница значение (вводится вручную) тег слева справа включая не включая
Пример

Условие: #name# = Этой ночью, мы заставим их запомнить. Это Зион! И мы не боимся!

Результат генерации: #name*ВзятьПосле(1,'.','слева','не включая')# = Это Зион! И мы не боимся!

ВзятьТолько

Оставляет в качестве значений тега символы, соответствующие Аргумент 1.

Допустимые значения Аргумента 1 представлены в таблице.

Аргумент 1
цифры кириллица латиница буквы
Аргумент 1
цифры кириллица латиница буквы
Пример

Условие: #model# = w 3240

Результат генерации: #model*ВзятьТолько(цифры)# = 3240

Текстовые

РазбитьНаЧасти

Разделяет значение выражения на комбинации по 1 слову (не меньше 4 символов).

Функция не содержит Аргументов.

Пример

Условие: #model# = Galaxy S5 SM-G900F

Результат генерации: #model*!РазбитьНаЧасти()#=Galaxy, Galaxy S5, SM-G900F, SM-G900F Galaxy, SM-G900F S5

РазбитьПоСимволу

Разбивает одну строку на несколько по заданному символу.

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

Аргумент 1
Символ, по которому необходимо разбить строку. Если в качестве разделителя используется запятая, запишите ее в ' ' (одинарных кавычках).
Аргумент 1
Символ, по которому необходимо разбить строку. Если в качестве разделителя используется запятая, запишите ее в ' ' (одинарных кавычках).
Пример

Условие: #param_тип# = купить;цена;продажа #model# =KGE 36AL20R

Результат генерации: #model# #param_тип*!РазбитьПоСимволу(;)# = KGE 36AL20R купить, KGE 36AL20R цена, KGE 36AL20R продажа

Сцепить

Соединяет значения Аргументов, перечисленных через запятую.

ЦифраБуква

Ставит пробел в связке цифры и буквы.

Функция не содержит Аргументов.

Пример

Условие: #model# = w3240

Результат генерации: #model*!ЦифраБуква()# = w 3240

Логические

Если

Работает как одноименная функция в Excel.

В Аргумент 1 укажите условие, если оно выполняется, то выражение создается через функцию, которая указана в Аргумент 2. Если условие не выполняется, то на тег действует функция, которая указана в Аргумент 3.

Аргумент 1 Аргумент 2 Аргумент 3
Условие Действие при выполнении условия. Действие при невыполнении условия.
Аргумент 1 Аргумент 2 Аргумент 3
Условие Действие при выполнении условия. Действие при невыполнении условия.
Пример

Условие: vendor=Boschmodel=KGE 36AL20R

Результат генерации: #model*!Если(Содержит(Тег(vendor)),Сцепить(Тег(model)),Сцепить(Тег(vendor),,Тег(model)))#=Bosch KGE 36AL20R

Содержит

Работает как фильтр.

В Аргументах определяются:

  • Аргумент 1 — объект, который должен присутствовать в результате генерации.

  • Аргумент 2 и Аргумент 3 — минимальные и максимальные границы для количества совпадений.

  • Аргумент 4 и Аргумент 5 — границы непрерывной последовательности, в которой будет осуществляться поиск значений, соответствующих объекту из Аргумент 1.

Используйте функцию с Аргументом 1, с Аргументами 1-3 или с Аргументами 1-5.

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

Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
1 100 1 255
Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
1 100 1 255

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
все (любое) цифры кириллица латиница буквы значение (вводится вручную) тег Минимальное количество совпадений для Аргумент 1. Максимальное количество совпадений для Аргумент 1. Минимальный размер непрерывной последовательности для поиска совпадений. Максимальный размер непрерывной последовательности для поиска совпадений.
Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
все (любое) цифры кириллица латиница буквы значение (вводится вручную) тег Минимальное количество совпадений для Аргумент 1. Максимальное количество совпадений для Аргумент 1. Минимальный размер непрерывной последовательности для поиска совпадений. Максимальный размер непрерывной последовательности для поиска совпадений.
Пример

Условие: #model# = телевизор samsung U9000

Результат генерации: #model*РазбитьНаЧасти(),!Содержит('цифры',1,3)# = U9000, U9000 Телевизор, U9000 Samsung

НеСодержит

Работает как фильтр.

В Аргументах определяются:

  • Аргумент 1 — объект, который не должен присутствовать в результате генерации.

  • Аргумент 2 и Аргумент 3 — минимальные и максимальные границы для количества совпадений.

  • Аргумент 4 и Аргумент 5 — границы непрерывной последовательности, в которой будет осуществляться поиск значений, соответствующих объекту из Аргумент 1-3.

Используйте функцию с Аргументом 1, с Аргументами 1-3 или с Аргументами 1-5.

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

Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
1 100 1 255
Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
1 100 1 255

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
все (любое значение) цифры кириллица латиница буквы значение (вводится вручную) тег Минимальное количество совпадений для Аргумент 1. Максимальное количество совпадений для Аргумент 1. Минимальный размер непрерывной последовательности для поиска совпадений. Максимальный размер непрерывной последовательности для поиска совпадений.
Аргумент 1 Аргумент 2 Аргумент 3 Аргумент 4 Аргумент 5
все (любое значение) цифры кириллица латиница буквы значение (вводится вручную) тег Минимальное количество совпадений для Аргумент 1. Максимальное количество совпадений для Аргумент 1. Минимальный размер непрерывной последовательности для поиска совпадений. Максимальный размер непрерывной последовательности для поиска совпадений.
Пример

Условие: #model# = телевизор samsung 40F6400

Результат генерации: #model*!РазбитьНаЧасти(),!НеСодержит('буквы',1,1),!НеСодержит('кириллица')# = 40F6400 samsung

Ссылки

Регистр

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

БольшиеБуквы

Изменяет регистр всех символов в значении тега на заглавный.

Пример

Условие: #place# = Мхат

Результат генерации: #place*!БольшиеБуквы()# = МХАТ

ВсеСБольшойБуквы

Изменяет регистр всех первых символов в словах в значении тега на заглавный, все остальные символы пишутся в строчном регистре.

Пример

Условие: #name# = ЭЛЛИптический ТРЕнажер

Результат генерации: #typeprefix*!ВсеСБольшойБуквы()#=Эллиптический Тренажер

СБольшойБуквы

Изменяет регистр первого символа в первом слове в значении тега на заглавный, все остальные символы пишутся в строчном регистре.

Пример

Условие: #name# = ЭЛЛИптический ТРЕнажер

Результат генерации: #typeprefix*!СБольшойБуквы()#=Эллиптический тренажер

МаленькиеБуквы

Изменяет регистр всех символов в значении тега на строчный регистр.

Пример

Условие: #name# = ЭЛЛИптический ТРЕнажер

Результат генерации: #typeprefix*!МаленькиеБуквы()#=эллиптический тренажер

Замена

Заменяют содержимое тегов.

Замена

Меняет значение объекта, указанного в Аргумент 1, на значение из Аргумент 2.

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2
кириллица латиница цифры спецсимвол значение (вводится вручную) тег транслит раскладка значение тег
Аргумент 1 Аргумент 2
кириллица латиница цифры спецсимвол значение (вводится вручную) тег транслит раскладка значение тег
Пример 1

Условие: #typeprefix# = холодильник-морозильник #model# = Bosch JK848

Результат генерации: #typeprefix*!Замена(холодильник-морозильник,холодильник)# #model# = холодильник Bosch JK848


Замена
Пример 2

Условие: #typeprefix# = стиральные машины

Результат генерации: #typeprefix*!Замена(кириллица,транслит)# = stiralnye mashiny

РегулярноеВыражение

Действует по правилам функции regular.

Пример

Условие: #model# =KGE 36AL20R

Результат генерации: #model*!РегулярноеВыражение('([\D])(\d)','\1 \2'),!РегулярноеВыражение('(\d)([\D])','\1 \2')# = KGE 36 AL 20 R Действие данного регулярного выражения равносильно действию функции ЦифраБуква()


Регулярные выражения

Синонимы

Чтобы использовать функцию, подготовьте список синонимов.

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

В Аргумент 1 пропишите название списка, в котором содержится синоним для значения.

В Аргумент 2 укажите, в каком случае надо заменять слово из тега на синоним из списка:

  • целиком — замена нужна только при полном совпадении тега со значением. Например, если в списке синонимов есть строка Sony;Сони, то значение Sony будет заменено на Сони.

  • часть — замена нужна при совпадении части тега со значением из списка синонимов. Например, если в списке синонимов есть строка Sony;Сони, то значение Sony&Ericsson будет заменено на Сони&Ericsson.

    целиком и часть генерирует оба варианта (синонимичный и исходный) вне зависимости от использования ! в функции.

  • заменачасть и Заменацеликом. При использовании ! останется синоним без исходного варианта, но если синонима нет в списке, то останется исходный вариант слова. Без ! будет сгенерирован исходный вариант.

  • ПусточастьEmptypart и Пустоцеликом. Если есть результат применения функции Синонимы, то при ! исходное значение тега не выводится. Если нет результата применения функции, то при наличии ! или без него, исходное значение не выводится.

В Аргумент 3 указывается, что считать объектом для замены: всё слово целиком (от пробела до пробела) или часть этого слова:

  • частьслова — выбрано по умолчанию при добавлении функции Синонимы. Делает замену, даже если синоним является частью слова. Например, если в списке синонимов есть строка Eco;Эко, а слово в теге Ecoplast, то значение Eco будет заменено на Эко и в итоге получится Экоplast.

  • всёслово — делает замену, если синоним с исходным значением тега — все слово. Например, для строки Eco;Эко слово Eco в теге Ecoplast заменено на Эко не будет.

  • всёсловоцеликом — делает замену по словам, включая спецсимволы. Например, для строки Eco!;Эко слово Eco! в теге Ecoplast заменено на Эко не будет. А в теге Eco! Plast будет заменено на Эко Plast.

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2 Аргумент 3
Название списка синонимов. часть целиком заменачасть заменацеликом пусточасть пустоцеликом частьслова всёслово всёсловоцеликом
Аргумент 1 Аргумент 2 Аргумент 3
Название списка синонимов. часть целиком заменачасть заменацеликом пусточасть пустоцеликом частьслова всёслово всёсловоцеликом
Пример 1

Условие: #model# = культиватор husqvarna KAP 900 G Название списка синонимов - Садовая техника

Результат генерации: #model*Синонимы('Садовая техника','часть','частьслова')# = культиватор husqvarna KAP 900 G, купить культиватор хускварна кап 900 г


Синонимы
Пример 2

Условие: #model# = культиватор husqvarna KAP 900 G Название списка синонимов - Садовая техника

Результат генерации: #model*Синонимы('Садовая техника','часть','всеслово')# = культиватор husqvarna KAP 900 G


Синонимы

СтопСлова

Ставит знак + перед стоп-словами. Стоп-слова в Яндекс.Директе — это служебные части речи и местоимения, а также любые слова, не несущие дополнительного смысла.

Пример

Условие: #autor# = Сокол Елена #name# = где-то есть ты

Результат генерации: #autor# #name*!СтопСлова()# = Сокол Елена Где-то +есть +ты


Стоп-слова

Морфология

Используется для склонения слов.

Форма

Приводит значение в теге к заданному падежу и числу. Задайте падеж и число в Аргумент 1 и Аргумент 2.

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2
именительный родительный винительный дательный творительный предложный единственное множественное
Аргумент 1 Аргумент 2
именительный родительный винительный дательный творительный предложный единственное множественное
Пример 1

Условие: #typeprefix# = очиститель воздуха

Результат генерации: Много #typeprefix*Форма('родительный','множественное')# в наличии! = Много очистителей воздуха в наличии!

Пример 2

Условие: #region# = Москва и область

Результат генерации: Бесплатная доставка по #region*!Форма(дательный,единственное)# = Бесплатная доставка по Москве и области

Числительное

Добавляет к значению тега заданное слово, указанное в аргументах в той форме, которая соответствует числительному в значении тега.

Аргумент 1 Аргумент 2 Аргумент 3
Слово в именительном падеже в единственном числе. Слово в родительном падеже в единственном числе. Слово в родительном падеже во множественном числе.
Аргумент 1 Аргумент 2 Аргумент 3
Слово в именительном падеже в единственном числе. Слово в родительном падеже в единственном числе. Слово в родительном падеже во множественном числе.
Пример

Условие: #quantity# = 2230

Результат генерации: #quantity*!Числительное(модель,модели,моделей)# = 2230 моделей

Удаление

ДобавитьПустоту

Добавляет вариант генерации с пустым значением тега.

Пример

Условие: #name# = Венский Дом

Результат генерации: Жилой комплекс #name*ДобавитьПустоту()# = Жилой комплекс, Жилой комплекс Венский Дом

ОбрезатьПоСловам

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

Если указанное в Аргумент 2 число меньше длины первого слова, то первое слово может либо обрезаться по символам, либо остаться в первоначальном написании.

  • обрезать — обрезать первое слово по количеству символов.

  • пропускать — выражение не будет сгенерированно. Функция используется, чтобы уместить Заголовки, Тексты объявлений и Тексты дополнительных ссылок в ограничение системы.

Допустимые значения Аргументов представлены в таблице.

Аргумент 1 Аргумент 2
Максимальное количество символов. обрезать пропускать
Аргумент 1 Аргумент 2
Максимальное количество символов. обрезать пропускать
Пример

Условие: #name# = Don Diablo, Gorgon City, Matisse & Sadko

Результат генерации: #name*ОбрезатьПоСловам(33,'обрезать')# = Don Diablo, Gorgon City, Matisse

УбратьПовторы

Удаляет повторяющиеся объекты в значении тега.

Пример

Условие: #model# = KGE 36AL20R KGE

Результат генерации: #model*!УбратьПовторы()# = KGE 36AL20R

УбратьПробелы

Удаляет лишние пробелы: более одного пробела подряд, пробелы в начале и конце значения тега.

Пример

Условие: #name# = Преступление и Наказание

Результат генерации: Книга "#name*!УбратьПробелы()#" = Книга "Преступление и Наказание"

УбратьСпецсимволы

Все специальные символы в значении тега заменяются на пробел. Если нужно оставить какой-то из специальных символов, впишите его в Аргумент 1.

Аргумент 1
Специальные символы, которые не должны удаляться. Несколько специальных символов пишутся в ' ' и разделяются запятыми.
Аргумент 1
Специальные символы, которые не должны удаляться. Несколько специальных символов пишутся в ' ' и разделяются запятыми.
Пример 1

Условие: #name# = «Дожди&Связи»

Результат генерации: Концерт #name*!УбратьСпецсимволы()# = Концерт Дожди Связи

Пример 2

Условие: #place# = «Консерватория им.Чайковского»

Результат генерации: #place*!УбратьСпецсимволы('.')# = Консерватория им.Чайковского

УбратьФразуКороче

Удаляет фразу, суммарное количество символов в которой меньше или равно цифре, указанной в качестве аргумента.

Аргумент 1
Максимальное количество символов.
Аргумент 1
Максимальное количество символов.
Пример

Условие: #model# = Во фразе 20 символов

Результат генерации: #model*!УбратьФразуКороче(21)# = Пустое значение