Difference between revisions of "ATC/Current/AdminGuide/Apply"

From Genesys Documentation
Jump to: navigation, search
(Published)
 
m (Text replacement - "Genesys Cloud" to "Genesys Cloud CX")
 
(29 intermediate revisions by 5 users not shown)
Line 2: Line 2:
 
|Standalone=No
 
|Standalone=No
 
|DisplayName=Apply an action map to specific webpages
 
|DisplayName=Apply an action map to specific webpages
−
|Platform=PureEngage, PureConnect, PureCloud
+
|TocName=Specify webpages to trigger on
−
|TocName=Apply to pages
+
|Context=Learn how to specify the webpages where an action map triggers.
 
|ComingSoon=No
 
|ComingSoon=No
−
|Context=Define the webpages where an action map triggers.
+
|Platform=PureConnect, GenesysCloud, GenesysEngage-cloud
 
|Prereq='''Prerequisites'''
 
|Prereq='''Prerequisites'''
−
* [https://help.mypurecloud.com/articles/altocloud-permissions-overview Configure the following permissions in PureCloud:]
+
 
−
** '''Journey '''>''' Action Map '''>''' Add''', '''Delete''', '''Edit''', and '''View''' permissions (to create action maps)
+
*[https://help.mypurecloud.com/articles/?p=195191 Configure the following permissions in Genesys Cloud CX:]
−
** '''Journey '''>''' Action Target '''> '''View''' permission (to select a team to handle interactions from the action map)
+
**'''Journey '''>''' Action Map '''>''' Add''', '''Delete''', '''Edit''', and '''View''' (to create action maps)
−
* {{#mintydocs_link:topic=Segments|anchor=CreateSegment|link text=Create segments}}.
+
**'''Journey '''>''' Action Target '''> '''View''' (to select a team to handle interactions from the action map)
−
* {{#mintydocs_link:topic=Outcomes|anchor=CreateOutcome|link text=Create outcomes}}.
+
*{{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Manage_segments|display text=Create segments}}.
 +
*{{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Manage_outcomes|display text=Create outcomes}}.
 
|Section={{Section
 
|Section={{Section
 
|sectionHeading=Apply an action map to webpages
 
|sectionHeading=Apply an action map to webpages
−
|Type=Structured
 
 
|alignment=Horizontal
 
|alignment=Horizontal
−
|image=URLconditions.png
+
|Media=Image
−
|gif=No
+
|image=ApplyToWebpages.png
−
|structuredtext=When you {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps|anchor=Create|display text=create an action map}}, apply it to a web page:
+
|structuredtext=When you {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps|display text=create an action map}} that uses a web action, you can define an expression that determines on which webpages the action map should or should not trigger. The expression includes one or more {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=operators}}, a corresponding operand, and one or more {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=Conditions|display text=conditions}}. After you define the expression, {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=CheckTargeting|display text=verify that the expression is valid}}.
−
# Click '''Add page'''.
 
−
# Use the fields to build an expression that tells {{MINTYDOCSPRODUCT}} the web pages where the action map triggers. For information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#URLConditionsOperators|display text=Operators for URL conditions.}}
 
−
# {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#ORConditions|display text=Specify OR conditions.}}  
 
−
# {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#ANDConditions|display text=Specify AND conditions.}}
 
−
|fullwidth=No
 
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
−
|sectionHeading=Specify OR conditions
+
|sectionHeading=About conditions
−
|Type=Structured
+
|anchor=Conditions
−
|anchor=ORConditions
+
|alignment=Vertical
−
|alignment=Horizontal
+
|structuredtext=You can add as many conditions as you need. For OR conditions, the action map triggers when either condition is true. For AND conditions, the action map triggers when both conditions are true.  
−
|image=URLORCondition3.gif
 
−
|gif=No
 
−
|structuredtext=You can add as many OR conditions as you need for each operator.
 
  
−
{{NoteFormat|If you use an "OR" condition, the action map triggers if either of the conditions is true.}}
+
As you define conditions, {{MINTYDOCSPRODUCT}} checks for syntax errors, including a valid protocol, spaces and extra special characters. If there are syntax errors, {{MINTYDOCSPRODUCT}} displays an error message. For more information, see the {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=notes for the operator that you are using}}.{{NoteFormat|If the action map isn't working as expected, check your URL conditions.|}}{{NoteFormat|To remove a condition, rest your mouse on it and then click the '''x''' that appears.|2}}
−
# To add an "OR" condition, click '''Add''' and build the expression. For information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#URLConditionsOperators|display text=Operators for URL conditions.}} If you cannot click '''Add''', adjust your expression and try again.
+
<br />
−
# To remove an "OR" condition, click '''Remove'''.
 
−
|fullwidth=No
 
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
−
|sectionHeading=Specify AND conditions
+
|sectionHeading=Verify that the expression is valid
−
|Type=Structured
+
|anchor=CheckTargeting
−
|anchor=ANDConditions
 
 
|alignment=Horizontal
 
|alignment=Horizontal
−
|image=URLANDcondition.gif
+
|Media=Image
−
|gif=No
+
|image=Verify_conditions.png
−
|structuredtext=You can add as many AND conditions as you need for each operator.{{NoteFormat|If you use an "AND" condition, the action map triggers only if both conditions is true.}}
+
|structuredtext=After you define an expression, ensure that the expression is valid for all the webpages that you specified. Expressions are not case-sensitive. {{NoteFormat|If you see, "No" when you check a webpage, it means that the URL doesn't match the specified conditions. Check your expression:
−
# To add an "AND" condition, click '''Add''' and build the expression you want. For information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#URLConditionsOperators|display text=Operators for URL conditions.}} If you cannot click '''Add''', adjust your expression and try again.
+
* If you are using the '''equals''', or '''not equals''' operators, ensure that you specified a full URL.
−
# To remove an "AND" condition, click '''Remove'''.
+
* If you are using the '''equals''', '''not equals''', or '''starts with''' operators, ensure that you specified the protocol.
−
|fullwidth=No
+
|}}<br />
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
−
|sectionHeading=AI-23 changes: Operators for URL conditions
+
|sectionHeading=Operators for URL conditions
−
|Type=Structured
 
 
|anchor=URLConditionsOperators
 
|anchor=URLConditionsOperators
 
|alignment=Vertical
 
|alignment=Vertical
−
|gif=No
+
|structuredtext=<br />{{NoteFormat|&nbsp;
−
|structuredtext={{{!}} class="wikitable"
+
* Separate a list of values with commas
 +
* Available operators depend on the object type that you are configuring. |2}}
 +
{{{!}} class="wikitable"
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}'''Operator'''
 
{{!}}{{!}}'''Operator'''
−
{{!}}{{!}}'''Matches'''
+
{{!}}{{!}}'''Action map triggers when the page URL...'''
−
{{!}}{{!}}'''Description'''
+
{{!}}{{!}}'''Comments'''
−
{{!}}{{!}}'''Notes'''
+
{{!}}-
 +
{{!}}contains all
 +
{{!}}contains all the characters that you specify
 +
{{!}}
 +
{{!}}-
 +
{{!}}contains any
 +
{{!}}contains one or more characters that you specify
 +
{{!}}
 +
{{!}}-
 +
{{!}}does not contain all
 +
{{!}}does not contain all the characters that you specify
 +
{{!}}
 +
{{!}}-
 +
{{!}}does not contain any
 +
{{!}}does not contain any of the characters that you specify
 +
{{!}}
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}equals
 
{{!}}{{!}}equals
 +
{{!}}{{!}}matches the full URL that you specify exactly, including case
 +
{{!}}{{!}}Specify the full URL, including the protocol; either "http:" or "https:".
  
 +
If you define an '''equals''' condition, you cannot define an AND condition.
  
−
not equals
+
'''Correct''':
  
 +
*equals <nowiki>http://abc.com</nowiki> OR <nowiki>http://def.com</nowiki> OR <nowiki>https://xyz.com</nowiki>
  
 +
'''Incorrect''':
  
 +
*equals abc.com OR def.com
 +
*equals abc.com AND equals xyz.com
 +
{{!}}-
 +
{{!}}{{!}}not equals
 +
{{!}}{{!}}does not match the full URL exactly as you specify, including case
 +
{{!}}{{!}}Specify the full URL, including the protocol; either "http:" or "https:".
 +
If you define a '''not equals''' condition, you cannot define an AND condition.
  
−
{{!}}{{!}}a full URL only
+
'''Correct''':
−
{{!}}{{!}}The action map triggers only when the visitor is on a website page with a URL that exactly matches all of the characters you define.
 
−
{{!}}{{!}}If you define an'''equals'''condition you cannot define any other AND conditions.
 
−
 
 
−
 
 
−
'''Correct''': equals abc.com OR def.com OR xyz.com
 
  
 +
*not equals  <nowiki>http://abc.com</nowiki> OR <nowiki>http://def.com</nowiki> OR <nowiki>https://xyz.com</nowiki><nowiki><br /></nowiki>
  
−
'''Incorrect''': equals abc.com AND equals xyz.com
+
'''Incorrect:'''
−
 
 
  
 +
*equals abc.com OR def.com
 +
*equals abc.com AND equals xyz.com
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}like
 
{{!}}{{!}}like
 +
{{!}}{{!}}matches some of the characters that you specify
 +
{{!}}{{!}}This operator is useful when you want to target a unique query string parameter (a keyword) that appears in multiple URLs.
 +
You can define conditions containing multiple '''like''' and '''not like''' operators.
  
 +
'''Correct''':
  
−
not like
+
*like insurance AND like auto OR home OR health
−
 
+
{{!}}-
−
 
+
{{!}}{{!}}not like
−
{{!}}{{!}}a "substring match"
+
{{!}}{{!}}does not match any of the characters that you specify
−
{{!}}{{!}}The action map triggers only when the visitor is on a website page with a URL that contains some of the characters you define.
+
{{!}}{{!}}
−
 
 
−
 
 
−
This is useful when you want to target a unique query string parameter that appears in multiple URLs.
 
−
{{!}}{{!}}You can build conditions containing multiple'''like'''and'''not like'''operators.
 
−
 
 
−
 
 
−
'''Correct''': Like insurance AND Like auto OR home OR health
 
−
 
 
  
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}starts with
 
{{!}}{{!}}starts with
 +
{{!}}{{!}}matches the characters that you specify, starting from the beginning of the string, up to and including the last character in the string
 +
{{!}}{{!}}Use this operator when your URLs are generally unvarying but can include query string parameters at the end that you want to exclude.
 +
Specify the protocol; either "http:" or "https:". You can have one '''starts with '''or one '''ends with''' operator per condition.
  
 +
'''Correct''':
  
−
ends with
+
*starts with http://abc.com OR http://xyz.com AND Like keyword1 or keyword2
  
 +
'''Incorrect''':
  
−
{{!}}{{!}}identical characters starting from the beginning of the string up to and including the last character in the string you specify
+
*starts with abc.com OR xyz.com AND starts with abc.com OR xyz.com
−
{{!}}{{!}}Use the StartsWith match type when your URLs are generally unvarying but can include query string parameters at the end that you want to exclude.
 
−
 
 
−
 
 
−
For example, you can target shopping cart pages that use /thankyou.html at the end of their URLs.
 
−
 
 
−
 
 
−
{{!}}{{!}}You can have one'''starts with'''or one'''ends with'''operator per condition.
 
  
 +
{{!}}-
 +
{{!}}{{!}}ends with
  
−
'''Correct''': Starts with abc.com OR xyz.com AND Like keyword1 or keyword2
+
{{!}}{{!}}matches the characters that you specify, starting from the end of the string, up to and including the first character in the string
−
 
+
{{!}}{{!}}Use this operator when you want to match a specific query string parameter at the end of the URL.
−
 
+
For example, you can match shopping cart pages with URLs that end with "/thankyou.html".
−
'''Incorrect''': Starts with abc.com OR xyz.com AND Starts with abc.com OR xyz.com
 
−
 
 
  
 +
You can have one '''ends with''' operator per condition.
 
{{!}}}
 
{{!}}}
−
|fullwidth=No
+
|Status=No
−
|Status=Yes
 
−
}}
 
 
}}
 
}}
 
}}
 
}}

Latest revision as of 21:28, November 9, 2021

This topic is part of the manual Genesys Predictive Engagement Administrator's Guide for version Current of Genesys Predictive Engagement.

Learn how to specify the webpages where an action map triggers.

Prerequisites

Apply an action map to webpages

When you create an action map that uses a web action, you can define an expression that determines on which webpages the action map should or should not trigger. The expression includes one or more operators, a corresponding operand, and one or more conditions. After you define the expression, verify that the expression is valid.

About conditions

You can add as many conditions as you need. For OR conditions, the action map triggers when either condition is true. For AND conditions, the action map triggers when both conditions are true.

As you define conditions, Genesys Predictive Engagement checks for syntax errors, including a valid protocol, spaces and extra special characters. If there are syntax errors, Genesys Predictive Engagement displays an error message. For more information, see the notes for the operator that you are using.
Important
If the action map isn't working as expected, check your URL conditions.
Tip
To remove a condition, rest your mouse on it and then click the x that appears.


Verify that the expression is valid

After you define an expression, ensure that the expression is valid for all the webpages that you specified. Expressions are not case-sensitive.
Important
If you see, "No" when you check a webpage, it means that the URL doesn't match the specified conditions. Check your expression:
  • If you are using the equals, or not equals operators, ensure that you specified a full URL.
  • If you are using the equals, not equals, or starts with operators, ensure that you specified the protocol.

Operators for URL conditions


Tip
 
  • Separate a list of values with commas
  • Available operators depend on the object type that you are configuring.
Operator Action map triggers when the page URL... Comments
contains all contains all the characters that you specify
contains any contains one or more characters that you specify
does not contain all does not contain all the characters that you specify
does not contain any does not contain any of the characters that you specify
equals matches the full URL that you specify exactly, including case Specify the full URL, including the protocol; either "http:" or "https:".

If you define an equals condition, you cannot define an AND condition.

Correct:

  • equals http://abc.com OR http://def.com OR https://xyz.com

Incorrect:

  • equals abc.com OR def.com
  • equals abc.com AND equals xyz.com
not equals does not match the full URL exactly as you specify, including case Specify the full URL, including the protocol; either "http:" or "https:".

If you define a not equals condition, you cannot define an AND condition.

Correct:

  • not equals http://abc.com OR http://def.com OR https://xyz.com<br />

Incorrect:

  • equals abc.com OR def.com
  • equals abc.com AND equals xyz.com
like matches some of the characters that you specify This operator is useful when you want to target a unique query string parameter (a keyword) that appears in multiple URLs.

You can define conditions containing multiple like and not like operators.

Correct:

  • like insurance AND like auto OR home OR health
not like does not match any of the characters that you specify
starts with matches the characters that you specify, starting from the beginning of the string, up to and including the last character in the string Use this operator when your URLs are generally unvarying but can include query string parameters at the end that you want to exclude.

Specify the protocol; either "http:" or "https:". You can have one starts with or one ends with operator per condition.

Correct:

Incorrect:

  • starts with abc.com OR xyz.com AND starts with abc.com OR xyz.com
ends with matches the characters that you specify, starting from the end of the string, up to and including the first character in the string Use this operator when you want to match a specific query string parameter at the end of the URL.

For example, you can match shopping cart pages with URLs that end with "/thankyou.html".

You can have one ends with operator per condition.

Retrieved from "https://all.docs.genesys.com/ATC/Current/AdminGuide/Apply (2024-10-06 22:44:48)"
Comments or questions about this documentation? Contact us for support!