Типы функций

ВзятьДо

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

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

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

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

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

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

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

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

Пример 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.

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

Пример

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

Результат генерации: #name*ВзятьПосле(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

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

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

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

Пример

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

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

Сцепить

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

ЦифраБуква

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

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

Пример

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

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

Если

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

В Аргумент 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.

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

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

Пример

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

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

НеСодержит

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

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

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

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

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

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

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

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

Пример

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

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

КодироватьДляСсылки

Перекодирует кириллические и специальные символы в URL.

Функция задается в поле Выражение для URL на вкладке Ссылки и в строках для дополнительных ссылок.

Пример

Условие: #url# = http://site.ru/ #typeprefix# = утюги

Результат генерации: #url#?utm_campaign=#typeprefix*!КодироватьДляСсылки()#=http://site.ru/?utm_campaign=%D1%83%D1%82%D1%8E%D0%B3%D0%B8

ПрисоединитьUtm

Добавляет к ссылке знак ?,если в исходном URL:

• Не встречаются ? и &.

• Уже использовался знак ?.

Исключение составляют случаи, когда знаки ? или & являются последними символами в URL.

Используйте, если:

• Необходимо прописать значение utm самостоятельно.

• Неизвестно как формируются URL в исходном файле.

• Клиент может изменить значения ссылок.

Функция задается в поле Выражение для URL на вкладке Ссылки и в строках для дополнительных ссылок.

Пример 1

Условие: #url# = http://site.ru/search/index.php/?q=direct/

Результат генерации: #url*ПрисоединитьUtm()# = http://site.ru/search/index.php/?q=direct/&

Пример 2

Условие: #url# = http://site.ru/search/index.php/?

Результат генерации: #url*ПрисоединитьUtm()# = http://site.ru/search/index.php/?

УдалитьUtm

Удаляет из ссылок utm-метку, которая передается в исходном файле.

Используйте функцию, чтобы присвоить ссылке новые метки или воспользоваться автоматической меткой К50:Генератора.

Функция задается в поле Выражение для URL на вкладке Ссылки и в строках для дополнительных ссылок.

Пример 1

Условие: #url# = http://site.ru/?utm_source=yandex.market&utm_medium=cpc&utm_campaign=bosch

Результат генерации: #url*!УдалитьUtm()#=http://site.ru/

Пример 2

Условие: #url# = http://site.ru/?utm_source=yandex.market&utm_medium=cpc&utm_campaign=bosch

Результат генерации: #url*!УдалитьUtm()#?utm_source=yandex.direct = http://site.ru/?utm_source=yandex.direct

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Пример

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

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

Замена

Меняет значение объекта, указанного в Аргумент 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

Условие: #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

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

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

Пример 2

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

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

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

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

Пример

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

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

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

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

Пример

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

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

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

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

Если указанное в Аргумент 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

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

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

Пример 2

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

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

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

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

Пример

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

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