Difference between revisions of "ATC/Current/AdminGuide/Apply"
Harleyvibes (talk | contribs) (Published) |
Harleyvibes (talk | contribs) (Published) |
||
Line 137: | Line 137: | ||
{{!}}- | {{!}}- | ||
{{!}}contains all | {{!}}contains all | ||
− | {{!}}all | + | {{!}}all the characters that you specify |
{{!}}You must specify the protocol, either http: or https:. | {{!}}You must specify the protocol, either http: or https:. | ||
{{!}}- | {{!}}- | ||
{{!}}contains any | {{!}}contains any | ||
− | {{!}}any of the characters you specify | + | {{!}}any of the characters that you specify |
{{!}} | {{!}} | ||
{{!}}- | {{!}}- | ||
{{!}}does not contain all | {{!}}does not contain all | ||
− | {{!}}some, but not all, of the characters you specify<br /> | + | {{!}}some, but not all, of the characters that you specify<br /> |
{{!}} | {{!}} | ||
{{!}}- | {{!}}- | ||
{{!}}does not contain any | {{!}}does not contain any | ||
− | {{!}}none of the characters you specify | + | {{!}}none of the characters that you specify |
{{!}} | {{!}} | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}equals | {{!}}{{!}}equals | ||
− | {{!}}{{!}}an exact match to the characters you specify<br /> | + | {{!}}{{!}}an exact match to the characters that you specify<br /> |
{{!}}{{!}}You must specify the protocol, either http: or https:. | {{!}}{{!}}You must specify the protocol, either http: or https:. | ||
− | If you define an '''equals''' condition you cannot define any other AND conditions. | + | If you define an '''equals''' condition, you cannot define any other AND conditions. |
'''Correct''': | '''Correct''': | ||
Line 167: | Line 167: | ||
{{!}}{{!}}not equals | {{!}}{{!}}not equals | ||
{{!}}{{!}}A full URL. | {{!}}{{!}}A full URL. | ||
− | '''Note:''' When used with you an action map, the action map triggers only when the visitor is on a | + | '''Note:''' When used with you 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:. | {{!}}{{!}}You must specify the protocol, either http: or https:. | ||
− | If you define a '''not equals''' condition you cannot define any other AND conditions. | + | If you define a '''not equals''' condition, you cannot define any other AND conditions. |
'''Correct''': | '''Correct''': | ||
Line 199: | Line 199: | ||
− | '''Note:''' Use the '''starts with''' operator when your URLs are generally | + | '''Note:''' Use the '''starts with''' 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 must specify the protocol, either http: or https:. | ||
Line 212: | Line 212: | ||
{{!}}- | {{!}}- | ||
{{!}}{{!}}ends with | {{!}}{{!}}ends with | ||
− | {{!}}{{!}}Use the '''ends with''' operator when you want to match a specific query string | + | {{!}}{{!}}Use the '''ends with''' 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. | 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. | ||
Line 223: | Line 223: | ||
|Media=Image | |Media=Image | ||
|image=ErrorCond.png | |image=ErrorCond.png | ||
− | |structuredtext=As you build your condition, {{MINTYDOCSPRODUCT}} | + | |structuredtext=As you build your condition, {{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 you are using}}. |
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
Line 231: | Line 231: | ||
|Media=Image | |Media=Image | ||
|image=URLORCondition.png | |image=URLORCondition.png | ||
− | |structuredtext=You can add as many OR conditions as you need for each operator. For information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=Operators for URL conditions}}. | + | |structuredtext=You can add as many OR conditions as you need for each operator. For more information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=Operators for URL conditions}}. |
− | {{NoteFormat|If you use an "OR" condition, the action map triggers | + | {{NoteFormat|If you use an "OR" condition, the action map triggers when either of the conditions is true.|}} |
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
Line 241: | Line 241: | ||
|Media=Image | |Media=Image | ||
|image=URLAND.png | |image=URLAND.png | ||
− | |structuredtext=You can add as many AND conditions as you need for each operator. For information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=Operators for URL conditions}}. {{NoteFormat|If you use an "AND" condition, the action map triggers only | + | |structuredtext=You can add as many AND conditions as you need for each operator. For more information on the available operators, see {{Link-SomewhereInThisVersion|manual=AdminGuide|topic=Apply|anchor=URLConditionsOperators|display text=Operators for URL conditions}}. {{NoteFormat|If you use an "AND" condition, the action map triggers only when both conditions is true.|}} |
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
Line 249: | Line 249: | ||
|Media=Image | |Media=Image | ||
|image=CondRemove.png | |image=CondRemove.png | ||
− | |structuredtext=To remove a condition, | + | |structuredtext=To remove a condition, rest your mouse on it and then click the '''x''' that appears. |
|Status=No | |Status=No | ||
}}{{Section | }}{{Section | ||
Line 257: | Line 257: | ||
|Media=Image | |Media=Image | ||
|image=PageCheckerAI155.png | |image=PageCheckerAI155.png | ||
− | |structuredtext=After you define the expression to apply an action map to a webpage, | + | |structuredtext=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. | #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. | #To check another URL, click '''+''' and type the next URL. | ||
− | # | + | #After you specify all the pages to check, click '''Check'''. |
#Review the results.<p> | #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: | {{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, | + | * 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, | + | * If you are using the '''equals''', '''not equals''', or '''starts with''' operators, ensure that you specified the protocol. |
− | }}<br /> | + | |}}<br /> |
|Status=No | |Status=No | ||
}} | }} | ||
}} | }} |
Revision as of 12:17, October 15, 2020
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, build 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 Show this action map if the page URL list, select the appropriate operator.
- In the some path or keyword 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 some path or keyword box, click the +. For more information, see OR conditions.
- To add an AND condition, under the boxes, click Add. For more information, see AND conditions.
- Verify that the expression is valid.
Operators for URL conditions
Operator | Matches | Description | Notes |
equals | a full URL only | 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:
Incorrect:
|
not equals | a full URL only | 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 a not equals condition you cannot define any other AND conditions.
Incorrect:
|
like | a "substring match" | The action map triggers only when the visitor is on a website page with a URL that contains some of the characters you define.
|
You can build conditions containing multiple like and not like operators.
Correct:
|
not like | a "substring match" | 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. |
|
starts with | identical characters 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.
|
You can have one starts with or one ends with operator per condition.
Incorrect:
|
ends with | identical characters 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.
|
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.