Как добавить вид деятельности ип: ОКВЭД 2021 с расшифровкой по видам деятельности

Содержание

Как изменить код вида деятельности ИП и ООО

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

Из статьи вы узнаете, в каких ситуациях необходимо менять коды ОКВЭД, в чем преимущества корректных данных, как внести изменения ИП и ООО в систему — пошаговая инструкция.

В какой ситуации необходимо внести изменения кодов ОКВЭД

  • Ваша сфера деятельности изменилась и совсем не соответствует данным, прописанным в выписке ЕГРЮЛ/ЕГРИП.

  • Если вы забыли, какой именно код писали во время оформления бизнеса, то запросите самостоятельно выписку на портале ФНС.

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

В чем преимущества корректных кодов ОКВЭД

Право на льготные условия. Государство может снижать налоговую ставку для УСН и ПСН. Ваш вид деятельности должен соответствовать данным в выписке, чтобы претендовать на льготы.

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

Риск блокировки счета. Одним из критериев банковского контроля является совпадение назначения перевода коду ОКВЭД. Проверке подлежат как компания, так и поставщик. Если деньги отправляются на производство одежды, а основной код ОКВЭД — это продажа вещей, то вероятность блокировки счета увеличивается.

Экономия на страховых взносах. Процент страхового взноса зависит напрямую от кода основного вида деятельности. Например, в выписке указан код 14 «Производство одежды», сумма страхового взноса — 0,4 %, а компания по факту занимается торговлей кожаными изделиями, по этому виду деятельности процент ниже — 0,2 %. Значит, фирма постоянно переплачивает деньги.

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

Также несоответствие фактического вида деятельности с документами может насторожить контрагентов и сорвать важную сделку. Чтобы этого не допустить, актуализируйте код ОКВЭД.

Как ИП изменить код ОКВЭД

  1. Написать заявление

Заполнить бланк нужно по форме Р24001, обязательные страницы для заполнения — Д и Е. Напишите заявление на бумаге или заполните электронно прямо в личном кабинете на портале ФНС.

На бланке Д:

На первой странице указывается код ОКВЭД, по которому вы будете работать.

На второй странице — код ОКВЭД, который планируете исключить.

На бланке Е ставится ваша подпись и указывается ФИО, но это нужно сделать либо при сотруднике ФНС, если пришли самостоятельно в налоговую, либо при нотариусе, если будете отправлять документ курьером. Подписывать бланк не требуется, если составляете заявление электронно. Это бесплатная услуга, оплачивать госпошлину не нужно.

  1. Получите ответ

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

Как ООО изменить код ОКВЭД 

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

Как изменить код без устава

  1. Напишите заявление по форме Р13014, на странице К укажите:

  • На первом листе — добавление кода ОКВЭД, по которому вы будете работать.

  • На втором — смена кода ОКВЭД, который планируете убрать.

На странице Н проставляются данные руководителя и выбирается значение 1. Ставить свою подпись нужно либо при сотруднике ФНС, если пришли лично в налоговую, либо при нотариусе, если отправляете документ курьером. Подписывать бланк не требуется, если формируете заявление электронно.

  1. Получите ответ

Изменения будут внесены в систему налоговым органом, срок — 5 рабочих дней. На следующий день вы получите письмо на электронную почту с новой выпиской ЕГРИП или можете лично забрать документ в налоговой службе.

Как поменять код с изменением устава

  1. Заполните документ-основание

Подготовьте документы: 

  • Решение единственного участника о смене кодов ОКВЭД, если компанией руководит один человек. 

  • Протокол общего собрания участников, если руководителей несколько.

  1. Внесите правки в устав

Добавить в устав нужный вид деятельности можно с помощью двух способов:

  • Переписать и оформить новый устав.

  • В отдельном документе указать изменения в уставе, составить документ-дополнение.

      3. Заполните заявление

Напишите по форме Р13014 и укажите данные таким же образом, как при оформлении документов без устава.

      4. Подайте заявление в налоговую

Оплатить госпошлину необходимо, если вы лично приедете в налоговую. При оформлении в онлайн, через МФЦ или нотариуса госпошлину оплачивать не требуется.
Закажите электронную подпись для передачи отчетности в ФНС, отправки данных о компании на государственных порталах, подписания документов внутри компании и с контрагентами в электронном документообороте. Подробнее о тарифах и услугах можно узнать по ссылке.

Как добавить новый вид деятельности ИП: форма Р24001, инструкция

Часто при ведении бизнеса предприниматель стремится расширить свою деятельность или изменить ее направление. Однако неоформленное занятие еще одним видом деятельности грозит штрафом и проблемами с налоговой. Как добавить новый вид деятельности ИП?

Коды ОКВЭД

Направления, по которым предприниматель может работать, отражаются при регистрации ИП. Предусмотрительные предприниматели часто выбирают несколько видов экономической деятельности, тем более что ограничения на количество зарегистрированных кодов ОКВЭД не предусмотрены. Однако следует помнить, что фиксировать при регистрации больше 30 кодов не рекомендуется. Лучше не детализировать каждое направление бизнеса, а вносить код целой группы.

Будьте внимательны! С 2016 года в действие вступил новый ОКВЭД. Как быть тем, кто фиксировал старые коды? Самостоятельной перекодировкой заниматься не нужно. Это сделают работники налоговой инспекции.

Следует помнить, что фиксировать при регистрации больше 30 кодов не рекомендуется.

Итак, с чего начать? Если в документах ваши коды ОКВЭД не отражают дополнительный вид деятельности, который вы собираетесь развивать в будущем, необходимо выбрать из классификатора нужное направление и обозначить его в специальной форме.

Как изменить код

Следующим этапом внесения поправок будет заполнение формы Р24001. Любые изменения в ЕГРИП необходимо подтверждать заявлением в соответствии с требованиями к оформлению документов.

Оформить новое направление деятельности ИП несложно – необходимо правильно указать нужную информацию.

Инструкция для заполнения формы Р24001:

  1. Вносятся данные в графы листа с пометкой 001.
  2. Страницы А, Д и Г предназначены для заполнения иностранными гражданами.
  3. Страница Б: данные вносятся физическими лицами в случае изменения гражданства (при отсутствии постоянной прописки на территории РФ).
  4. Страница Е включает 2 блока: в первом указываются коды ОКВЭД, которые добавляются, во втором – те, которые следует исключить.
  5. Страница Ж. Здесь нужно указать свои полные данные, контакты, способ получения документов и ставить подпись.
  6. Информация в остальные графы вносится нотариусом или работником налоговой службы.

Подача документов

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

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

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

Корректировка кодов ОКВЭД производится бесплатно. Но придется оплатить услуги нотариуса, так как заявление на изменение кодов нужно заверить.

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

Виды деятельности ООО, ИП. Выбор видов деятельности

Необходимо подобрать нужные виды деятельности из ОКВЭД?

Обращайтесь к нам! Мы поможем сделать правильный выбор!

Бесплатный подбор кодов ОКВЭД при регистрации ООО или ИП!

Проведем регистрацию новых видов деятельности в ЕГРЮЛ и ЕГРИП.

Ответим на все вопросы!

Звоните прямо сейчас: (495) 507-49-56

Регистрация фирмы (ООО, АО) или ИП (индивидуального предпринимателя) начинается с выбора вида экономической деятельности. В России существует Общероссийский классификатор видов экономической деятельности (ОКВЭД), из которого при регистрации юридических лиц и индивидуальных предпринимателей необходимо подобрать коды видов предпринимательской деятельности (коды ОКВЭД). В 2021 году применяется ОКВЭД 2.

Сколько видов экономической деятельности можно указать при регистрации ООО или ИП? Чтобы зарегистрировать фирму или ИП необходимо указать основной вид деятельности из ОКВЭД. Юридические лица и предприниматели могут заниматься несколькими видами деятельности. Ограничений по видам деятельности практически нет, за исключением отдельных видов предпринимательской деятельности. Например, существует ограничение в видах деятельности частных охранных организаций (ЧОО). Так, ЧОО могут заниматься только охранной деятельностью, а такие виды дополнительной деятельности как оптовая или розничная торговля у ЧОО невозможны. Таким образом, стандартный набор видов деятельности для фирмы или ИП может выглядеть следующим образом:

Основной вид деятельности:

Код ОКВЭД 47.19.1

Торговля розничная большим товарным ассортиментом с преобладанием непродовольственных товаров в неспециализированных магазинах.

Дополнительные виды деятельности:

47.24

Торговля розничная хлебом и хлебобулочными изделиями и кондитерскими изделиями в специализированных магазинах

47.24.1

Торговля розничная хлебом и хлебобулочными изделиями в специализированных магазинах

47.24.2

Торговля розничная кондитерскими изделиями в специализированных магазинах

47.24.21

Торговля розничная мучными кондитерскими изделиями в специализированных магазинах

47.24.22

Торговля розничная кондитерскими изделиями, включая шоколад, в специализированных магазинах.

Этот список видов деятельности для ООО и ИП можно продолжать.

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

Необходимо понимать, что можно указать видов деятельности больше, чем фирма или ИП будет заниматься, предусмотрев на будущее возможные изменения в бизнесе. Никто не может обязать фирму или ИП заниматься выбранными видами деятельности. В любой момент можно произвести внесение изменений в ЕГРЮЛ (единый государственный реестр юридических лиц) и поменять виды экономической деятельности (ОКВЭД), добавить новые коды ОКВЭД или исключить имеющиеся виды деятельности. Изменения видов деятельности в настоящее время вносятся без оплаты госпошлины.

Виды деятельности организаций указываются в Уставе компании, в выписке из реестра, а также в информационном письме Госкомстата. Виды деятельности ИП указываются только в выписке из ЕГРИП (единого государственного реестра индивидуальных предпринимателей) и в информационном письме Госкомстата.

Самый распространенный вопрос при выборе видов деятельности является вопрос о том, влияет ли количество видов деятельности на налогообложение? Увеличатся ли налоги при увеличении видов деятельности фирмы или ИП?

Подбор видов деятельности на УСН или общей системе (количество выбранных видов деятельности при регистрации юридических лиц и предпринимателей) не отражается на налоговой базе, и, следовательно, уплата налогов (сумма налога) не зависит от количества видов экономической деятельности (кодов ОКВЭД). Подбор видов деятельности для ЕНВД или патентной системы должен быть более внимательным, так как эти системы налогообложения вплотную привязаны к видам деятельности, но дополнительное количество неиспользуемых ОКВЭД для ЕНВД или патентной системы на налогообложение не влияет.

