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

From Genesys Documentation
Jump to: navigation, search
(Published)
(Published)
Line 20: Line 20:
 
|structuredtext=When you {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps|anchor=Create|display text=create an action map}} that uses a {{GlossaryTooltip|term=web action}}, define an expression that determines on which webpages the action map should or should not trigger:
 
|structuredtext=When you {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Action_maps|anchor=Create|display text=create an action map}} that uses a {{GlossaryTooltip|term=web action}}, define an expression that determines on which webpages the action map should or should not trigger:
  
#Under '''Apply to selected pages''', click '''Add page'''.
+
#In the '''Apply to selected pages''' section, click '''Add page'''.
#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}}.
+
#In the list box, click the appropriate {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=operator}}.
#In the '''some path or keyword''' box, type the appropriate value (as needed by the operator you selected).
+
#In the text box, type the appropriate value (as needed by the operator you selected).
 
#Do one of the following:
 
#Do one of the following:
#*To add an OR condition, next to the '''some path or keyword''' box, click the '''+'''. For more information, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=ORConditions|display text=OR conditions}}.
+
#*To add an OR condition, next to the text box, click the '''+'''. For more information, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=ORConditions|display text=OR conditions}}.
#*To add an AND condition, under the boxes, click '''Add'''. For more information, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=ANDConditions|display text=AND conditions}}.<br />
+
#*To add an AND condition, click '''Add AND Condition'''. For more information, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=ANDConditions|display text=AND conditions}}.
#{{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=CheckTargeting|display text=Verify that the expression is valid}}.
+
#{{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=CheckTargeting|display text=Verify that the expression is valid}}.{{NoteFormat|If the action map isn't working as expected, check your URL conditions.|}}
 
|Status=No
 
|Status=No
 
}}{{Section
 
}}{{Section
Line 35: Line 35:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}'''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
{{!}}{{!}}Action map triggers only when the visitor is on a webpage with a URL that exactly matches all of the characters that 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.
+
*equals <nowiki>http://abc.com</nowiki> OR <nowiki>http://def.com</nowiki> OR <nowiki>https://xyz.com</nowiki>
'''Correct''':  
 
  
*equals <nowiki>http://abc.com OR http://def.com OR http://xyz.com </nowiki>
+
'''Incorrect''':
 
 
'''Incorrect''':  
 
  
 
*equals abc.com OR def.com
 
*equals abc.com OR def.com
Line 57: Line 70:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}not equals
 
{{!}}{{!}}not equals
{{!}}{{!}}a full URL only
+
{{!}}{{!}}does not match the full URL exactly as you specify, including case
{{!}}{{!}}Action map triggers only when the visitor is on a webpage with a URL that exactly matches all of the characters that 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
{{!}}{{!}}Action map triggers only when the visitor is on a webpage with a URL that contains some of the characters that 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 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''':
 
'''Correct''':
Line 86: Line 93:
 
{{!}}-
 
{{!}}-
 
{{!}}{{!}}not like
 
{{!}}{{!}}not like
{{!}}{{!}}a "substring match"
+
{{!}}{{!}}does not match any of the characters that you specify
{{!}}{{!}}Action map triggers only when the visitor is on a webpage with a URL that does not contains any of the characters that 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 this 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 112: Line 113:
 
{{!}}{{!}}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 this 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".
  
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.
 
 
{{!}}{{!}}You can have one '''ends with''' operator per condition.
 
 
{{!}}}
 
{{!}}}
 
|Status=No
 
|Status=No
}}{{Section
 
|sectionHeading=GPE-5839 Updates Operators for URL conditions
 
|alignment=Vertical
 
|structuredtext=<br />
 
{{{!}} class="wikitable"
 
{{!}}-
 
{{!}}{{!}}'''Operator'''
 
{{!}}{{!}}'''Matches...'''
 
{{!}}{{!}}'''Notes'''
 
{{!}}-
 
{{!}}contains all
 
{{!}}All the characters that you specify.
 
{{!}}You must specify the protocol, either http: or https:.
 
{{!}}-
 
{{!}}contains any
 
{{!}}Any of the characters that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}does not contain all
 
{{!}}Some, but not all, of the characters that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}does not contain any
 
{{!}}None of the characters that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}{{!}}equals
 
