Difference between revisions of "ATC/Current/AdminGuide/Apply"
(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: | ||
− | # | + | #In the '''Apply to selected pages''' section, click '''Add page'''. |
− | #In the | + | #In the list box, click the appropriate {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=operator}}. |
− | #In the | + | #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 | + | #*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 | + | #*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''' | ||
− | {{!}}{{!}}''' | + | {{!}}{{!}}'''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 | {{!}}{{!}}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 <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 57: | Line 70: | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}not equals | {{!}}{{!}}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 <nowiki>http://abc.com</nowiki> OR <nowiki>http://def.com</nowiki> OR <nowiki>https://xyz.com</nowiki><nowiki><br /></nowiki> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | *not equals <nowiki> http://abc.com OR http://def.com OR | ||
'''Incorrect:''' | '''Incorrect:''' | ||
− | *equals abc.com OR def.com | + | *equals abc.com OR def.com |
*equals abc.com AND equals xyz.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. | |
− | This operator is useful when you want to target a unique query string parameter (a keyword) that appears in multiple URLs. | ||
− | |||
'''Correct''': | '''Correct''': | ||
Line 86: | Line 93: | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}not like | {{!}}{{!}}not like | ||
− | {{!}}{{!}} | + | {{!}}{{!}}does not match any of the characters that you specify |
− | |||
{{!}}{{!}} | {{!}}{{!}} | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}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. | {{!}}{{!}}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''': | '''Correct''': | ||
Line 112: | Line 113: | ||
{{!}}{{!}}ends with | {{!}}{{!}}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 | + | {{!}}{{!}}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. | |
− | |||
− | |||
{{!}}} | {{!}}} | ||
|Status=No | |Status=No | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
}}{{Section | }}{{Section | ||
|sectionHeading=Condition errors | |sectionHeading=Condition errors |
Revision as of 16:32, February 10, 2021
Contents
Learn how to specify the webpages where an action map triggers.
Prerequisites
- Configure the following permissions in Genesys Cloud:
- Journey > Action Map > Add, Delete, Edit, and View (to create action maps)
- Journey > Action Target > View (to select a team to handle interactions from the action map)
- Create segments.
- Create outcomes.
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:
- In the Apply to selected pages section, click Add page.
- In the list box, click the appropriate operator.
- In the text box, type the appropriate value (as needed by the operator you selected).
- 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.
- Verify that the expression is valid.ImportantIf 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:
Incorrect:
|
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:
Incorrect:
|
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 | 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:
|
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
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.
AND conditions
Remove a condition
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.
- 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.
- After you specify all the pages to check, click Check.
- Review the results.
- 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.