The Kentico Online Marketing solution simplifies sophisticated digital marketing. The system provides an amazing out of the box feature set. But what if you need to integrate or customize the Kentico feature set? Attend this webinar, hosted by Kentico MVP Brian McKeiver, to find out how. During the Kentico EMS API deep dive session, Brian will illustrate code samples for how to customize and extend the system in an upgrade safe way utilizing the Kentico API. Attend this session to learn how to best use the Kentico EMS API. What's covered during webinar is listed below: The basics – What does Kentico 8.2 offer? First steps to customize - Registering Custom Classes Create Campaigns and Conversions Programmatically Activity Tracking - Creating Custom Activity types Marketing Automation - Creating Custom Steps and Actions Important Kentico K# Macros for Scoring, Automation, and Personalization A few quick Kentico Marketing Solution Optimizations For more information see my blog post at http://www.mcbeev.com/Blog/August-2015/I-m-Presenting-at-the-Next-Kentico-User-Group-Webinar By Brian McKeiver Co-Owner @ BizStream Kentico MVP http://www.mcbeev.com

1. Kentico EMS API Deep Dive
by Brian McKeiver, Kentico MVP & Co-Owner at BizStream
part of the Kentico User Group webinar series

2. Let’s Get This Party Started
http://kenticousergroup.org/

3. Goals
• Gain familiarity with the Online Marketing API in Kentico
• Work within the Kentico framework and not around it
• Take away a few tips for Kentico optimization

4. Base Assumptions
• Intermediate to advanced experience with C#
• Intermediate to advanced experience with Kentico API
• Understand core pattern of InfoObject and InfoProvider
UserInfo u= UserInfoProvider.GetUserInfo(“mcbeev”);

5. Kentico Online Marketing Feature Set

6. The First Thing To Know
Make it upgrade safe!
Isolate your code away from Kentico’s code
Register classes or ModuleLoaders using the Kentico convention:
http://www.mcbeev.com/.../Registering-Custom-Classes-in-Kentico-8

7. Web Analytics

8. Log Via JavaScript
1. Server adds
JavaScript
snippet to page
3. Web service logs hits
asynchronously
2. Page executing async call
to Kentico web service (using
JavaScript)
4. Hits processed
standard way
version 7.0.17 or newer!
Enabled by default in 8.x!

9. API BasicsCMS.WebAnalytics contains most of the APIs you need.

10. Demo

11. Custom Metrics for Web Analytics
Don’t forget you can make your own Custom Report since (4.x)
with a custom set of Custom Metrics if you need them
Examples:
Emails sent per month
New user sign-ups per week
https://docs.kentico.com/display/K82/Creating+reports

12. Activity Tracking

13. Website Behavior

14. Custom Activity Tracking

15. Result
http://www.mcbeev.com/.../How-to-Connect-Comments-to-Kentico-Activity-Tracking

16. Marketing
Automation

17. Marketing Automation Process
Action

18. Contact Actions
ContactAutomationAction gives you the Contact context you need
http://www.mcbeev.com/.../Kentico-8-Marketing-Automation-Sample-Code-Snippets

19. Contact Actions
AutomationAction gives you the no context but (in theory) is faster to execute. Use this for general
actions that don’t need the current contact data.
http://www.mcbeev.com/.../Kentico-8-Marketing-Automation-Sample-Code-Snippets

20. Custom Triggers
https://docs.kentico.com/.../Handling+marketing+automation+triggers
http://www.mcbeev.com/.../Increase-Subscribers-with-Marketing-Automation
using CMS.Base;
using CMS.Automation;
using CMS.DataEngine;
using CMS.OnlineForms;
using CMS.OnlineMarketing;
using CMS.WebAnalytics;
[TriggerHandler]
public partial class CMSModuleLoader
{
/// <summary>
/// Custom attribute class
/// </summary>
private class TriggerHandler : CMSLoaderAttribute
{
/// <summary>
/// Called automatically when the application starts
/// </summary>
public override void Init()
{
// Assigns a handler to the AutomationEvents.ProcessTrigger.Before event
AutomationEvents.ProcessTrigger.Before += ProcessTrigger_Before;
}
}
}

21. Macros

22. Macros – Personas / Groups
OnlineMarketingContext.CurrentContact
.GetPersona()
OnlineMarketingContext.CurrentContact
.IsInPersona(“DigitalMarketer”)
OnlineMarketingContext.CurrentContact
.IsInContactGroup(“USAContacts")
{% PersonaDocumentWhereCondition %}

23. Macros – Scoring
OnlineMarketingContext.CurrentContact.GetScore("ClickedLinkInNewsletter")

24. More Useful Macros
OnlineMarketingContext.CurrentContact.FirstActivityOfType(“formsubmission")
OnlineMarketingContext.CurrentContact.LastActivityOfType(“formsubmission")
OnlineMarketingContext.CurrentContact.Orders.Exists(OrderTotalPrice > 42.42)
And more…
https://docs.kentico.com/display/K82/On-line+marketing+macros

25. Macros – High Volume Scoring/Groups
“By default in 8.x, custom macro rules that are used in scoring and
contact group conditions evaluate individually for each contact”
– slow for high volume of contacts

26. The Issue

27. Macro Rule Translator to the Rescue
How to Resolve - K82 Docs Link
1. Create a new macro rule in admin
2. Create custom macro rule translator class
3. Macro rule translator logic needs to return ObjectQuery<ContactInfo>
4. Register an instance of MacroRuleMetadata - tells the system to run recalculate on specific
Activity or Attribute only

28. Macro Rule

29. Demo time

30. Result

31. Proof

32. Ouch

33. Conclusion

34. Remember
• We learned about the Online Marketing API in Kentico
• How to work within the Kentico framework
• Saw a few tips for Kentico optimization

35. Q&A
?

36. Next Round Sign up for the next webinar by Avastone on Sept 16.
http://kenticousergroup.org/

37. Brian McKeiver, Co-Owner, BizStream
Phone: (616) 481-1631
E-mail: brian@bizstream.com
@mcbeev
www.linkedin.com/in/brianmckeiver