{{!}}{{!}}An exact match to the characters that you specify.
 
{{!}}{{!}}You must specify the protocol, either http: or https:.
 
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>
 
 
'''Incorrect''':
 
 
*equals abc.com OR def.com
 
*equals abc.com AND equals xyz.com
 
{{!}}-
 
{{!}}{{!}}not equals
 
{{!}}{{!}}A full URL.
 
'''Note:''' When used with an action map, the action map triggers only when the visitor is on a webpage with a full URL that matches exactly all the characters that you specify.
 
{{!}}{{!}}You must specify the protocol, either http: or https:.
 
If you define a '''not equals''' condition, you cannot define any other AND conditions.
 
 
'''Correct''':
 
 
*not equals <nowiki> http://abc.com OR http://def.com OR http://xyz.com<br /></nowiki>
 
 
'''Incorrect:'''
 
 
*equals abc.com OR def.com
 
*equals abc.com AND equals xyz.com
 
{{!}}-
 
{{!}}greater than
 
{{!}}Values greater than those that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}greater than or equal
 
{{!}}Values greater than or equal to those that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}less than
 
{{!}}Values less than those that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}less than or equal
 
{{!}}Values less than or equal to those that you specify.
 
{{!}}
 
{{!}}-
 
{{!}}{{!}}starts with
 
{{!}}{{!}}Identical characters starting from the beginning of the string, up to and including the last character in the string.
 
 
 
'''Note:''' Use this operator when your URLs are unvarying (generally) but can include query string parameters at the end that you want to exclude.
 
 
{{!}}{{!}}You must specify the protocol, either http: or https:.
 
You can have one '''starts with '''or one '''ends with''' operator per condition.
 
 
'''Correct''':
 
 
*starts with http://abc.com OR http://xyz.com AND Like keyword1 or keyword2
 
 
'''Incorrect''':
 
 
*starts with abc.com OR xyz.com AND starts with abc.com OR xyz.com
 
{{!}}-
 
{{!}}{{!}}ends with
 
{{!}}{{!}}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 that use "/thankyou.html" at the end of their URLs.
 
{{!}}{{!}}You can have one '''ends with''' operator per condition.
 
{{!}}}
 
|Status=Yes
 
 
}}{{Section
 
}}{{Section
 
|sectionHeading=Condition errors
 
|sectionHeading=Condition errors

Revision as of 16:32, February 10, 2021

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 aNo results, define an expression that determines on which webpages the action map should or should not trigger:

  1. In the Apply to selected pages section, click Add page.
  2. In the list box, click the appropriate operator.
  3. In the text box, type the appropriate value (as needed by the operator you selected).
  4. Do one of the following:
    • To add an OR condition, next to the text box, click the +. For more information, see OR conditions.
    • To add an AND condition, click Add AND Condition. For more information, see AND conditions.
  5. Verify that the expression is valid.
    Important
    If the action map isn't working as expected, check your URL conditions.

Operators for URL conditions

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.

Condition errors

As you define your condition, 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.

OR conditions

You can add as many OR conditions as you need for each operator. For more information on the available operators, see Operators for URL conditions.

Important
If you use an "OR" condition, the action map triggers when either of the conditions is true.

AND conditions

You can add as many AND conditions as you need for each operator. For more information on the available operators, see Operators for URL conditions.
Important
If you use an "AND" condition, the action map triggers only when both conditions are true.

Remove a condition

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 the expression to apply an action map to a webpage, ensure that the expression is valid.

  1. Under Check if the action map targets the web page(s), type the first URL to check in the box.
  2. To check another URL, click + and type the next URL.
  3. After you specify all the pages to check, click Check.
  4. Review the results.

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.

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