Все об UTM-метах в Яндекс.Директ и Google Adwords

Чтобы повысить уровень продаж и привлечь новых покупателей, просто запустить рекламу недостаточно. Необходимо грамотно настроить ее, а затем анализировать результаты. В результате удастся выявить неэффективные объявления, отключить их и оставить только лучшие, тем самым оптимизировав бюджет. Для аналитики используют UTM метки для Google Adwords и для Яндекс.Директ. Это довольно эффективный инструмент. Однако необходимо заранее разобраться, как им пользоваться.

Подробнее о понятии

UTM-метки – это особые команды, позволяющие собрать максимальное количество информации об объявлении. Их вставляют в ссылку для рекламного объявления. Информация, которая была получена с помощью меток, становится доступна в Яндекс.Метрике и Google Аналитике. Сведения позволяют проанализировать действия пользователей и понять, насколько эффективна рекламная кампания. Данные, собранные с помощью меток, позволяют разработать грамотную стратегию продвижения.

Фактически метки в Google Adwords и в Яндекс.Директ представляют собой параметры, которые добавляются к адресу страницы. В результате система будет оповещать, откуда именно пришел пользователь. Он может кликнуть по баннеру, найти страницу по ключевому слову, попасть на нее со схожего запроса.

Зачем нужно использовать?

УТМ метки неразрывно связаны с системами аналитики. Поэтому получить информацию удастся только с их помощью. Если добавить метку и грамотно настроить объявление, можно узнать следующую информацию:

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

Параметры метки

У метки есть статистические и динамические параметры. Первый вид включает в себя значение, которое на момент формирования УТМ-метки было известно, и его можно указать точно. Статистические метки имеют следующий вид:

• utm_source (заполняется в обязательном порядке) — место, откуда пользователь пришел на сайт продавца;
• utm_medium (заполняется в обязательном порядке) — разновидность рекламы. Если метку используют для Яндекс.Директа;
• utm_campaign (заполняется в обязательном порядке) — рекламная кампания. Название должно быть понятным. Ее указывают латиницей;
• utm_content (дополнительный параметр) — ID-объявления. Эту информацию используют, если нужно выяснить, какое из используемых объявлений самое эффективное;
• utm_term (дополнительный параметр) — ключевой запрос. Это ключевая фраза, которая была использована при показе рекламы.

А вот динамические параметры могут меняться во время показа рекламных объявлений. В эту категорию включают, например, ключевые слова, по которому пользователь попал на сайт, где опубликована реклама и т. д. Составляя УТМ-метку, динамические параметры необходимо указывать в фигурных скобках:

• {source_type} — позволяет узнать тип сети. С помощью этой информации рекламодатель оценит, откуда пришел потенциальный клиент – из поисковика или с рекламной площадки;
• {position_type} – особенности клика.
  Так, он может прийти из гарантийного блока Директа или из спецразмещения. Иногда появляется значение None. Оно означает, что пользователь пришел из РСЯ;
• {keyword} — ключевое слово. Однако не стоит путать его со схожим статистическим показателем. Когда речь идет о динамических метках, здесь будет доступна информация, которую пользователь ввел в поиске перед тем, как попал на сайт;
• {addphrases} – применение дополнительных фраз, которые релевантны основному запросу;
• {campaign_id} — ID-рекламной кампании;
• {ad_id} – ID-объявления.

Как составить метку?

В 2021 году УТМ-метка считается одним из самых простых инструментов аналитики. Чтобы поставить ее, можно воспользоваться специальным сервисом. Такие компоновщики есть у Яндекс и Google. Дополнительно существуют системы по генерации, которые не привязаны к поисковикам. Для создания UTM меток в генераторе необходимо:

1. Открыть систему, после чего указать сайт, на который потенциальный клиент должен перейти в итоге.
2. Указать источник трафика. Это может быть Яндекс.Директ или Google Ads.
3. Указать уникальные параметры УТМ-меток.
4. Сгенерировать метку. Система автоматически предоставит ссылку.
5. Добавить УТМ-метку в объявление. Для этого необходимо зайти в личный кабинет рекламодателя, найти нужное объявление или создать его с нуля, начать редактирование и вставить ранее полученную ссылку в блок Ссылка на сайт.
6. Сохранить изменения.

Таким образом, УТМ-метки – прекрасный инструмент для аналитики. Он позволяет собирать больше данных и улучшать рекламную кампанию. Для генерирования меток можно использовать сторонние ресурсы.