На что стоит обратить внимание при выборе видов деятельности из ОКВЭД? Основной код ОКВЭД повлияет на ставку по травматизму и может увеличить ее во много раз. Поэтому, не забываем подтверждать основной вид деятельности в ФСС ежегодно, а также основной вид деятельности должен быть указан как основной, а не дополнительный. Во время распространения коронавирусной инфекции код ОКВЭД играл большую роль при назначении помощи предпринимателям. Те компании и предприниматели, у которых код ОКВЭД был указан правильно, смогли получить помощь от государства.

Еще одним часто задаваемым вопросом является вопрос о том, можно ли в уставе указывать виды деятельности, подлежащие лицензированию или нет, если у фирмы нет лицензии или получение лицензии по этим видам деятельности не планируется в ближайшее время? Ответ: можно. В Уставе предприятия (конечно, кроме предприятий с особыми уставными задачами) можно указать как лицензируемые, так и не подлежащие лицензированию виды деятельности.

Выбрать вид предпринимательской деятельности из ОКВЭД вам всегда помогут наши юристы. Подбор видов экономической деятельности для ООО, АО, ПАО или ИП в нашей компании – бесплатный. Мы также помогаем изменить коды ОКВЭД в ЕГРЮЛ (добавить, удалить, поменять вид деятельности), получить коды статистики из Госкомстата. При необходимости, мы также поможем внести изменения в учредительные документы юридических лиц (Устав предприятия) с целью смены видов деятельности предприятий и организаций.

Виды оквэд ип \ Акты, образцы, формы, договоры \ Консультант Плюс

]]>

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

Судебная практика: Виды оквэд ип Открыть документ в вашей системе КонсультантПлюс:
Подборка судебных решений за 2019 год: Статья 5 «Организации, осуществляющие операции с денежными средствами или иным имуществом» Федерального закона «О противодействии легализации (отмыванию) доходов, полученных преступным путем, и финансированию терроризма»
(Р.Б. Касенов)Как видно из буквального содержания ст. 5 Федерального закона от 07.08.2001 N 115-ФЗ и Постановления Правительства РФ от 30.06.2012 N 667, правила внутреннего контроля разрабатываются индивидуальными предпринимателями, именно оказывающими названные посреднические услуги, что не является равнозначным требованием ко всем индивидуальным предпринимателям, только указавшим такой вид деятельности в качестве основной (код ОКВЭД 68.31), но фактически не осуществляющим эту деятельность. В связи с вышеизложенным под оказанием лицом посреднических услуг при осуществлении сделок купли-продажи недвижимого имущества в контексте ст. 5 Закона N 115-ФЗ следует понимать такие виды посредничества, когда лицо выступает от имени и по поручению участника сделки с недвижимым имуществом, участвует в такой сделке и, таким образом, осуществляет подконтрольные операции с денежными средствами или названным имуществом. Судом установлено, что операции с имуществом, подлежащим контролю в соответствии с Законом N 115-ФЗ, а также с денежными средствами (при приобретении гражданами в личную собственность квартир) непосредственно предпринимателем не производились; стороной в сделках предприниматель при совершении действий на основании выданной агентом доверенности не являлся, услуги носили консультационный и сопроводительный характер, что в конкретном случае признано судом как деятельность, не относящаяся к посредническим услугам в том смысле, как это предусмотрено ст. 5 Закона N 115-ФЗ. Таким образом, суд удовлетворил требования о признании незаконными и отмене постановлений о привлечении к административной ответственности.

Статьи, комментарии, ответы на вопросы: Виды оквэд ип

Нормативные акты: Виды оквэд ип Федеральный закон от 08.08.2001 N 129-ФЗ
(ред. от 02.07.2021)
«О государственной регистрации юридических лиц и индивидуальных предпринимателей»
(с изм. и доп., вступ. в силу с 25.08.2021)5. Не допускается внесение в единый государственный реестр индивидуальных предпринимателей изменений, касающихся сведений об индивидуальном предпринимателе, связанных с изменением кодов по Общероссийскому классификатору видов экономической деятельности, в случае, если индивидуальный предприниматель намерен осуществлять отдельные виды деятельности, указанные в подпункте «в» пункта 1 настоящей статьи, и имеет или имел судимость, подвергался уголовному преследованию (за исключением случаев, если уголовное преследование в отношении данного индивидуального предпринимателя прекращено по реабилитирующим основаниям) за совершение преступления против жизни и здоровья, свободы, чести и достоинства личности (за исключением незаконной госпитализации в медицинскую организацию, оказывающую психиатрическую помощь в стационарных условиях, и клеветы), половой неприкосновенности и половой свободы личности, против семьи и несовершеннолетних, здоровья населения и общественной нравственности, основ конституционного строя и безопасности государства, мира и безопасности человечества, общественной безопасности либо имеет неснятую или непогашенную судимость за иные умышленные тяжкие и особо тяжкие преступления.

зачем нужны и как выбрать

Определяем основной вид деятельности — он приносит больше всего прибыли и может быть только один.

Для регистрации указываем наиболее развернутый вид деятельности — в коде должно быть от четырёх цифр. Все подгруппы в него включаются автоматически. Если подходит код из двух или трех цифр (то есть весь класс), необходимо указать отдельно каждую группу этого класса.

Подбираем в классификаторе соответствующий код ОКВЭД для обучения онлайн:

85.41 — Образование дополнительное детей и взрослых

Или уточняем:

85.41.2 — Образование в области культуры (предоставление обучения в сфере искусств, драмы и музыки в качестве хобби, для отдыха и в целях саморазвития).

85.41.1 — Образование в области спорта и отдыха (занятие спортом, групповые или индивидуальные, включая занятия в спортивных лагерях и школах, в т. ч. обучение боевым искусствам и йоге).

85.41.9 — Образование дополнительное детей и взрослых прочее, не включенное в другие группировки.

Сюда входят:

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

Также можно рассмотреть основной код, связанный с консультационными услугами:

62.02 — Деятельность консультативная и работы в области компьютерных технологий.

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

69.10 — Деятельность в области права.

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

70.22 — Консультирование по вопросам коммерческой деятельности и управления.

74.90.4 — Предоставление консультационных услуг в области сельского хозяйства.

74.90.5 — Предоставление консультационных услуг в области экологии.

74.90.6 — Предоставление прочих технических консультаций, деятельность консультантов, кроме архитекторов, проектировщиков и консультантов по управлению.

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

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

Для эксклюзивных услуг есть универсальный код:

96.09 — Предоставление прочих персональных услуг, не включенных в другие группировки.

Важно! Основной код ОКВЭД ООО подтверждают каждый год. В противном случае ФСС посчитает взносы по максимальному тарифу. ИП ничего подтверждать не нужно.

Работа с фильтрами и запросами действий Cloud App Security

  • 7 минут на чтение

В этой статье

В этой статье представлены описания и инструкции для фильтров и запросов действий Cloud App Security.

Фильтры активности

Ниже приведен список применяемых фильтров действий.Большинство фильтров поддерживают несколько значений, а также НЕ предоставляют вам мощный инструмент для создания политики.

  • Идентификатор активности — поиск только определенных действий по их идентификатору. Этот фильтр полезен, когда вы подключаете Microsoft Cloud App Security к SIEM (с помощью агента SIEM) и хотите дополнительно исследовать предупреждения на портале Cloud App Security.

  • Объекты деятельности — поиск объектов, над которыми выполнялось действие. Этот фильтр применяется к объектам файла, папки, пользователя или приложения.

    • Идентификатор объекта действия — идентификатор объекта (файла, папки, пользователя или приложения).
    • Элемент — позволяет выполнять поиск по имени или идентификатору любого объекта деятельности (например: имена пользователей, файлы, параметры, сайты). Для фильтра Элемент действия вы можете выбрать, хотите ли вы фильтровать элементы, которые содержат , Равно или Начинается с конкретного элемента.
  • Тип активности — поиск активности приложения.

  • Административная деятельность — Поиск только административной деятельности.

  • Идентификатор оповещения — поиск по идентификатору оповещения.

  • Приложение — поиск действий только в определенных приложениях.

  • Приложенное действие — Выполнен поиск по действию управления: Заблокировано, Обойти прокси, Расшифровано, Зашифровано, Ошибка шифрования, Никаких действий.

  • Дата — дата, когда произошло действие. Фильтр поддерживает даты до / после и диапазон дат.

  • Тег устройства — поиск по , совместимому с Intune , Hybrid Azure AD присоединился к или Действительный сертификат клиента .

  • Тип устройства — поиск только действий, которые были выполнены с использованием определенного типа устройства. Например, выполните поиск по всем занятиям с мобильных устройств, ПК или планшетов.

  • Файлы и папки — поиск файлов и папок, с которыми выполнялось действие.

    • Идентификатор файла — позволяет выполнять поиск по идентификатору файла, с которым было выполнено действие.
    • Имя — Фильтры по именам файлов или папок. Вы можете выбрать, будет ли имя оканчиваться на , равно или начинается с , ваше значение поиска.
    • Определенные файлы или папки — позволяет включать или исключать определенные файлы или папки. При выборе файлов или папок вы можете отфильтровать список по App , Owner или частичному File Name .
  • IP-адрес — необработанный IP-адрес, категория или тег, с которого было выполнено действие.

    • Необработанный IP-адрес — позволяет искать действия, которые выполнялись на необработанных IP-адресах или с их помощью. Необработанные IP-адреса могут быть равными, не равными, начинаться или не начинаться с определенной последовательности.
    • IP-категория — категория IP-адреса, с которого было выполнено действие, например, все действия из диапазона административных IP-адресов. Категории необходимо настроить для включения соответствующих IP-адресов, за исключением категории «Рискованный», которая предварительно настроена и включает два IP-тега — анонимный прокси и Tor.Чтобы узнать, как настроить категории IP, см. Организуйте данные в соответствии с вашими потребностями.
    • IP-тег — тег IP-адреса, с которого было выполнено действие, например, все действия с IP-адресов анонимного прокси. Cloud App Security создает набор встроенных IP-тегов, которые нельзя настроить. Кроме того, вы можете настроить свои собственные IP-теги. Дополнительные сведения о настройке собственных IP-тегов см. В разделе Организация данных в соответствии с вашими потребностями. Встроенные IP-теги включают:
      • Приложения Microsoft (из них 14)
      • Анонимный прокси
      • Ботнет (вы увидите, что действие было выполнено ботнетом со ссылкой, чтобы узнать больше о конкретном ботнете)
      • Darknet сканирование IP
      • Вредоносный C&C сервер
      • Анализатор удаленного подключения
      • Спутниковые провайдеры
      • Интеллектуальный прокси-сервер и прокси-сервер доступа (исключены намеренно)
      • Узлы выхода Tor
      • Zscaler
  • Выдающееся действие — поиск только действий, которые были выполнены от имени другого пользователя.

  • Экземпляр — Экземпляр приложения, в котором действие было выполнено или не выполнено.

  • Местоположение — страна / регион, из которого было выполнено действие.

  • Соответствующая политика — поиск действий, соответствующих определенной политике, установленной на портале.

  • Зарегистрированный Интернет-провайдер — Интернет-провайдер, от которого выполнялось действие.

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

    • Коннектор приложения — журналы поступают непосредственно из коннектора API приложения.
    • Анализ коннектора приложений — улучшения Cloud App Security на основе сканирования информации коннектором API.
  • Пользователь — Пользователь, выполнивший действие, которое можно отфильтровать по домену, группе, имени или организации. Чтобы отфильтровать действия без определенного пользователя, вы можете использовать оператор «не задан».

    • Домен пользователя — поиск определенного домена пользователя.
    • Организация пользователя — организационная единица пользователя, выполнившего действие, например, все действия, выполняемые пользователями EMEA_marketing. Это актуально только для подключенных экземпляров Google Workspace, использующих организационные подразделения.
    • Группа пользователей — определенные группы пользователей, которые можно импортировать из подключенных приложений, например администраторы Office 365.
    • Имя пользователя — поиск определенного имени пользователя. Чтобы просмотреть список пользователей в определенной группе пользователей, в панели действий выберите имя группы пользователей.Щелкнув мышью, вы попадете на страницу «Учетные записи», на которой перечислены все пользователи в группе. Оттуда вы можете перейти к деталям учетных записей конкретных пользователей в группе.
    • Группа пользователей и Имя пользователя Фильтры можно дополнительно отфильтровать с помощью фильтра As и выбора роли пользователя, которая может быть любой из следующих:
      • Только объект действия — это означает, что выбранный пользователь или группа пользователей не выполняли рассматриваемое действие, они были объектом действия.
      • Только актер — означает, что пользователь или группа пользователей выполнили действие.
      • Любая роль — означает, что пользователь или группа пользователей были вовлечены в действие, либо как лицо, которое выполнило действие, либо как объект действия.
  • Пользовательский агент — Пользовательский агент from с действием был выполнен.

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

