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")
 
(26 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=Learn how to specify 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:]
+
*[https://help.mypurecloud.com/articles/?p=195191 Configure the following permissions in Genesys Cloud CX:]
−
**'''Journey '''>''' Action Map '''>''' Add''', '''Delete''', '''Edit''', and '''View''' permissions (to create action maps)
+
**'''Journey '''>''' Action Map '''>''' Add''', '''Delete''', '''Edit''', and '''View''' (to create action maps)
−
**'''Journey '''>''' Action Target '''> '''View''' permission (to select a team to handle interactions from the action map)
+
**'''Journey '''>''' Action Target '''> '''View''' (to select a team to handle interactions from the action map)
−
*{{#mintydocs_link:topic=Segments|anchor=CreateSegment|link text=Create segments}}.
+
*{{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Manage_segments|display text=Create segments}}.
−
*{{#mintydocs_link:topic=Outcomes|anchor=CreateOutcome|link text=Create outcomes}}.
+
*{{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=PageChecker1.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}}, build an expression that determines on which webpages the action map can trigger:
+
|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}}.
 +
|Status=No
 +
}}{{Section
 +
|sectionHeading=About conditions
 +
|anchor=Conditions
 +
|alignment=Vertical
 +
|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.
  
−
#Under '''Apply to selected pages''', click '''Add page'''.
+
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}}
−
#In the '''Show this action map if the page URL''' list, select the appropriate {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=operator}}.
+
<br />
−
#In the '''some path or keyword''' box, type the appropriate value (as needed by the operator you selected).
+
|Status=No
−
#Do one of the following:
+
}}{{Section
−
#*To add an OR condition, next to the '''some path or keyword''' box, click the '''+'''. For more information, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#ORConditions|display text=OR conditions}}.
+
|sectionHeading=Verify that the expression is valid
−
#*To add an AND condition, under the boxes, click '''Add'''. For more information, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps#ANDConditions|display text=AND conditions}}.<br />
+
|anchor=CheckTargeting
−
#{{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=CheckTargeting|display text=Verify that the expression is valid}}.
+
|alignment=Horizontal
−
|fullwidth=No
+
|Media=Image
 +
|image=Verify_conditions.png
 +
|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:
 +
* 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.
 +
|}}<br />
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
 
|sectionHeading=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
−
{{!}}{{!}}a full URL only
+
{{!}}{{!}}matches the full URL that you specify exactly, including case
−
{{!}}{{!}}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.
+
{{!}}{{!}}Specify the full URL, including the protocol; either "http:" or "https:".
  
 +
If you define an '''equals''' condition, you cannot define an AND condition.
  
−
'''Note:''' You must specify the protocol, either http: or https:.
+
'''Correct''':
−
 
 
−
{{!}}{{!}}If you define an '''equals''' condition you cannot define any other AND conditions.
 
−
'''Correct''':  
 
  
−
*equals <nowiki>http://abc.com OR http://def.com OR http://xyz.com </nowiki>
+
*equals <nowiki>http://abc.com</nowiki> OR <nowiki>http://def.com</nowiki> OR <nowiki>https://xyz.com</nowiki>
  
−
'''Incorrect''':  
+
'''Incorrect''':
  
 
*equals abc.com OR def.com
 
*equals abc.com OR def.com
Line 61: Line 85:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}not equals
 