UTM метки в Яндекс Директ, их создание, куда и как поставить, чтобы отслеживать

Сегодня не достаточно запустить сайт, рекламу, бизнес и получать прибыль. В большинстве ниш и регионов высокая конкуренция и дотошные клиенты. Выбор заказчика, поставщика на расстоянии одного клика, это никого не утомляет.

Если раньше приходилось искать исполнителя и поставщика, то сейчас почти везде в точности до наоборот. В бОльшинстве случаев выбирает клиент, а не поставщик, исполнитель. В интернете поиск осуществляется не выходя из дома, методом нажатия левой клавиши мыши. Что крайне просто, легко и быстро.

Приветствую!

Создавая бизнес, сайт, рекламу, вы не в вакууме. Когда человек что-то ищет, нажать в поиске сразу 5-10 ссылок, очень и очень просто. Посмотреть и тщательно изучить сразу 10 предложений легче простого. И вы будете для потенциального клиента всего на всего один из них, из 5, 10, 20 или даже из 50, всего лишь на расстоянии клика.

Всё должно отслеживаться и измеряться

Остаются вопросы. Как выделиться на фоне конкурентов? Как улучшить окупаемость рекламы в таких условиях?

Сегодня не про первое, а, скорее, про второе. Я писал ранее и про первое и про второе и про UTM-разметку. В предыдущей статье про UTM-метки довольно подробно расписано всё, что их касается: что это и для чего, генераторы меток, как их создать вручную и используя генераторы, из чего они состоят, как их поставить в Яндекс Директе в основную ссылку и быстрые ссылки.

В этой статье я не буду так подробно раскрывать эту тему и что-то будет идентично той статье. Кому-то нужно знать всё о теме, а кому-то только один-два беспокоящих вопроса. В данной статье это: где пригодится UTM-метки, их создание, куда и как поставить.

Чтобы улучшать окупаемость рекламы нужно видеть и знать точку А. То есть понимать, что вы имеете сейчас. И только видя текущую ситуацию вы можете двигаться вперёд не вслепую, а осознанно и точно.

Кроме точки, А нужно наметить точку Б, не оторванную от реальности и лучше точки А. Ну и последний момент, это вИдение что мешает, а что помогает на пути от одной точки к другой. Вскользь замечу, очень многие вещи сидят в голове у хозяина бизнеса, если нет ясности, то нет и правильного движения.

UTM-метки про точку А. В принципе, точку А в Яндекс Директе можно ясно увидеть и без меток. Достаточно настроить счётчик и цели Метрики, плюс коллтрекинг. Это для малого бизнеса. Если по-крупнее то, кроме Метрики и коллтрекинга, нужно CRM, выгрузки данных, сквозная аналитика и прочее.

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

UTM-метки

Где вам пригодятся UTM-метки?

• В Яндекс Директе и Яндекс Метрике. Вы можете отслеживать немного больше, чем без них. Хотя и не на много. Они на самом деле не так важны в Директе, потому как Яндекс проставляет свои метки и отслеживает всё, что нужно.
• На сайте. Вы можете поставить метки на внешние переходы со своего сайта или с чужого на свой.
• В любой интернет-рекламе. Вы сможете в Метрике видеть, вплоть, с какого объявления в какой соцсети или сайта пришёл тот или иной посетитель.
• Вы и ваши сотрудники могут делиться ссылкой на ваш сайт, например в переписке или в соцсетях или ещё где. Если указывать UTM метку, то вы будете знать откуда к вам пришли и достигли или нет определённой цели на сайте.

Например, если вы поставили баннер на каком-то сайте с UTM меткой, то при переходе на ваш сайт, вы таких посетителей можете видеть в Метрике. Соответственно видеть, такие вещи, как: отказы, глубину, конверсии и прочее.

Создание UTM-меток

UTM-метки просто добавляются к URL-адресу. Есть динамические и статичные метки. Каждая метка состоит из параметра и значения. Динамическое или статичное именно значение.

Статичная метка:

utm_medium=cpc

Динамическая метка:

utm_campaign={campaign_id}

Значение, которое в скобках, подставляется системой, например Яндекс Директом.

Укажу параметры со своими значениями для Яндекс Директа:

• utm_medium=cpc – тип трафика
• utm_source=yandex – источник перехода
• utm_campaign={campaign_id} – рекламная кампания
• utm_content={ad_id} – номер объявления
• utm_term={keyword} – ключевой запрос