Примечание

Cloud App Security считает устаревшим, — двумя основными версиями, более ранними, чем текущая версия. Например, если текущая версия Edge — 90, то версия 88 и более ранние устарели.

Запросы активности

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

  1. На странице Журнал активности используйте фильтры, как описано выше, для детализации приложений по мере необходимости.

  2. После завершения создания запроса нажмите кнопку Сохранить как в правом верхнем углу фильтров.

  3. Во всплывающем окне Сохранить запрос назовите свой запрос.

  4. Чтобы использовать этот запрос снова в будущем, в разделе Запросы прокрутите вниз до Сохраненные запросы и выберите свой запрос.

Cloud App Security также предоставляет вам предлагаемых запросов .Предлагаемые запросы предоставляют вам рекомендуемые способы расследования, которые фильтруют ваши действия. Вы можете редактировать эти запросы и сохранять их как пользовательские запросы. Ниже приведены необязательные предлагаемые запросы:

  • Действия администратора — фильтрует все ваши действия, чтобы отображать только те действия, в которых участвовали администраторы.

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

  • Неудачный вход — фильтрует все ваши действия, чтобы отображать только неудачные попытки входа и неудачный вход через систему единого входа

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

  • Действия за выдачу себя за другое лицо — фильтрует все ваши действия, чтобы отображать только действия за выдачу себя за другое лицо.

  • Действия с почтовым ящиком — фильтрует все ваши действия для отображения только действий Microsoft Exchange Online, таких как создание элемента, удаление сообщений из почтового ящика, обновление сообщения и отправка сообщения с использованием разрешений «Отправить как» (олицетворение).

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

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

  • Действия по совместному использованию — фильтрует все ваши действия, чтобы отображать только те действия, которые связаны с совместным использованием папок и файлов, включая создание ссылки на компанию, создание анонимной ссылки и предоставление разрешений на чтение / запись.

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

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

Следующие шаги

Видимость деятельности облачных приложений

  • 5 минут на чтение

В этой статье

Microsoft Cloud App Security позволяет отслеживать все действия подключенных приложений.После подключения Cloud App Security к приложению с помощью коннектора приложений Cloud App Security сканирует все произошедшие действия (период ретроспективного сканирования различается для каждого приложения), а затем он постоянно обновляется новыми действиями.

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

Например, вы можете использовать журнал активности для поиска пользователей в вашей организации, которые используют устаревшие операционные системы или браузеры, следующим образом: После подключения приложения к Cloud App Security на странице Журнал активности используйте расширенный фильтр и выберите Тег агента пользователя . Затем выберите Устаревший браузер или Устаревшая операционная система .

Базовый фильтр предоставляет вам отличные инструменты, чтобы начать фильтрацию ваших действий.

Чтобы перейти к более конкретным действиям, вы можете развернуть основной фильтр, щелкнув Расширенный .

Примечание

Тег Legacy добавляется к любой политике действий, использующей старый фильтр «пользовательский». Этот фильтр будет продолжать работать в обычном режиме. Если вы хотите удалить устаревший тег, вы можете удалить фильтр и снова добавить фильтр, используя новый фильтр Имя пользователя .

Ящик деятельности

Работа с ящиком действий

Вы можете просмотреть дополнительную информацию о каждом действии, щелкнув само действие в журнале действий. Откроется панель действий, в которой представлены следующие дополнительные действия и сведения для каждого действия:

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

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

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

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

  • Местоположение: щелкните местоположение, чтобы просмотреть его на картах Bing.

  • Категория IP-адреса и теги: щелкните IP-тег, чтобы просмотреть список IP-тегов, обнаруженных в этом действии. Затем вы можете отфильтровать все действия, соответствующие этому тегу.

Поля в панели действий предоставляют контекстные ссылки на дополнительные действия и детализацию, которые вы, возможно, захотите выполнить непосредственно из панели.Например, если вы переместите курсор рядом с категорией IP-адресов, вы можете использовать значок «Добавить в фильтр», чтобы сразу добавить IP-адрес в фильтр текущей страницы. Вы также можете использовать значок шестеренки настроек, который появляется, чтобы перейти непосредственно на страницу настроек, необходимую для изменения конфигурации одного из полей, например Группы пользователей .

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

  • Просмотр однотипных действий
  • Просмотр всех действий одного и того же пользователя
  • Просмотр действий с одного IP-адреса
  • Просмотр действий из одного и того же географического местоположения
  • Просмотр действий за тот же период времени (48 часов)

Список доступных действий управления см. В разделе Действия управления действиями.

Отзывы пользователей

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

Для просмотра информации о пользователях:

  1. Щелкните само действие в журнале действий .

  2. Затем щелкните вкладку Пользователь .
    При нажатии открывается панель действий. Вкладка Пользователь предоставляет следующие сведения о пользователе:

    • Открытые предупреждения : Количество открытых предупреждений, в которых участвовал пользователь.
    • Соответствует : количество совпадений политики для файлов, принадлежащих пользователю.
    • Действия : количество действий, выполненных пользователем за последние 30 дней.
    • Страны : количество стран, из которых пользователь подключался за последние 30 дней.
    • Интернет-провайдеры : количество Интернет-провайдеров, с которыми пользователь подключился за последние 30 дней.
    • IP-адреса : количество IP-адресов, с которых пользователь подключался за последние 30 дней.

Статистика IP-адресов

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

Для просмотра информации об IP-адресах:

  1. Щелкните само действие в журнале действий .

  2. Затем щелкните вкладку IP-адрес .
    Откроется вкладка «Панель действий IP-адрес », на которой представлены следующие сведения об IP-адресе:

    • Открытые предупреждения : Количество открытых предупреждений, связанных с IP-адресом.
    • Действия : количество действий, выполненных IP-адресом за последние 30 дней.
    • IP-адрес : географические местоположения, из которых IP-адрес подключался за последние 30 дней.
    • Действия : количество действий, выполненных с этого IP-адреса за последние 30 дней.
    • Действия администратора : Количество административных действий, выполненных с этого IP-адреса за последние 30 дней.
    • Вы можете выполнять следующие действия с IP-адресом:
      • Отметить как корпоративный IP и добавить в список разрешенных
      • Отметить как IP-адрес VPN и добавить в список разрешенных
      • Отметить как рискованный IP-адрес и добавить в список заблокированных

    Примечание

    Когда IP-адрес помечен как корпоративный, он отражается на портале, и IP-адреса исключаются из инициирования определенных обнаружений (например, невозможности перемещения), поскольку эти IP-адреса считаются надежными.

Экспортная деятельность

Вы можете экспортировать все действия пользователя в файл CSV.

В журнале активности в правом верхнем углу нажмите кнопку Экспорт .

Примечание

В этой статье описаны действия по удалению личных данных с устройства или службы, и ее можно использовать для поддержки ваших обязательств в соответствии с GDPR. Если вам нужна общая информация о GDPR, см. Раздел GDPR на портале Service Trust.

Следующие шаги

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

мероприятий — разработчики Marketo

Ссылка на конечную точку деятельности

Marketo допускает огромное разнообразие видов деятельности, связанных с записями лидов. Почти каждое изменение, действие или шаг потока записывается в журнал активности лида и может быть получен через API или использован в фильтрах и триггерах умных списков и умных кампаний.Действия всегда связаны с записью интереса через leadId, соответствующий полю Id записи, а также имеет собственный уникальный идентификатор.

Существует очень большое количество потенциальных типов действий, которые могут варьироваться от подписки к подписке и имеют уникальные определения для каждого. Хотя каждое действие будет иметь свой собственный уникальный идентификатор, leadId и activityDate, значения primaryAttributeValueId и primaryAttributeValue будут различаться по своему значению.

Marketo также позволяет создавать настраиваемые типы действий с помощью API метаданных настраиваемых действий.Добавление настраиваемых действий выполняется через API добавления настраиваемых действий.

Большинство действий будут удалены через некоторое время. Для получения дополнительной информации см. Политику хранения активности.

Описать

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

ПОЛУЧИТЬ /rest/v1/activities/types.json

GET / rest / v1 / activity / types.json