{{!}}{{!}}not equals
−
{{!}}{{!}}a full URL only
+
{{!}}{{!}}does not match the full URL exactly as you specify, including case
−
{{!}}{{!}}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.
+
{{!}}{{!}}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''':
  
−
'''Note:''' You must specify the protocol, either http: or https:.
+
*not equals <nowiki>http://abc.com</nowiki> OR <nowiki>http://def.com</nowiki> OR <nowiki>https://xyz.com</nowiki><nowiki><br /></nowiki>
−
 
 
−
{{!}}{{!}}If you define a '''not equals''' condition you cannot define any other AND conditions.
 
−
 
 
−
<br />'''Correct''':
 
−
 
 
−
*not equals <nowiki> http://abc.com OR http://def.com OR http://xyz.com<br /></nowiki>
 
  
 
'''Incorrect:'''
 
'''Incorrect:'''
  
−
*equals abc.com OR def.com<br />
+
*equals abc.com OR def.com
 
*equals abc.com AND equals xyz.com
 
*equals abc.com AND equals xyz.com
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}like
 
{{!}}{{!}}like
−
{{!}}{{!}}a "substring match"
+
{{!}}{{!}}matches some 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 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.
−
 
 
−
 
 
−
 
 
−
This is useful when you want to target a unique query string parameter (a keyword) that appears in multiple URLs.
 
−
{{!}}{{!}}You can build conditions containing multiple '''like''' and '''not like''' operators.
 
  
 
'''Correct''':
 
'''Correct''':
Line 93: Line 108:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}not like
 
{{!}}{{!}}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 does not contains any of the characters you define.<br />
 
 
{{!}}{{!}}
 
{{!}}{{!}}
  
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}starts with
 
{{!}}{{!}}starts with
−
{{!}}{{!}}identical characters starting from the beginning of the string up to and including the last character in the string
+
{{!}}{{!}}matches the characters that you specify, starting from the beginning of the string, up to and including the last character in the string
−
{{!}}{{!}}Use the '''starts with''' operator when your URLs are generally unvarying but can include query string parameters at the end that you want to exclude.
+
{{!}}{{!}}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.
−
 
 
−
'''Note:''' You must specify the protocol, either http: or https:.
 
−
 
 
−
{{!}}{{!}}You can have one '''starts with '''or one '''ends with''' operator per condition.
 
−
 
 
  
 
'''Correct''':  
 
'''Correct''':  
Line 119: Line 128:
 
{{!}}{{!}}ends with
 
{{!}}{{!}}ends with
  
−
{{!}}{{!}}identical characters starting from the end of the string up to and including the first character in the string
+
{{!}}{{!}}matches the characters that you specify, starting from the end of the string, up to and including the first character in the string
−
{{!}}{{!}}Use the '''ends with''' operator when you want to match a specific query string parameters at the end of the URL.
+
{{!}}{{!}}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.
−
 
 
−
 
 
−
For example, you can match shopping cart pages that use /thankyou.html at the end of their URLs.
 
−
 
 
−
{{!}}{{!}}You can have one '''ends with''' operator per condition.
 
 
{{!}}}
 
{{!}}}
−
|fullwidth=No
 
−
|Status=No
 
−
}}{{Section
 
−
|sectionHeading=OR conditions
 
−
|Type=Structured
 
−
|anchor=ORConditions
 
−
|alignment=Horizontal
 
−
|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.}}
 
−
 
−
#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.
 
−
#To remove an "OR" condition, click '''Remove'''.
 
−
|fullwidth=No
 
−
|Status=No
 
−
}}{{Section
 
−
|sectionHeading=AND conditions
 
−
|Type=Structured
 
−
|anchor=ANDConditions
 
−
|alignment=Horizontal
 
−
|image=URLANDcondition.gif
 
−
|gif=No
 
−
|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.}}
 
−
 
−
#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.}} <br />{{NoteFormat|If you cannot add an AND condition, delete any empty OR conditions and then try again. }}
 
−
#To remove an "AND" condition, click '''Remove'''.
 
−
|fullwidth=No
 
−
|Status=No
 
−
}}{{Section
 
−
|sectionHeading=Verify that the expression is valid
 
−
|Type=Structured
 
−
|anchor=CheckTargeting
 
−
|alignment=Horizontal
 
−
|image=PageCheckerAI155.png
 
−
|gif=No
 
−
|structuredtext=After you define the expression to apply an action map to a webpage, check to be sure that the expression is valid.
 
−
 
−
# Under '''Check if the action map targets the web page(s'''), type the first URL to check in the box.
 
−
# To check another URL, click '''+''' and type the next URL.
 
−
# When you have specified all of the pages to check, click '''Check'''.
 
−
# Review the results.<p>
 
−
{{NoteFormat|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, be sure you have specified a full URL.
 
−
* If you are using the '''equals''', '''not equals''', or '''starts with''' operators, be sure you have specified the protocol.
 
−
}}<br />
 
−
|fullwidth=No
 
 
|Status=No
 
|Status=No
 
}}
 
}}
 
}}
 
}}

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:43:41)"
Comments or questions about this documentation? Contact us for support!