Для медийной рекламы:

utm_medium=cpm

То же самое для любой рекламы, где плата идёт за показы.

Вся UTM-метка для Яндекс Директа:

http://ваш-сайт. рф/?utm_medium=cpc&utm_source=yandex&utm_campaign={campaign_id}&utm_content={ad_id}&utm_term={keyword}

Для применения, скопируйте себе в блокнот, поменяйте первую часть до знака «?» на адрес вашего сайта.

Куда их ставить в Директе

Идёте в редактирование объявления и находите «Ссылка на сайт / URL», вставляете приготовленный полный URL вместе с UTM меткой. Или, если ссылка уже есть, добавляете к ней метку. Всё.

Для быстрых ссылок, просто добавьте в конце метки:

=bs1_{ad_id}

Для первой — 1, для следующей — 2 и так далее.

Где отслеживать UTM-метки

Метки отслеживаются в Яндекс Метрике. Найти просто:

Нужный счётчик Метрики -> Отчёты -> Стандартные отчёты -> Источники -> Метки UTM

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

Итоги

Чтобы выжить сегодня в конкурентной борьбе нужно иметь ясность. Ясность даёт отслеживание, измерение и анализ текущей ситуации. В Яндексе есть достаточно для этого инструментов. Одним из инструментов отслеживания и сбора статистики являются UTM-метки. Они применяются, как в Директе, так и в любой другой интернет-рекламе, а также на сайте, на чужих сайтах и можно использовать даже в переписках и презентациях.

В Яндекс Директе Яндекс использует свою разметку, в дополнение к ней можно настраивать UTM-метки. В каких-то местах и способах такие метки могут быть лучшим или даже единственным способом отслеживания и сбора данных. UTM-метки также могут использоваться и в сквозной аналитике и в CRM-системах.

Используйте UTM-метки, имейте ясность и растите в доходах!

P.S.

Вы можете заниматься развитием своего бизнеса, собой, своей семьёй, а продвижение делегировать. Так вы сэкономите массу времени и денег, а ваш бизнес будет расти и расширяться.

Хотите получить в своё распоряжение систему привлечения клиентов под ключ?

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

Для этого нажмите кнопку и там заполните форму заявки:

Успешного продвижения!

Понравилась статья – поделись ею, жми кнопку любимой соцсети — Поделиться.
Получай все статьи и новости сайта в свой Вконтакте, Facebook или на электронную почту — подпишись на статьи сайта (справа).
Поделись своим мнением в комментариях, так статьи будут интереснее и ценней!

Поделитесь с друзьями:

Читайте в продолжение:

Зачем нужны UTM-метки: руководство по созданию и использованию — Мария Солодар

UTM-метки — это секретное оружие маркетолога. Если вы хотите узнать, какие каналы трафика, аудитории или рекламные кампании работают лучше всего, вам непременно нужно использовать этот инструмент.

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

Как понять эффективность каждого из них? Как оптимизировать рекламный бюджет и добиться большей отдачи? 

В этом вам поможет простой инструмент: UTM-метки. Давайте рассмотрим, зачем нужны метки, как их создавать и как они помогут вам повысить доход.

Что такое UTM-метки

UTM-метки — это код, который добавляется к адресу страницы и позволяет собирать данные о том, с какого ресурса или рекламного объявления пришел посетитель. 

Например, изначальная ссылка www.sumki_ot_dizainera.ru с метками выглядит следующим образом:

В эту ссылку включены 5 параметров. Давайте рассмотрим их на нашем примере:

1. utm_source=yandex: указывает на то, с какого канала пришел посетитель. В нашем случае ссылка будет отслеживать людей, пришедших с Яндекса.
2. utm_medium=banner: раскрывает способ получения или вид трафика. В данном примере посетители совершили целевое действие, кликнув на баннер.
3. utm_term=keyword: этот параметр дает задачу системе собирать ключевые слова, по которым человек вышел на нашу рекламу.
4. utm_content=test1: сообщает, что в данном случае трафик пришел по первому из двух вариантов A/B теста кампании.
5. utm_campaign=sumki_shopper: название рекламной кампании, о которой идет речь.

Campaign term и campaign content — необязательные характеристики. Благодаря им вы можете внести уточнения или получить дополнительную информацию, например, используя метку «keywords» для отслеживания ключевых слов.

Зачем нужны UTM-метки

• Продолжим рассматривать пример о рекламе сумок:
• Реклама у блогера стоила 30 000 и принесла 16 клиентов, т. е. один клиент стоил вам 1 875 р.
• На Яндекс Директ ушло 20 000, а клиентов пришло 20, затраты на привлечение каждого — 1 000 р.
• Наконец, в три объявления для таргетированной рекламы во ВКонтакте вы вложили 15 000 и получили 7 клиентов по 2 143 р.

Видно, что таргет не дал большой отдачи, а Яндекс Директ был настроен отлично. На это указывает ROI — главный показатель рентабельности воронки продаж, отображающий доход на 1 единицу инвестиций. Чем выше ROI, тем выгоднее вложение.

Но стоит ли в таком случае отказываться от работы с таргетированной рекламой?

Вы разместили три варианта таргетированой рекламы в ВКонтакте с одинаковым текстом, но разными картинками. Системы аналитики собрали все данные в один блок «ВКонтакте». Как же понять, какой из вариантов  рентабелен? 

Чтобы отследить трафик с каждого из трех объявлений, вы можете создать для них персональную UTM-метку. После завершения кампаний вам останется проанализировать данные и сравнить их эффективность. 

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

Благодаря меткам вы можете анализировать: 

• Каждый рекламный канал, призыв к действию или изображение.
• Ключевые слова, по которым пользователи попали на ваш сайт или объявление.
• A/B тесты, позволяющие сравнить эффективность разных версий кампании, как в примере с сумками. Чтобы анализ был точным, убедитесь, что запускаете одинаковое количество трафика с одинаковыми параметрами на каждое объявление.

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

Как создать UTM-метку и использовать в Google Adwords и Яндекс Директ

Создать метку можно либо вручную, либо с помощью генератора, например, Utmurl. 

В этом компоновщике вы легко сгенерируете и специальные ссылки для Яндекс Директа и Google Adwords. 

Настройте необходимые параметры и нажмите кнопку «Сгенерировать ссылку».

Интерфейс компоновщика Utmurl

Создайте новые рекламные кампании в Google Adwords, Яндекс Директе или других сервисах, используя созданную ссылку вместо обычной.  

На что обратить внимание при работе с UTM-метками

При создании ссылок обратите внимание на следующие нюансы:

• Лучше использовать маленькие буквы и нижнее подчеркивание вместо пробелов для избежания ошибок в регистрации и подсчете данных сервисами.
• Давайте кампаниям понятные вам названия, чтобы было проще найти их и проанализировать.
• Сохраняйте ссылки и параметры в таблице Excel.

Где отслеживать аналитику

Чтобы просмотреть аналитику в Яндексе, нужно перейти в меню Отчеты → Стандартные отчеты → Источники → Метки UTM.

Переход к меню Метки UTM в Яндекс.Метрике

Чтобы провести анализ UTM-меток в Google Analytics перейдите в Отчеты → Источники трафика → Кампании.

Отслеживание данных в Google Analytics

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

Если вы хотите узнать подробнее о самых эффективных инструментах и техниках, напрямую влияющих на прибыль, то приходите на бесплатный мастер-класс по интернет-маркетингу.  

До встречи!

Полная книга по AngularJS

Подробная, полная и актуальная книга по Angular. Станьте экспертом по AngularJS 1.x уже сегодня.

Перейти к пакетам

борьба с неполными и запутанными туториалами

• Собрать документы воедино сложно Документация не говорит сама за себя, один туториал говорит одно, а другой совсем другое.
• Гугление только заведет вас так далеко… Существует не так много хороших скринкастов или учебных пособий, которые учат, как максимизировать фреймворк. Некоторые учат основам, но ничего не показывает, как совместить все вместе?
• Время – деньги; не тратьте его впустую просеивая через блоги. Мало того, что нужно совершить несколько поездок по сообществу, чтобы получить общее представление, так еще и сложно найти нужный ответ.
• Что это за _____? Словарь иностранный, когда следует использовать директиву, фильтр или фабрику? А если серьезно, что означают $apply и $digest ?
• Как все это сочетается? Внутренние компоненты AngularJS 1. x немногочисленны и редки. Откуда вы знаете, как все это сочетается?
• Все еще не успеваю уложиться в сроки. У вас все еще есть работа, и изучение AngularJS не сделало ее более достижимой

Готовы освоить AngularJS 1.x?

• Что, если бы вы могли освоить всю структуру — с прочным фундаментом — за меньшее время, не бившись головой о стену? Представьте, как быстро вы могли бы работать, если бы знали передовой опыт и лучшие инструменты?
• Хватит тратить время на поиски и получите все необходимое для продуктивной работы в одном, хорошо организованном месте, с полными примерами для запуска вашего проекта без необходимости прибегать к бесконечным часам исследований.
• Вы узнаете то, что вам нужно знать, чтобы работать профессионально с ng-book: The Complete Book on AngularJS 1.x или получите свои деньги обратно .

Перейти к пакетам

Быстрое начало работы

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

Всеобъемлющие темы

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

Лучшие практики

Изучите лучшие практики AngularJS , такие как тестирование, организация кода и способы структурирования приложения для повышения производительности. Мы рассмотрим практические, общие примеры того, как реализовать полные компоненты ваших приложений.

Актуально

Книга постоянно пополняется последними советами и рекомендациями по Angular. Не беспокойтесь о том, что она устарела, в этой книге рассматривается последняя версия . Вы получите доступ ко всем обновлениям бесплатно.

Что в нем?

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

• Вы будете общаться с серверными службами по вашему выбору. Вы узнаете, как подключиться к API Google
• Как освоить маршрутизацию, маршрутизацию, маршрутизацию
• Подробный обзор наиболее распространенных опций XHR
• Как заставить Angular работать с этим надоедливым Internet Explorer
• Как напрямую обращаться к вашей серверной базе данных, такой как MongoDB
• И многое, многое другое. ..

Прочитать текущее оглавление

Что говорит сообщество…

Миско Хевери

Создатель AngularJS

Книга превратит вас из ничего не знающего в эксперта по Angular. Он охватывает практически все аспекты фреймворка Angular и глубоко погружается в причины ключевых решений фреймворка.

Dan Wahlin

Президент Wahlin Consulting и The Wahlin Group

В вашем распоряжении отличный ресурс в ng-book: The Complete Book on AngularJS , который сразу же поможет вам продуктивно работать. Примеры, представленные в этой книге, помогут вам быстро освоить фреймворк.

Патрик Стэплтон

Ведущий инженер по интерфейсу

Keychain Logistics

Эта книга является окончательным руководством по Angular. ng-book может рассказать о внутренностях и основах Angular, просто если вы спросите, что сложного в включении.

Эрик Тром

Инди-разработчик Ruby/Javascript

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

Слишком хорошо, чтобы быть правдой?

Возьмите образец главы и проверьте ее сами. Подпишитесь на нашу рассылку и получите образцы глав бесплатно! Вы будете получать электронные письма только о книге и обновлениях. Мы никогда не рассылаем спам, и от подписки легко отказаться.

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

Познакомьтесь с автором

Привет! Я Ари Лернер, автор, разработчик с более чем 20-летним опытом и соучредитель Fullstack.io. Я давно использую AngularJS и являюсь признанным экспертом в этой области.

Я являюсь совладельцем ng-newsletter, выступаю на конференциях, постоянно создаю контент по AngularJS, недавно выпустил Riding Rails с AngularJS и преподаю очных занятий в Hack Reactor.

Я постоянно говорю об AngularJS и многом другом. Ознакомьтесь с некоторыми из моих последних докладов и семинаров, таких как Angular для мобильных устройств, Усиление физических интерфейсов с помощью Angular на ngConf и Семинар: AngularJS для начинающих.

Получить сейчас

• Более 600 страниц профессионального содержания электронных книг Angular
• Полностью защищенная от DRM электронная книга в формате PDF, mobi и epub
• Изучите Angular изнутри
• Изучите правильный путь для создания приложений Angular
• Создавайте расширенные приложения Angular за считанные минуты
• Иметь полную библиотеку под рукой
• Код для каждого образца в книге, чтобы вы быстро приступили к работе

Базовый

Получить

• Более 600 страниц профессионального содержания электронных книг по Angular
• Полностью защищенная от DRM электронная книга в формате PDF, mobi и epub
• Изучите Angular изнутри
• Изучите правильный путь для создания приложений Angular
• Создавайте расширенные приложения Angular за считанные минуты
• Иметь полную библиотеку под рукой
• Код для каждого образца в книге, чтобы вы быстро приступили к работе
• Мини-книга , описывающая пошаговые инструкции по созданию примера приложения
• Полный код примера приложения
• 3 часа для начинающих Скринкаст Angular

Самые популярные

Получить

• Более 600 страниц профессионального содержания электронных книг Angular
• Полностью защищенная от DRM электронная книга в формате PDF, mobi и epub
• Ваша команда сможет создавать расширенные приложения Angular за считанные минуты
• Ваша команда изучит angular изнутри
• Ваша команда будет создавать приложения Angular, используя лучших практик с самого начала
• Подготовьте полную библиотеку для своей команды
• Код для каждого образца в книге, чтобы вы быстро приступили к работе
• Дополнительная электронная книга с пошаговыми инструкциями по созданию примера приложения
• Полный код примера приложения
• 3 часа для начинающих Скринкаст Angular
• Командная лицензия до 10 членов команды
• Услуга немедленного выставления счетов

Объединитесь и сэкономьте 200 долларов

Получите

---

Хотите версию для печати?

Печатная версия книги доступна на Amazon и Createspace.

Из-за авторских инструментов Amazon и законов физики мы не можем обновлять бумажные копии книги (хотя было бы очень круто, если бы могли). Кроме того, мы предоставляем обновления , а не через Amazon, поскольку у нас нет контроля над их издательской платформой.

Высокое качество и инициатива сообщества

В этой книге особое внимание уделяется высокому качеству и глубокой организации. Мы лично отвечаем на запросы о контенте и регулярно выпускаем обновления, чтобы работать с последними новостями сообщества Angular.

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

Как независимые авторы, мы выживаем только в том случае, если вы удовлетворены и только за счет создания максимально качественной книги по AngularJS.

Перейти к пакетам

Свяжитесь с нами

Если у вас есть какие-либо вопросы или проблемы, не стесняйтесь обращаться к нам по адресу fullstack. io.

Include Content by Tagged Regions

Директива include позволяет выбирать части файла для включения вместо включения всего файла. Используйте атрибут строк , чтобы включить отдельные строки или диапазон строк (по номеру строки). Используйте атрибут tags (или атрибут tag для единственного случая) для выбора строк, которые попадают между областями, помеченными пользовательскими тегами.

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

Области тегирования

Теги полезны, когда вы хотите определить определенные области файла для включения. Затем вы можете выбрать линии между границами директив include tag/end для включения с помощью теги атрибут.

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

Если в целевом файле есть строки с тегами, и вы просто хотите игнорировать эти строки, используйте атрибут tags , чтобы отфильтровать их. Дополнительные сведения см. в разделе Фильтрация тегов.

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

Пример 1. Тегированные фрагменты кода в файле с именем core.rb

 # tag::timings[]   (1)    (2) 
если тайминги
  тайминги.запись: читать
  тайминги.начало: разбор
конец
# end::times[]   (3)    (4) 
# тег::parse[]   (5) 
doc = (options[:parse] == false ? (Document. new строки, параметры) :
    (Документ.новые строки,опции).анализ)
Timings.record: анализировать тайминги
документ
# end::parse[]   (6)  

1	Чтобы указать начало отмеченной области, вставьте строку комментария в код.
2	Присвойте имя директиве тега . В этом примере тег называется times .
3	Вставьте еще одну строку комментария там, где вы хотите, чтобы отмеченная область заканчивалась.
4	Назначьте имя региона, который вы хотите терминировать, на конец директивы .
5	Это начало помеченного фрагмента с именем parse .
6	Это конец помеченного фрагмента с именем parse .

Директивы tag::[] и end::[] следует размещать после строкового комментария, как это определено языком исходного файла. Директивы должны также появиться в конец строки. В предыдущем примере мы выбрали префикс строк с решеткой ( # ), потому что это начало комментария строки в Ruby.

Для языков, которые имеют только комментарии с циркумфиксом, например XML, вы можете заключить директивы tag и end в соответствующие маркеры комментария с циркумфиксом. Например, в XML-файлах можно использовать и (пробелы вокруг тега обязательны).

В следующем примере тегированная область с именем parse выбирается директивой include .

Пример 2. Выбор фрагмента кода parse из документа

 [источник, ruby]
----
include::core. rb[tag=parse]   (1) 
---- 

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

В один и тот же файл можно включить несколько тегов.

Пример 3. Выбор таймингов и фрагментов кода разбора из документа

 [источник, ruby]
----
include::core.rb[tags=times;parse]
---- 

Также можно иметь мелкозернистые области с тегами внутри более крупных областей с тегами.

Например, если ваш включаемый файл имеет следующее содержимое:

 // tag::snippets[]
// тег::сниппет-а[]
фрагмент а
// конец::сниппет-а[]
// тег::сниппет-b[]
фрагмент б
// конец::сниппет-b[]
// конец::фрагменты[] 

И вы включаете этот файл, используя следующую директиву include:

 include::file-with-snippets. adoc[tag=snippets] 

Будут выбраны и отображены следующие строки:

 snippet a
snippet b 

Обратите внимание, что ни одна из строк с директивами тега не отображается.

Фильтрация тегов

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

 include::file-with-snippets.adoc[tag=!*] 

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

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

*

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

**

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

!

Отменить подстановочный знак или тег.

Двойной подстановочный знак всегда применяется первым, независимо от того, где он находится в списке. Если двойной подстановочный знак не инвертирован (т. е. ** ), его следует комбинировать только с исключениями (например, **;!foo ). Отрицательный двойной подстановочный знак (например, !** ), который не выбирает ни одной строки, обычно подразумевается в качестве отправной точки. Отрицательный одиночный подстановочный знак имеет разное значение в зависимости от того, стоит ли он перед именами тегов (например, !*;foo ) или хотя бы после одного имени тега (например, foo;!* ).

Предположим, у нас есть регион с тегом foo с вложенным регионом с тегом bar . Вот некоторые из перестановок, которые вы можете использовать (вместе с их подразумеваемыми полными формами):

**

Выбирает все строки в документе (кроме строк, содержащих директиву тега). (подразумевается **;* )

*

Выбирает все отмеченные области в документе. Не выбирает строки за пределами отмеченных областей. (подразумевается !**;* )

!*

Выбирает в документе только области вне тегов (т. е. области без тегов). (подразумевается **;!* )

фу

Выбирает только регионы с тегом foo . (подразумевается !**;foo )

foo;!bar

Выбирает только регионы с тегом foo , но исключает любые вложенные регионы с тегом bar . (подразумевается !**;foo;!bar )

foo;!*

Выбирает только регионы с тегом foo , но исключает любые вложенные регионы с тегами. (подразумевается !**;foo;!* )

*;!foo

Выбирает все регионы с тегами, но исключает регионы с тегами foo (вложенные или иные). (подразумевается !**;*;!foo )

!фу

Выбирает все строки в документе, кроме областей с тегом foo . (подразумевается **;!foo )

!foo;!bar

Выбирает все строки в документе, кроме областей с тегами foo или bar . (подразумевается **;!foo;!bar )

!*;фу

Выбирает области в документе за пределами тегов (т. е. непомеченные области) и внутри областей с тегами foo , за исключением любых вложенных областей с тегами. Чтобы включить вложенные области с тегами, каждая из них должна быть явно названа. (подразумевается **;!*;foo )

Если фильтр начинается с инвертированного тега или одного подстановочного знака, это означает, что шаблон начинается с ** . Исключение, которому не предшествует включение, неявно начинается с выбора всех строк, не содержащих директиву тега. В противном случае это означает, что шаблон начинается с !** . Ведущее включение неявно начинается с отсутствия выбора строк.

Справочная директива

  Показать все 

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

Выход директивы Reference использует свойство HTML правило, связанное с этим свойством. Например, если Правило свойства HTML свойства (указанное в Поток свойств поле формы свойств) содержит код HTML для поля выбора, свойство отображает как окно выбора. В нестандартных ситуациях вы можете переопределить вывод с использованием варианта директивы Reference.

Эквивалент JSP

Тег страницы JavaServer pega:reference обеспечивает функционально идентичные возможности. См. теги JSP — ссылка.

  Простые форматы

Показать значение свойства

Для отображения значения Single Value свойство, которое находится на главной странице:

{. мое свойство }

Чтобы отобразить значение свойства на другой странице:

{ myPage . мое свойство }

myProperty ( mySubscript )}

Разрешить пользователю вводить значение

Разрешить пользователю обновлять или вводить значение для Single Value , используйте свойство ВВОД ключевое слово. Для ясности добавьте необязательный ключевое слово AS или ключевое слово AS и знак равенства. Эти три примера эквивалентны:

{. myProperty ВВОД}
{. myProperty КАК ВХОД}
{. myProperty AS = INPUT}

Вставка значения параметров действия

Используйте ключевое слово Param для идентификации действия значение параметра.

{Парам. myParameter }

  Полный синтаксис

В представлении синтаксиса ниже:

• Символы квадратных скобок [ и ] определяют необязательные части директивы. Делать не вводите скобки.
• Символы фигурных скобок { и } отметить начало и конец директива.
• Замените любой текст, выделенный курсивом, выбранным вами значением того типа.

{[ССЫЛКА][[ страница ].] свойство [( индекс )][КАК [=]][ option ]}

Точка перед свойством не является обязательной, если страница не указана. Вариант является одним из эти необязательные ключевые слова. Если вы опустите какое-либо ключевое слово, обработка предполагает ДИСПЛЕЙ . ценности. (можно расшифровать ключевое слово или используйте любой префикс, например I , В или INP для INPUT .)

908:50

Это ключевое слово указывает системе использовать HTML Правило свойства в режиме только для чтения, определяемое как ! $режим-ввод . Потоковая обработка добавляет один пробел перед значением и один пробел после Значение.

В выпусках до V5.4, ключевое слово директивы $mode-display указан выход только для чтения. Ключевое слово $mode-display устарело для новая разработка; вместо этого используйте !mode-input .

Опция	Когда использовать
ДИСПЛЕЙ
ВХОД	Добавьте INPUT , чтобы представить недвижимость в режим обновления, чтобы пользователь мог ввести или выбрать стоимость за недвижимость. Например: {.myText ВВОД} Если правило свойств HTML, указанное в файле myText определение свойства указывает системе отображать свойство в виде текстового поля в режиме обновления, оно отображает myText как текстовое поле.
ЛИТЕРАЛЬНЫЙ	Если значением свойства является фрагмент текста HTML, и должен обрабатываться как HTML, добавьте LITERAL Опция директивы Reference. Например: {.myText ЛИТЕРАЛ}
ТЕКСТ	Используйте этот параметр для текстовых полей. Добавить Опция TEXT для директивы Reference, если свойство определяет текстовую область, и вы хотите Тег будет преобразован в новую строку персонаж.
БЛОК	Используйте этот параметр для отображения введенного значения. в текстовую область ввода в том же формате, что и введенный (но без окружающего текстового поля.) Добавить параметр БЛОК в ссылку директива для обработки свойства для отображения тегов HTML без их интерпретации. Если исходный текст содержит символ новой строки, система заменяет его тегом . Это также выполняет преобразования, перечисленные для NORMAL ключевое слово, чтобы точное значение свойство отображается, даже если оно включает символы, которые обычно интерпретируются как HTML элементы.
ПОТОК	Используйте этот параметр, чтобы указать системе заменить разрывы строк с помощью с последующим одним пробелом персонаж. Это может быть полезно в ситуациях, когда длина строки не подходит. Добавить параметр STREAM в ссылку директива, предписывающая системе обрабатывать свойство для отображения тегов HTML без интерпретации их. Кроме того, система заменяет каждую новую строку символ и с пробелом. Он также выполняет преобразования, перечисленные для NORMAL ключевое слово, так что точное значение свойства отображается, даже если он содержит символы, обычно интерпретируются как элементы HTML.
НОРМАЛЬНЫЙ	Используйте этот параметр для преобразования <,>, & и * символов в соответствующие объекты HTML ( < > , &ампер; и * соответственно), чтобы они правильно отображались в результирующий дисплей или вывод. Ключевое слово NORMAL также приводит к обработка для игнорирования упомянутого правила свойства HTML в определении свойства и не размещает никаких символ пробела до и после значения.

  Переопределение HTML, связанного с имущество

Чтобы значение свойства отображалось по-разному в разные HTML-страницы или разные приложения, вы можете переопределить правило свойств HTML, обычно связанное с имущество.

Используется специальный синтаксис:

{[ССЫЛКА][[ страница ].] свойство [( индекс )] режим [ =] имя-потока }

где режим это ВХОД или DISPLAY и имя-потока идентифицирует Правило свойства HTML.

Для этого:

1. Найдите или создайте второе правило свойства HTML.
2. Решите, должно ли значение свойства отображаться в поле ввода или только отображаться.
3. Используйте либо ключевое слово INPUT , либо ДИСПЛЕЙ ключевое слово.

Чтобы это значение отображалось в поле ввода (изменяемое), используйте ключевое слово INPUT с именем HTML Правило свойств (тип правила Rule-HTML-Property), которое переопределить тот, который указан в правиле свойств.

Чтобы значение отображалось только для отображения, используйте ДИСПЛЕЙ 9Ключевое слово 0027 с названием HTML Правило свойства, которое должно переопределить правило, указанное в правило собственности.