{ «requestId»: «6e78 # 148ad3b76f1», «успех»: правда, «результат»:[ { «id»: 2, «name»: «Заполнить форму», «description»: «Пользователь заполняет и отправляет форму на веб-странице», «primaryAttribute»: { «name»: «ID веб-формы», «dataType»: «целое число» }, «атрибуты»: [ { «name»: «IP-адрес клиента», «тип данных»: «строка» }, { «name»: «Поля формы», «тип данных»: «текст» }, { «name»: «Параметры запроса», «тип данных»: «строка» }, { «name»: «URL-адрес реферера», «тип данных»: «строка» }, { «name»: «Пользовательский агент», «тип данных»: «строка» }, { «name»: «ID веб-страницы», «dataType»: «целое число» } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

{

«requestId»: «6e78 # 148ad3b76f1»,

«success»: true,

«result»: [

{

«id»: 2,

«name»: «Заполнить Форма «,

» описание «:» Пользователь заполняет и отправляет форму на веб-странице «,

» primaryAttribute «: {

» name «:» Идентификатор веб-формы «,

» dataType «:» integer «

},

«атрибуты»: [

{

«имя»: «IP-адрес клиента»,

«тип данных»: «строка»

},

{

«имя»: «Поля формы» ,

«dataType»: «text»

},

{

«name»: «Параметры запроса»,

«dataType»: «string»

},

{

«name»: «URL перехода»,

«dataType»: «string»

},

{

«name»: «User Agent»,

«dataType»: «string»

},

{

«name»: «ID веб-страницы»,

«dataType»: «integer»

}

]

}

]

}

Реальные ответы будут включать гораздо больше определений.В этом примере показан тип «Форма заполнения», который имеет первичный атрибут «Идентификатор веб-формы», который относится к идентификатору Marketo формы, которая была заполнена, и может использоваться для обратной связи с этой формой. конкретный актив на Marketo. Кроме того, есть определения для каждого из возможных атрибутов конкретной записи активности этого типа и их типов данных. Обратите внимание, что если поле пустое, то этот конкретный атрибут будет опущен в отдельной записи активности.

Запрос

Чтобы получить действия из Marketo, вызовите конечную точку Get Lead Activities.Сначала вам нужно получить токен подкачки для даты и времени, с которой вы хотите начать получение действий. Затем вы передаете токен подкачки в параметре запроса nextPageToken . Кроме того, вы передаете до десяти идентификаторов типов действий в параметре запроса activityTypeIds в виде списка, разделенного запятыми.

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

ПОЛУЧИТЬ /rest/v1/activities.json?activityTypeIds=1&nextPageToken=WQV2VQVPPCKHC6AQYVK7JDSA3I3LCWXh4Y6IIZ7YSGQLXHCPVE5Q====

GET /rest/v1/activities.json?activityTypeIds=1&nextPageToken=WQV2VQVPPCKHC6AQYVK7JDSA3I3LCWXh4Y6IIZ7YSGQLXHCPVE5Q====

{ «requestId»: «24fd # 15188a88d7f», «результат» : [ { «id»: 102988, «marketoGUID»: «102988», «leadId»: 1, «activityDate»: «2015-01-16T23: 32: 19Z», «activityTypeId»: 1, «primaryAttributeValueId»: 71, «primaryAttributeValue»: «localhost / munchkintest2.html «, «атрибуты»: [ { «name»: «IP-адрес клиента», «значение»: «10.0.19.252» }, { «name»: «Параметры запроса», «ценить» : «» }, { «name»: «URL-адрес реферера», «ценить» : «» }, { «name»: «Пользовательский агент», «value»: «Mozilla / 5.0 (Windows NT 6.1; WOW64) AppleWebKit / 537.36 (KHTML, как Gecko) Chrome / 39.0.2171.95 Safari / 537.36 » }, { «name»: «URL веб-страницы», «значение»: «/munchkintest2.html» } ] } ], «успех»: правда, «nextPageToken»: «WQV2VQVPPCKHC6AQYVK7JDSA3J62DUSJ3EXJGDPTKPEBFW3SAVUA ====», «moreResult»: false }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

{

«requestId»: «24fd # 15188a88d7f»,

«result»: [

{

«id»: 102988,

«marketoGUID»: «102988»,

«leadId»: 1 ,

«activityDate»: «2015-01-16T23: 32: 19Z»,

«activityTypeId»: 1,

«primaryAttributeValueId»: 71,

«primaryAttributeValue»: «localhost / munchkintest2.html «,

» атрибуты «: [

{

» имя «:» IP-адрес клиента »,

» значение «:» 10.0.19.252 «

},

{

» имя «:» Параметры запроса «,

» значение «:» «

},

{

» имя «:» URL перехода «,

» значение «:» «

},

{

» имя » : «Пользовательский агент»,

«значение»: «Mozilla / 5.0 (Windows NT 6.1; WOW64) AppleWebKit / 537.36 (KHTML, например Gecko) Chrome / 39.0.2171.95 Safari / 537.36 «

},

{

» name «:» URL веб-страницы «,

» value «: «/munchkintest2.html»

}

]

}

],

«успех»: true,

«nextPageToken»: «WQV2VQVPPCKHC6AQYVK7JDSA3J62DUSJ3EXJGDP14TKPEBFW =

:

, false»

}

Для первого вызова используйте API Get Paging Token, чтобы получить nextPageToken.Для последующих вызовов этой конечной точки используйте nextPageToken, возвращенный из ответа. Эта конечная точка всегда будет возвращать nextPageToken.

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

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

Обратите внимание, что в каждом элементе массива result целочисленный атрибут id заменяется строковым атрибутом marketoGUID в качестве уникального идентификатора. Для получения дополнительной информации см. Этот пост.
Изменения значений данных

Для действий «Изменение значения данных» предоставляется специализированная версия API-интерфейса действий.Конечная точка «Получить изменения интереса» будет возвращать только действия записей изменения значения данных в поля интереса. Интерфейс такой же, как у Get Lead Activities API, с двумя отличиями:

  • Параметр activityTypeIds отсутствует, поскольку конечная точка возвращает только действия по изменению значения данных.
  • Параметр запроса fields является обязательным, в котором вы можете передать список полей, разделенных запятыми, чтобы указать, для каких полей вы хотите получить изменения.

ПОЛУЧИТЬ / rest / v1 / activity / leadchanges.json? nextPageToken = GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBQ & fields = firstName, lastName, Department

GET /rest/v1/activities/leadchanges.json?nextPageToken=GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBQ&fields=firstName,lastName,department

{ «requestId»: «a9ae # 148add1e53d», «успех»: правда, «nextPageToken»: «GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBRGA3TQ ===», «moreResult»: правда, «результат»:[ { «id»: 1078, «marketoGUID»: «1078», «leadId»: 775, «activityDate»: «2014-09-17T22: 31: 49 + 0000», «activityTypeId»: 13, «поля»: [ { «id»: 48, «name»: «firstName», «newValue»: «FirstName_6176», «oldValue»: «FirstName_4914» } ], «атрибуты»: [ { «name»: «Причина», «value»: «API веб-службы» }, { «name»: «Источник», «value»: «API веб-службы» }, { «name»: «Lead ID», «value»: 775 } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

{

«requestId»: «a9ae # 148add1e53d»,

«success»: true,

«nextPageToken»: «GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBRGA3T15Q14==»,

«еще»,

«true»,

«true», больше » [

{

«id»: 1078,

«marketoGUID»: «1078»,

«leadId»: 775,

«activityDate»: «2014-09-17T22: 31: 49 + 0000»,

«activityTypeId»: 13,

«fields»: [

{

«id»: 48,

«name»: «firstName»,

«newValue»: «FirstName_6176»,

«oldValue» «:« FirstName_4914 »

}

],

« атрибуты »: [

{

« имя »:« Причина »,

« значение »:« API веб-службы »

},

{

«имя»: «Источник»,

«значение»: «API веб-службы»

},

{

«имя»: «Идентификатор лида»,

«значение»: 775

}

]

}

]

}

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

Обратите внимание, что в каждом элементе массива result целочисленный атрибут id заменяется строковым атрибутом marketoGUID в качестве уникального идентификатора. Для получения дополнительной информации см. Этот пост.
Удаленные заявки

Существует также специальная конечная точка Get Deleted Leads для получения удаленных действий с Marketo.

ПОЛУЧИТЬ /rest/v1/activities/deletedleads.json?nextPageToken=GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBQ

ПОЛУЧИТЬ / rest / v1 / activity / deletedleads.json? nextPageToken = GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBQ

{ «requestId»: «a9ae # 148add1e53d», «успех»: правда, «nextPageToken»: «GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBRGA3TQ ===», «moreResult»: правда, «результат»:[ { «id»: 2, «marketoGUID»: «2», «leadId»: 6, «activityDate»: «2013-09-26T06: 56: 35 + 0000», «activityTypeId»: 37, «primaryAttributeValueId»: 6, «primaryAttributeValue»: «Owyliphys Iledil», «атрибуты»: [ ] }, { «id»: 3, «marketoGUID»: «3», «leadId»: 9, «activityDate»: «2013-12-28T00: 39: 45 + 0000», «activityTypeId»: 37, «primaryAttributeValueId»: 4, «primaryAttributeValue»: «Первый Последний», «атрибуты»: [ ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

{

«requestId»: «a9ae # 148add1e53d»,

«success»: true,

«nextPageToken»: «GIYDAOBNGEYS2MBWKQYDAORQGA5DAMBOGAYDAKZQGAYDALBRGA3T15Q14==»,

«еще»,

«true»,

«true», больше » [

{

«id»: 2,

«marketoGUID»: «2»,

«leadId»: 6,

«activityDate»: «2013-09-26T06: 56: 35 + 0000»,

«activityTypeId»: 37,

«primaryAttributeValueId»: 6,

«primaryAttributeValue»: «Owyliphys Iledil»,

«attributes»: [

]

},

{

«id»: 3,

«marketoGUID»: «3»,

«leadId»: 9,

«activityDate»: «2013-12-28T00: 39: 45 + 0000»,

«activityTypeId»: 37,

«primaryAttributeValueId»: 4,

«p rimaryAttributeValue «:» Первый последний «,

» атрибуты «: [

]

}

]

}

Обратите внимание, что в каждом элементе массива result целочисленный атрибут id заменяется строковым атрибутом marketoGUID в качестве уникального идентификатора.Для получения дополнительной информации см. Этот пост.
Страница, хотя результаты

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

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

Пользовательские типы действий

Пользовательские действия работают так же, как стандартные действия, за исключением того, что схема управляется третьими сторонами, а не Marketo.Экземпляры настраиваемых действий связаны с записями интересов через leadId так же, как и стандартные действия, но как первичные, так и вторичные атрибуты определяются произвольно. При утверждении настраиваемого типа активности создаются соответствующие триггер и фильтр смарт-списка, так что интересы могут обрабатываться на основе текущих или исторических данных о настраиваемой активности.

  • Максимальное количество настраиваемых действий: 10
  • Максимальное количество атрибутов на настраиваемое действие: 20

Получение данных о настраиваемых действиях выполняется так же, как и стандартные действия, с помощью API получения действий для потенциальных клиентов.

Типы запросов

В дополнение к стандартной конечной точке «Получить типы действий», конечные точки «Получить настраиваемые типы действий» и «Описать настраиваемые типы действий» будут возвращать сведения о типах действий, предоставленных в экземпляре Marketo, и метаданные, касающиеся атрибутов для данного типа. Обычные типы Get Activity по-прежнему будут возвращать метаданные о настраиваемых действиях, но не будут указывать, является ли данный тип настраиваемым.

Получить типы

ПОЛУЧИТЬ / отдых / v1 / действия / внешние / типы.json

GET /rest/v1/activities/external/types.json

{ «requestId»: «185d6 # 14b51985ff0», «успех»: правда, «результат»:[ { «id»: 100001, «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посещает конференцию», «filterName»: «Посещенная конференция», «createdAt»: «2016-02-03T22: 36: 23Z», «updatedAt»: «2016-02-03T22: 36: 23Z», «статус»: «одобрен» } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

{

«requestId»: «185d6 # 14b51985ff0»,

«success»: true,

«result»: [

{

«id»: 100001,

«apiName»: «AttendConference» ,

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

«filterName»: «Посещенная конференция»,

«createdAt «:» 2016-02-03T22: 36: 23Z «,

» updatedAt «:» 2016-02-03T22: 36: 23Z «,

» статус «:» утвержден «

}

]

}

Опишите тип

Для описаний типов необходимо передать apiName в качестве параметра пути.По умолчанию вы получите утвержденную версию занятия. При желании можно передать параметр draft = true , чтобы получить черновую версию действия.

ПОЛУЧИТЬ /rest/v1/activities/external/type/{apiName}/describe.json

GET /rest/v1/activities/external/type/{apiName}/describe.json

{ «requestId»: «185d6 # 14b51985ff0», «успех»: правда, «результат»:[ { «id»: 100001, «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посещает конференцию», «filterName»: «Посещенная конференция», «createdAt»: «2016-02-03T22: 36: 23Z», «updatedAt»: «2016-02-03T22: 36: 23Z», «статус»: «одобрено», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции», «тип данных»: «строка» }, «атрибуты»: [ { «apiName»: «ConferenceDate», «name»: «Дата конференции», «description»: «Дата конференции», «dataType»: «datetime» }, { «apiName»: «numberOfAttendees», «name»: «Количество участников», «description»: «Количество участников конференции», «dataType»: «целое число» } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

{

«requestId»: «185d6 # 14b51985ff0»,

«success»: true,

«result»: [

{

«id»: 100001,

«apiName»: «AttendConference» ,

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

«filterName»: «Посещенная конференция»,

«createdAt «:« 2016-02-03T22: 36: 23Z »,

« updatedAt »:« 2016-02-03T22: 36: 23Z »,

« статус »:« утверждено »,

« primaryAttribute »:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»,

«dataType»: «string»

},

«атрибуты»: [

{

«api Имя «:» ConferenceDate «,

» name «:» Дата конференции «,

» description «:» Дата конференции «,

» dataType «:» datetime «

},

{

» apiName «:» numberOfAttendees «,

» name «:» Number of Attendees «,

» description «:» Количество людей, посещающих конференцию «,

» dataType «:» integer «

}

]

}

]

}

Создать Тип

Для каждого типа настраиваемого действия требуется отображаемое имя, имя API, имя триггера, имя фильтра и основной атрибут.

Чтобы обеспечить согласованность ваших типов с соглашениями Marketo и избежать коллизий, важно следовать нескольким рекомендациям при создании типов:

Отображаемое имя: Отображаемое имя типа действия должно кратко описывать, что представляет собой запись действия, например «Отправить электронное письмо» или «Изменить значение данных». Эти имена обычно должны быть в форме инфинитива, то есть «Посещать мероприятие». Отображаемые имена допускают буквенно-цифровые символы, пробелы и подчеркивания.Отображаемые имена должны содержать хотя бы одну букву.

Имя API: Имя API состоит из буквенно-цифровых символов (максимальная длина 255). Если вы являетесь партнером LaunchPoint, вам следует добавить репрезентативное пространство имен к именам API вашего типа деятельности. Это сделано для того, чтобы избежать конфликтов с типами, предоставленными клиентом. Соглашение заключается в использовании всех строчных букв или верблюжьего регистра, чтобы помочь различать другие текстовые строки.

Описание: Для действий, которые могут иметь неочевидное поведение, следует включать описание того, что представляет собой этот тип деятельности по отношению к интересу.

Имя триггера: Каждый тип действия должен иметь уникальное, удобочитаемое имя триггера. Имена триггеров должны быть в настоящем времени от третьего лица, например «Посещает мероприятие». Партнерам LaunchPoint следует указать название своей компании в мероприятии, например «Посещает вебинар — компания Acme».

Имя фильтра: Каждый тип действия должен иметь уникальное, удобочитаемое имя фильтра. Названия фильтров должны быть в прошедшем времени от третьего лица, например «Посещал мероприятие».Партнерам LaunchPoint следует указать название своей компании в мероприятии, например «Посещенный веб-семинар — компания Acme».

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

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

При создании типа параметр description является необязательным, в то время как все следующие параметры являются обязательными: apiName , name , triggerName , filterName , primaryAttribute .

ЗАПИСЬ /rest/v1/activities/external/type.json

ЗАПИСЬ /rest/v1/activities/external/type.json

{ «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посещает конференцию», «filterName»: «Посещенная конференция», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции» } }

{

«apiName»: «AttendConference»,

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

» filterName «:» Посещенная конференция «,

» primaryAttribute «:

{

» apiName «:» ConferenceName «,

» name «:» Название конференции «,

» description «:» Название конференции »

}

}

{ «requestId»: «e42b # 14272d07d78», «успех»: правда, «результат»:[ { «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посещает конференцию», «filterName»: «Посещенная конференция», «статус»: «черновик», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции», «тип данных»: «строка» } } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

{

«requestId»: «e42b # 14272d07d78»,

«success»: true,

«result»: [

{

«apiName»: «tendConference «,

» name «:» Посещать конференцию »,

« описание »:« Посещать конференцию »,

« triggerName »:« Посещать конференцию »,

« filterName »:« Посещенная конференция »,

« status »:« draft »,

«primaryAttribute»:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»,

«dataType»: «строка»

}

}

]

}

Тип обновления

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

POST /rest/v1/activities/external/type/{apiName}.json

POST /rest/v1/activities/external/type/{apiName}.json

{ «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посетить конференцию», «filterName»: «Посещенная конференция», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции» } }

{

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

«filterName»: «Посещенная конференция»,

«primaryAttribute»:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»

}

}

{ «requestId»: «e42b # 14272d07d78», «успех»: правда, «результат»:[ { «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посетить конференцию», «filterName»: «Посещенная конференция», «статус»: «черновик», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции», «тип данных»: «строка» } } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

{

«requestId»: «e42b # 14272d07d78»,

«success»: true,

«result»: [

{

«apiName»: «tendConference «,

» name «:» Посещать конференцию »,

« описание »:« Посещать конференцию »,

« triggerName »:« Посещать конференцию »,

« filterName »:« Посещенная конференция »,

« status »:« draft »,

«primaryAttribute»:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»,

«dataType»: «строка»

}

}

]

}

Утвердить тип

Типами

можно управлять с помощью Утвердить настраиваемый тип действия, Отменить черновик настраиваемого типа действия и Удалить настраиваемый тип действия, как и стандартные ресурсы Marketo.

Атрибуты настраиваемого типа действия

Каждый пользовательский тип действия может иметь от 0 до 20 дополнительных атрибутов. Вторичные атрибуты могут иметь любой допустимый тип поля для поля Marketo. Они добавляются, обновляются и удаляются отдельно от родительского типа, но могут редактироваться во время использования типа действия, а затем утверждаться. Когда поля редактируются в активном типе, тогда для всех действий этого типа, созданных после утверждения, будет установлен новый вторичный атрибут. Изменения не будут применяться задним числом к ​​существующим действиям этого типа.

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

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

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

При изменении основного атрибута типа действия любой существующий основной атрибут должен быть понижен, установив сначала для isPrimary значение false.

Создать атрибуты

Создание атрибута требует обязательного параметра пути apiName . Также требуются параметры name и dataType . Описание , параметры и isPrimary являются необязательными.

POST / rest / v1 / activity / external / type / {apiName} / attributes / create.json

POST /rest/v1/activities/external/type/{apiName}/attributes/create.json

{ «атрибуты»: [ { «apiName»: «ConferenceDate», «name»: «Дата конференции», «description»: «Дата конференции», «dataType»: «datetime» }, { «apiName»: «numberOfAttendees», «name»: «Количество участников», «description»: «Количество участников конференции», «dataType»: «целое число» } ] }

{

«атрибуты»: [

{

«apiName»: «конференцияДата»,

«имя»: «Дата конференции»,

«описание»: «Дата конференции»,

» dataType «:» datetime «

},

{

» apiName «:» numberOfAttendees «,

» name «:» Number of Attendees «,

» description «:» Количество людей, посещающих конференцию «,

«dataType»: «integer»

}

]

}

{ «requestId»: «e42b # 14272d07d78», «успех»: правда, «результат»:[ { «id»: 100001, «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посетить конференцию», «filterName»: «Посещенная конференция», «createdAt»: «2016-02-03T22: 36: 23Z», «updatedAt»: «2016-02-03T22: 36: 23Z», «status»: «одобрено с черновиком», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции», «тип данных»: «строка» }, «атрибуты»: [ { «apiName»: «ConferenceDate», «name»: «Дата конференции», «description»: «Дата конференции», «dataType»: «datetime» }, { «apiName»: «numberOfAttendees», «name»: «Количество участников», «description»: «Количество участников конференции», «dataType»: «целое число» } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

{

«requestId»: «e42b # 14272d07d78»,

«success»: true,

«result»: [

{

«id»: 100001,

«apiName»: «AttendConference» ,

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

«filterName»: «Посещенная конференция»,

«createdAt «:» 2016-02-03T22: 36: 23Z «,

» updatedAt «:» 2016-02-03T22: 36: 23Z «,

» status «:» одобрено с черновиком «,

» primaryAttribute «:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»,

«dataType»: «string»

},

«атрибуты»: [

{

«apiName»: «предоставить enceDate «,

» name «:» Дата конференции «,

» description «:» Дата конференции «,

» dataType «:» datetime «

},

{

» apiName «:» numberOfAttendees «,

» name «:» Количество участников «,

» description «:» Количество людей, посещающих конференцию «,

» dataType «:» integer «

}

]

}

]

}

Обновить атрибуты

При обновлении атрибутов apiName атрибута является первичным ключом.Для успешного обновления должен существовать параметр apiName (т.е. вы не можете изменить параметр apiName с помощью update).

POST /rest/v1/activities/external/type/{apiName}/attributes/update.json

POST /rest/v1/activities/external/type/{apiName}/attributes/update.json

{ «атрибуты»: [ { «apiName»: «ConferenceDate», «name»: «Дата конференции», «description»: «Дата конференции», «dataType»: «datetime» }, { «apiName»: «numberOfAttendee», «name»: «Количество участников», «description»: «Количество участников конференции», «dataType»: «целое число» } ] }

{

«атрибуты»: [

{

«apiName»: «конференцияДата»,

«имя»: «Дата конференции»,

«описание»: «Дата конференции»,

» dataType «:» datetime «

},

{

» apiName «:» numberOfAttendee «,

» name «:» Number of Attendee «,

» description «:» Количество людей, посещающих конференцию «,

«dataType»: «integer»

}

]

}

{ «requestId»: «e42b # 14272d07d78», «успех»: правда, «результат»:[ { «id»: 100001, «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посетить конференцию», «filterName»: «Посещенная конференция», «createdAt»: «2016-02-03T22: 36: 23Z», «updatedAt»: «2016-02-03T22: 36: 23Z», «status»: «одобрено с черновиком», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции», «тип данных»: «строка» }, «атрибуты»: [ { «apiName»: «ConferenceDate», «name»: «Дата конференции», «description»: «Дата конференции», «dataType»: «datetime» }, { «apiName»: «numberOfAttendee», «name»: «Количество участников», «description»: «Количество участников конференции», «dataType»: «целое число» } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

{

«requestId»: «e42b # 14272d07d78»,

«success»: true,

«result»: [

{

«id»: 100001,

«apiName»: «AttendConference» ,

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

«filterName»: «Посещенная конференция»,

«createdAt «:» 2016-02-03T22: 36: 23Z «,

» updatedAt «:» 2016-02-03T22: 36: 23Z «,

» status «:» одобрено с черновиком «,

» primaryAttribute «:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»,

«dataType»: «string»

},

«атрибуты»: [

{

«apiName»: «предоставить enceDate «,

» name «:» Дата конференции «,

» description «:» Дата конференции «,

» dataType «:» datetime «

},

{

» apiName «:» numberOfAttendee «,

» name «:» Number of Attendee «,

» description «:» Количество людей, посещающих конференцию «,

» dataType «:» integer «

}

]

}

]

}

Удалить атрибуты

Для удаления атрибута требуется обязательный параметр пути apiName , который является именем API настраиваемого действия.Также необходим параметр attributes и , который представляет собой массив объектов атрибутов. Каждый объект должен содержать параметр apiName , который является именем API настраиваемого типа действия.

POST /rest/v1/activities/external/type/{apiName}/attributes/delete.json

POST /rest/v1/activities/external/type/{apiName}/attributes/delete.json

{ «атрибуты»: [ { «apiName»: «ConferenceDate» }, { «apiName»: «numberOfAttendees» } ] }

{

«атрибуты»: [

{

«apiName»: «ConferenceDate»

},

{

«apiName»: «numberOfAttendees»

}

]

}

{ «requestId»: «e42b # 14272d07d78», «успех»: правда, «результат»:[ { «id»: 100001, «apiName»: «AttendConference», «name»: «Посетить конференцию», «description»: «Посетить конференцию», «triggerName»: «Посетить конференцию», «filterName»: «Посещенная конференция», «createdAt»: «2016-02-03T22: 36: 23Z», «updatedAt»: «2016-02-03T22: 36: 23Z», «status»: «одобрено с черновиком», «primaryAttribute»: { «apiName»: «ConferenceName», «name»: «Название конференции», «description»: «Название конференции», «тип данных»: «строка» }, } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

{

«requestId»: «e42b # 14272d07d78»,

«success»: true,

«result»: [

{

«id»: 100001,

«apiName»: «AttendConference» ,

«name»: «Посещать конференцию»,

«description»: «Посещать конференцию»,

«triggerName»: «Посещать конференцию»,

«filterName»: «Посещенная конференция»,

«createdAt «:» 2016-02-03T22: 36: 23Z «,

» updatedAt «:» 2016-02-03T22: 36: 23Z «,

» status «:» одобрено с черновиком «,

» primaryAttribute «:

{

«apiName»: «ConferenceName»,

«name»: «Название конференции»,

«description»: «Название конференции»,

«dataType»: «string»

},

}

]

}

Добавить пользовательские действия

Пользовательские действия — это записи с однократной записью исторических действий, связанных с записями отдельных лиц в Marketo.Эти действия имеют схему, которая управляется администраторами Marketo или удаленно через интеграцию API. Настраиваемые действия добавляются в записи интересов через конечную точку Добавить настраиваемые действия и связаны с каждой записью интереса через ее поле leadId. Настраиваемые действия можно просмотреть в пользовательском интерфейсе через журнал действий лида или получить через конечную точку получения действий для лида, указав идентификатор типа настраиваемого действия.

Пользовательские действия подходят для записи данных, относящихся к записи одного человека и не нуждающихся в обновлении или перезаписи.Примером может служить запись человека, посещающего мероприятие, как «Посещенное событие». Для записей, связанных с человеком, который может измениться, например, зачисление студентов, следует использовать настраиваемые объекты, поскольку они могут обновляться, а настраиваемые действия — нет.

Входной элемент — это массив объектов деятельности. Одновременно можно отправить не более 300 записей о деятельности.

leadId , activityDate , activityTypeId , primaryAttributeValue и атрибуты членов обязательны.Массив атрибутов должен содержать непервичный атрибут. Это можно указать, используя либо name (имя поля), либо apiName (имя API) и значение , которое соответствует заданному вами значению.

ЗАПИСЬ /rest/v1/activities/external.json

ЗАПИСЬ /rest/v1/activities/external.json

{ «Вход»:[ { «leadId»: 1001, «activityDate»: «2016-09-26T06: 56: 35 + 07: 00», «activityTypeId»: 1001, «primaryAttributeValue»: «Раздача игр», «атрибуты»: [ { «apiName»: «uRL», «значение»: «http: // www.nvidia.com/game-giveaway » } ] }, { «leadId»: 1200, «activityDate»: «2016-09-26T06: 56: 35 + 07: 00», «activityTypeId»: 1001, «primaryAttributeValue»: «Раздача игр», «атрибуты»: [ { «apiName»: «uRL», «значение»: «http://www.nvidia.com/game-giveaway» } ] }, { «leadId»: 3000, «activityDate»: «2016-09-26T06: 56: 35 + 07: 00», «activityTypeId»: 1001, «primaryAttributeValue»: «Форма конкурса», «атрибуты»: [ { «apiName»: «uRL», «значение»: «http: // www.nvidia.com/game-giveaway » } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

{

«input»: [

{

«leadId»: 1001,

«activityDate»: «2016-09-26T06: 56: 35 + 07: 00»,

«activityTypeId»: 1001 ,

«primaryAttributeValue»: «Раздача игр»,

«attributes»: [

{

«apiName»: «uRL»,

«value»: «http: // www.nvidia.com/game-giveaway «

}

]

},

{

» leadId «: 1200,

» activityDate «:» 2016-09-26T06: 56: 35 + 07: 00 » ,

«activityTypeId»: 1001,

«primaryAttributeValue»: «Game Giveaway»,

«attributes»: [

{

«apiName»: «uRL»,

«value»: «http: / /www.nvidia.com / game-giveaway «

}

]

},

{

» leadId «: 3000,

» activityDate «:» 2016-09-26T06: 56: 35 + 07: 00 «,

«activityTypeId»: 1001,

«primaryAttributeValue»: «Форма конкурса»,

«attributes»: [

{

«apiName»: «uRL»,

«value»: «http: // www .nvidia.com / game-giveaway «

}

]

}

]

}

{ «requestId»: «e42b # 14272d07d78», «успех»: правда, «результат»:[ { «id»: 50, «marketoGUID»: «50», «статус»: «добавлено» }, { «id»: 51, «marketoGUID»: «51», «статус»: «добавлено» }, { «статус»: «пропущено» «ошибки»: [ { «код»: «1004», «message»: «Lead not found» } ] } ] }

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

{

«requestId»: «e42b # 14272d07d78»,

«success»: true,

«result»: [

{

«id»: 50,

«marketoGUID»: «50» ,

«статус»: «добавлен»

},

{

«идентификатор»: 51,

«marketoGUID»: «51»,

«статус»: «добавлен»

},

{

«статус»: «пропущено»

«ошибки»: [

{

«код»: «1004»,

«сообщение»: «Не найден интерес»

}

]

}

]

}

Обратите внимание, что в каждом элементе массива result целочисленный атрибут id заменяется строковым атрибутом marketoGUID в качестве уникального идентификатора.Для получения дополнительной информации см. Этот пост.

Настраиваемые действия

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

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

Пользовательские действия ведут себя так же, как и любые другие действия по умолчанию (электронная почта, SMS, звонки, заметки) — вы можете создавать, редактировать, искать / фильтровать и составлять отчеты по ним.Вы также можете добавить их через наш API или Zapier, если хотите интегрировать Close с другими сервисами (например, автоматически создавать настраиваемое действие Inbound Form, когда потенциальный клиент заполняет форму).

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

  • Билет по внутренней связи
  • Квалификационный звонок по продажам
  • Счет-фактура с полосой
  • Отзыв о NPS

Чтобы создать новый настраиваемый тип действия, перейдите в Настройки> Настраиваемые действия> + Новое настраиваемое действие , дайте ему имя и щелкните Сэкономьте .

Вы можете включить Ограничить редактирование , чтобы другие пользователи не могли добавлять / редактировать / удалять экземпляры этого типа — например, вы хотите ограничить активность звонков, отвечающих требованиям продаж, только для группы продаж. Чтобы контролировать, кто может добавлять / редактировать / удалять типы настраиваемых действий — убедитесь, что у пользователя есть разрешение Управление настройками на странице «Роли и разрешения».

Если вы используете настраиваемое поле исключительно через интеграцию (API или Zapier), вы можете включить Hide (только для использования API) , чтобы этот тип не отображался на странице потенциальных клиентов, и поэтому пользователи Close не могли создавать один из пользовательского интерфейса приложения.

После создания нового типа действия вы будете автоматически перенаправлены для добавления некоторых полей к этому типу действия. Каждое поле похоже на настраиваемое поле, которое вы можете использовать в потенциальных клиентах и ​​контактах — это может быть номер, текст, дата и время и т. Д. Мы создадим несколько полей для нашего типа активности «Звонок, отвечающий требованиям продаж»:

  • Текст Имеют ли они квалификацию?
  • Текст Какой у них текущий CRM?
  • Число Сколько пользователей?
  • Choices (single) Как они о нас узнали?
  • Выбор (одиночный) Каков их процесс продаж?

Вы также можете пометить любое поле как Обязательное — таким образом пользователи не смогут создать экземпляр этого типа, не заполнив это поле.

Когда у вас есть поля (структура) так, как вы этого хотите — вы можете продолжить и начать создавать фактические экземпляры Custom Activity.

Пользовательские действия создаются с помощью просмотра страницы интересов, как и любые другие действия. Перейдите на страницу интереса > Действие> Квалификационный звонок по продажам , чтобы добавить новый экземпляр. Заполните все данные и нажмите Сохранить . Поздравляем — вы только что добавили свое первое настраиваемое действие!

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

Если вы отметили свой настраиваемый тип действия как Hide (только для использования API) , то вы не увидите его здесь, но вы сможете создать его только через API.

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

  • дата создания
  • дата последнего обновления
  • создана
  • последнее обновление
  • любое поле в пользовательском действии

Вы можете сообщить, сколько раз вы создавали конкретное настраиваемое действие, с помощью отчетов «Обзор действий» и «Сравнение действий».

Просто добавьте новую плитку, и вы сразу сможете начать отслеживать новые показатели:

То же самое относится и к сравнению действий, где вы также можете выбрать настраиваемые действия:

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

Как создать настраиваемое действие

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

Файлы настраиваемых шаблонов действий, предоставленные CatTools и упомянутые в этом руководстве, основаны на создании простого отчета о версии для устройства Cisco Router. После того, как вы создали файлы сценария .txt и .custom , вам необходимо изменить их для вашего конкретного действия или отчета.

Дополнительная информация о файле настраиваемого типа действия (.ini), файле основного сценария настраиваемого действия (.txt), файле сценария клиента настраиваемого действия (.txt), файле сценария настраиваемого устройства действия (.custom), ct. примеры кода и cl. Примеры кода, показывающего, как использовать внутренние функции и подпроцедуры CatTools в сценариях действий, можно найти на других подстраницах этой главы.

1. Создайте файл настраиваемого типа занятия (.ini)

  1. Создайте копию Custom.Activity.Template.ini в подпапке \ Templates корневого каталога CatTools и сохраните в подпапке \ Activities .
  2. Переименуйте новый файл, используя синтаксис Custom. :

    Тип.Имя

    Например, Custom.Report.Version

2.Отредактируйте файл .ini

С помощью редактора текстовых файлов, например «Блокнота», откройте файл .ini , созданный на шаге 1. Вы должны изменить следующие элементы в файле .ini , используя значения по умолчанию для шаблона:

 

[Activity]

name = Custom.Activity.Template

script_main = Main.Custom.Activity.Template.txt

script_client = Клиент.Custom.Activity.Template.txt

report_file =% AppPath% Reports \ Master Custom Activity Template.txt

id = 3999

  • Измените имя на уникальное имя действия. Например: Custom.Report.PortStatus

    Не используйте пробелы. Вместо этого используйте точку (, ).

  • Измените script_main на имя связанного файла основного сценария.

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

  • Измените script_client на имя связанного файла сценария клиента.

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

  • Измените report_file на уникальное имя отчета.
  • Измените id на уникальный номер (т.е.е. тот, который не используется ни в каком другом файле .ini деятельности). Номер должен находиться в диапазоне от 4000 до 4999.

3. Сохранить и перезапустить

  1. После внесения изменений в файл .ini сохраните его обратно во вложенную папку \ Activities и закройте.
  2. Перезапустите CatTools, чтобы заполнить раскрывающееся поле Тип на экране настройки занятия новым пользовательским типом занятия.

4. Создайте файл основного сценария настраиваемого действия (.txt)

  1. Создайте копию Main.Custom.Activity.Template.txt в подпапке \ Templates корневого каталога CatTools.
  2. Сохраните копию в подпапке \ Scripts .
  3. Дайте ему новое имя файла, как указано в элементе script_main в типе действия.ini файл [Activity] раздел на шаге 2 выше. Убедитесь, что вы сохранили суффикс типа файла .txt.

5. Отредактируйте основной файл сценария .txt

  1. С помощью редактора текстовых файлов откройте файл .txt, созданный на шаге 4.
  2. Следуйте инструкциям в разделе ЗАМЕТКИ СЦЕНАРИЙ файла .txt , чтобы начать настройку сценария для вашего действия.

6.Сохраните основной файл скрипта .txt

После внесения начальных изменений в основной файл .txt сценария сохраните его обратно в подпапку \ Scripts и закройте.

7. Создайте файл сценария клиента настраиваемого действия (.txt).

  1. Сделайте копию Client.Custom.Activity.Template.txt в подпапке \ Templates корневого каталога CatTools.
  2. Сохраните копию в подпапке \ Scripts.Переименуйте новое имя файла, как указано в элементе script_client в файле типа действия .ini , в разделе [Activity] на шаге 2 выше. Убедитесь, что вы сохранили суффикс типа файла .txt.

8. Отредактируйте файл клиентского скрипта .txt

  1. С помощью редактора текстовых файлов откройте файл .txt, созданный на шаге 7.
  2. Следуйте инструкциям в разделе ЗАМЕТКИ СЦЕНАРИЙ файла.txt, чтобы начать настройку скрипта для вашего действия.

9. Сохраните файл клиентского скрипта .txt

После внесения начальных изменений в файл .txt клиентского сценария сохраните его обратно в подпапку \ Scripts и закройте.

10. Создайте файл сценария настраиваемого устройства (.custom)

  1. Сделайте копию Custom.Device.Template.txt.custom в подпапке \ Templates корневого каталога CatTools.
  2. Сохраните в подпапке \ Scripts и переименуйте файл.

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

В следующем примере создается файл сценария настраиваемого устройства для маршрутизатора Cisco с использованием зашифрованного файла сценария, предоставленного CatTools: Cisco.Маршрутизатор.General.txt . Таким образом, имя файла сценария настраиваемого устройства будет: Cisco.Router.General.txt.custom

11. Отредактируйте файл сценария устройства .custom

  1. С помощью редактора текстовых файлов откройте файл .custom, созданный на шаге 10.
  2. Прочтите раздел ЗАМЕТКИ СЦЕНАРИЙ файла .custom и начните настраивать сценарий для своего устройства.

    Пример шагов, которые необходимо выполнить, чтобы добавить настраиваемое действие в.Файл настраиваемого устройства можно найти на странице файла справки Файл сценария настраиваемого устройства (.custom).

12. Сохраните файл сценария устройства .custom

После внесения изменений в файл сценария устройства .custom сохраните его обратно во вложенную папку \ Scripts и закройте.

13. Тестирование пользовательских сценариев действий

  1. Когда все настраиваемые скрипты активности и устройства.настраиваются файлы пользовательских сценариев, протестируйте новое действие в CatTools, настроив действие для запуска с устройством, для которого вы создали файл .custom.
  2. Используйте команду «Выполнить сейчас», чтобы проверить настраиваемое действие вручную, а не запускать таймер.
  3. Проверьте панель Info Log на наличие ошибок и при необходимости отредактируйте файлы .txt и .custom.

    См. Раздел Тестирование пользовательской активности для получения дополнительной информации и советов.

Создание контрольного списка настраиваемых действий

  1. Создать файл типа операции (.ini)
  2. Создание операции Главный файл сценария (.txt)
  3. Создание файла сценария клиента действий (.txt)
  4. Создать файл сценария устройства активности (.custom)

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

Файл настраиваемого типа действия (.ini)

Типы действий определяются в CatTools с помощью текстовых файлов (файлов .ini) и хранятся в подпапке \ Activities в корневом каталоге CatTools. Каждый файл .ini представляет собой отдельный элемент в раскрывающемся списке «Тип» в форме настройки формы «Добавить / изменить сведения о запланированном действии».

При запуске CatTools ищет все файлы .ini в подпапке \ Activities и считывает их содержимое. После этого все найденные типы действий доступны для выбора в раскрывающемся списке Тип действия при определении действий.

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

Обзор разделов файла .ini

Содержимое.ini разделены на [разделы]. Основные разделы внутри файла INI следующие:

[информация] раздел

Это необходимо и идентифицирует файл .ini как файл CatTools.

 [информация]
cookie = CatTools
версия = 3
author = SolarWinds 

[Действие] раздел

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

 [Активность]
name = Custom.Activity.Template
script_main = Main.Custom.Activity.Template.txt
script_client = Client.Custom.Activity.Template.txt
description = Собирает информацию с устройств и создает настраиваемый отчет.
report_file =% AppPath% Reports \ Master Custom Activity Template.txt
report_overwrite = 1
client_threads = 0
id = 3999 

Хотя имя файла.ini может быть аналогичным (или таким же) элементу имени раздела [Активность] , это элемент имени , который определяет имя действия в пользовательском интерфейсе, а не имя файла .ini.

CatTools резервирует идентификаторы от 0 до 3999 для предопределенных типов действий. Вы можете использовать диапазон номеров от 4000 до 4999 для создаваемых вами настраиваемых типов действий, однако вы должны убедиться, что номер уникален.

[item] разделы (Параметры действий)

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

 [item_value1]
name = Использовать альтернативную команду
тип = строка
checkbox_show = 1
checkbox_default = 0
value_default =
требуется = 0
info = "Альтернативная команда для захвата данных с устройства." 

Каждое поле ввода в пользовательском интерфейсе CatTools для параметров действия имеет отдельный раздел типа [item_xxx] .

  • Элемент name устанавливает текст (или метку), отображаемый рядом с полем ввода или выбора.
  • Элемент типа описывает тип поля ввода или выбора рядом с текстом / меткой имени.
  • Пункты checkbox_show и checkbox_default описывают, должен ли отображаться флажок, и его значение по умолчанию - отмечен или снят.
  • Элемент value_default устанавливает значение по умолчанию, которое будет использоваться при добавлении нового действия в базу данных.
  • Требуемый элемент сообщает пользовательскому интерфейсу, должно ли поле содержать допустимые данные или нет. Например, это должен быть элемент из предопределенного списка или пользователь может вводить свои собственные значения.
    • 0 = не требуется
    • 1 = требуется
  • Информация - это описание, связанное с этим полем. Этот текст отображается в строке состояния пользовательского интерфейса, когда поле находится в фокусе.

Ограничение диапазона значений

Вышеупомянутый раздел [item_value1] является примером флажка и стандартного поля ввода текстового поля в пользовательском интерфейсе. Если вам нужно ограничить диапазон числовых значений, которые можно ввести в поле параметра, используйте тип или диапазон .

Пример варианта диапазона ниже содержит флажок и поле ввода, которое принимает числовые значения от 1 до 2000 .

 [item_value2]
name = Дней до истечения срока действия записей
type = range
checkbox_show = 1
checkbox_default = 0
value_default = 30
range_min = 1
range_max = 2000
требуется = 1
info = "Удалить записи старше X дней из главного отчета" 
Поля ввода флажка

могут принимать только значения 0 или 1 . Любое значение, кроме 1 , считается 0 .

Например, для флажка по умолчанию установлено значение 1 (отмечено).

 [item_value3]
name = Преобразование IP-адресов в имена хостов
type = checkbox
checkbox_show = 1
checkbox_default = 1
info = "Преобразовать все IP-адреса в имена хостов с помощью обратного поиска DNS" 

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

Пользовательский тип действия.ini шаблон

CatTools предоставляет файл шаблона отправной точки, который помогает в создании нового настраиваемого типа деятельности. Файл шаблона называется Custom.Activity.Template.ini и находится во вложенной папке \ Templates . Этот файл шаблона включен как часть предопределенных типов действий в CatTools. Что касается всех предопределенных типов действий CatTools, они могут подвергаться обновлениям и модификациям с каждой новой версией продукта CatTools.

По этой причине вам никогда не следует изменять сам файл шаблона для создания нового настраиваемого типа действия.

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

Создание файла .ini пользовательского типа деятельности

При добавлении нового настраиваемого типа действия в CatTools первым шагом является создание копии файла шаблона Custom.Activity.Template.ini в подпапке \ Templates и сохраните его в подпапке \ Activities, дав ему новое имя файла.

Это дает вам новый файл типа деятельности отправной точки для работы. При именовании файла старайтесь использовать соглашение об именах:

 Custom.Type.Name 
  • Пользовательский : текст «Пользовательский» для отличия пользовательских типов действий от предопределенных типов CatTools. Они сгруппированы вместе в поле раскрывающегося списка действий «Тип».
  • Тип : тип действия, например отчет, интерфейс командной строки, подключение или обновление.
  • Имя : имя действия, например ARPTable, SendCommands, PingTest и BannerText.

Редактирование файла .ini

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

SolarWinds рекомендует оставить все остальное, что не выделено, по умолчанию. Вы можете настроить некоторые элементы, например, «Имя» и «Информация», чтобы они больше соответствовали вашей деятельности.

  • Текстовое значение в элементе Name - это поле Label, которое отображается в форме.
  • Текстовое значение в элементе Info - это текст, который отображается в строке состояния при выборе поля в форме.

После внесения изменений в файл .ini сохраните его во вложенной папке \ Activities . Перезапустите CatTools, чтобы ваш новый пользовательский тип действия был прочитан в поле раскрывающегося списка действий «Тип».

Пример файла .ini

 [информация]
cookie = CatTools
версия = 3
author = SolarWinds  введите свое имя или оставьте значение по умолчанию 

[Деятельность]
name = Custom.Действие: изменение шаблона на уникальное имя действия. пример:  Custom.Report.PortStatus  Примечание: не используйте пробелы.
Используйте знак «точка» (.)
script_main = Main.Custom.Activity.Template.txt  изменить имя связанного основного скрипта (используйте имя действия и префикс с
'Главный.' чтобы сохранить уникальность) 
script_client = Client.Custom.Activity.Template.txt  изменить имя связанного клиентского скрипта (используйте имя действия и префикс
«Клиент». чтобы сохранить уникальность) 
description = Собирает информацию с устройств и создает настраиваемый отчет , при необходимости измените 
report_file =% AppPath% Reports \ Master Custom Activity Template.txt  изменить на уникальное имя отчета 
report_overwrite = 1
client_threads = 0
id = 3999  выберите номер в диапазоне от 4000 до 4999. Используемый здесь номер  должен быть уникальным . 

# Варианты действий
[item_value1]
name = Использовать альтернативную команду
тип = строка
checkbox_show = 1
checkbox_default = 0
edit_button = 0
value_default =
требуется = 0
info = "Альтернативная команда для захвата данных с устройства."

[item_value2]
... добавьте дополнительные элементы параметров по мере необходимости (максимум 10 вариантов). 

Лента активности электронной почты - Twilio

Лента активности электронной почты - Twilio

Пользователи с большим количеством пользователей могут еще не иметь доступа к новому каналу активности электронной почты. Для получения информации о устаревшем ленте активности электронной почты см. Устаревшую активность электронной почты.

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

С помощью канала активности электронной почты вы можете:

  • Ускорьте устранение проблем с доставкой электронной почты с помощью исчерпывающих и последовательных данных о событиях по электронной почте.
  • Легко определяйте определенные электронные письма с помощью расширенного поиска и параметров фильтрации, включая строку темы и метаданные электронной почты.
  • Настройте свои данные самостоятельно с помощью опции загрузки / экспорта CSV.
  • Просматривайте историю за 30 дней при покупке обновления.
  • Вызов всех событий по электронной почте из API при покупке дополнительного хранилища.

Учетные записи посредников и сверхмалые учетные записи не имеют доступа к новому каналу активности электронной почты. Для получения информации об устаревшем ленте активности электронной почты см. Устаревшую активность электронной почты

.

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

Событие Описание
Обработано Запросы от вашего веб-сайта, приложения или почтового клиента через SMTP Relay или API, обработанные SendGrid.
Кликов Каждый раз, когда получатель нажимает одну из ссылок отслеживания кликов в вашем электронном письме. В истории электронной почты SendGrid отображает дату, время и URL-адрес ссылки, по которой была нажата ссылка.
Доставлено Принятый ответ, созданный почтовым сервером получателей.
Открытие Ответ, созданный получателем, открывающим электронное письмо.
Отписался Каждый раз, когда получатель отписывается от ваших писем.
Группа отписалась Каждый раз, когда получатель отменяет подписку на группу подавления.
Группа повторно подписалась Когда получатель повторно подписывается на группу подавления.
Отсроченный Почтовый сервер получателя попросил SendGrid прекратить посылать электронные письма так быстро.
Капли SendGrid отбрасывает электронное письмо, если контакт в этом электронном письме находится в одной из ваших групп подавления, ранее возвращенное электронное письмо получателя или получатель пометил ваше электронное письмо как спам.
Отскок Принимающий сервер не может или не хочет принять сообщение. Если получатель ранее отказался от подписки на ваши электронные письма, ваша попытка отправить ему будет отклонена.
Блоки Когда ваш IP-адрес был заблокирован интернет-провайдером или организацией обмена сообщениями. Блокировки менее серьезны, чем отказы, и не приводят к постоянному подавлению: последующие отправки на заблокированные адреса электронной почты не подавляются автоматически.
Спам-отчеты Каждый раз, когда получатель отмечает ваше письмо как спам, его почтовый сервер сообщает нам об этом.

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

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

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

Для фильтрации по типу событий, как в устаревшем ленте активности электронной почты, используйте Расширенный поиск, выберите Тип события и выберите тип события для фильтрации.

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

  • Идентификатор ключа API
  • Имя ключа API
  • Идентификатор кампании
  • Название кампании
  • Категории
  • Дата обработки
  • Тип события (Bounced, Clicked и т. Д.)
  • С адреса электронной почты
  • Идентификатор сообщения
  • Количество кликов
  • Количество открытий
  • Запрос IP-адреса
  • Отправка IP-адреса
  • Статус (доставлено, не доставлено, обрабатывается)
  • Тема
  • Товарищ по команде
  • На адрес электронной почты
  • Идентификатор шаблона транзакции
  • Название транзакционного шаблона
  • ID группы отказа от подписки
  • Название группы отказа от подписки

Для расширенного поиска:

  1. Вверху страницы канала активности щелкните Расширенный поиск .
  2. В крайнем левом поле выберите критерии для фильтрации данных о событиях.
  3. После того, как вы заполнили все поля, связанные с этим фильтром, щелкните Search . Чтобы добавить дополнительные критерии поиска, нажмите Добавить фильтр .

Чтобы еще больше сузить результаты поиска:

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

Для просмотра истории событий:

  1. Перейдите к событию, которое хотите просмотреть, и щелкните запись. После загрузки записи вы можете щелкнуть по каждому из разделов, чтобы просмотреть более подробную информацию о каждом сообщении электронной почты.
  2. По окончании просмотра данных щелкните Закрыть .

Для экспорта CSV:

  1. В правом верхнем углу ленты действий щелкните Экспорт в CSV . При этом будет отправлено электронное письмо на адрес электронной почты, связанный с вашей учетной записью SendGrid.
  2. Откройте письмо и нажмите Загрузить .

Хотите более глубокие данные и понимание? С помощью отчетов SendGrid Email Insights Reports вы получите доступ к большему количеству данных об эффективности вашей электронной почты, а также к индивидуализированной аналитической информации от консультанта по доставляемости.

Нужна помощь?

Все мы иногда делаем это; код сложен. Получите помощь сейчас от нашей службы поддержки или положитесь на мудрость толпы, просматривающей тег SendGrid на Stack Overflow.

Вы просматриваете устаревшую версию этого SDK.

🎉 Спасибо за отзыв!

Что-то пошло не так. Пожалуйста, попробуйте еще раз.

Спасибо за отзыв!

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

Шаг 1

Получить ссылку

Получите бесплатную персональную реферальную ссылку здесь

Шаг 2

Отдать 10 долларов

Ваш пользователь регистрируется и обновляется по ссылке

Шаг 3

Получи $ 10

1250 бесплатных SMS-сообщений
ИЛИ 1000 бесплатных минут разговора
ИЛИ 12000 чатов
ИЛИ более

.
Опубликовано в категории: Разное

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *