Salesforce

Configuring Geolocation Rules

« Go Back
Information
Configuring Geolocation Rules
UUID-1b60bb62-5260-6045-738b-09e4fa27c538
English
Checked
Content

Using Cookie Consent, you can configure geolocation rules that determine the consent model, behaviors, and content that will be shown to site visitors from certain locations. This is done by leveraging Cloudflare to perform a reverse IP lookup that will return the general location of the user (approximately at the city level). The location is not stored and is only used to determine the applicable rule.

From Cloudflare's IP geolocation documentation:

Cloudflare can include the country code of the visitor's IP address (in ISO 3166-1 Alpha 2 format) with each request between Cloudflare and the upstream origin web server. This allows site administrators to capture their visitor's IP location in server logging and/or application logic. Besides ISO country codes, Cloudflare uses the following special country codes:

  • XX - Used for clients without country code data.

  • T1 - Used for clients using the Tor network.

To set up geolocation rules, you first have to set up a geolocation rule group. This will allow you to group geolocation rules in a way that complies with applicable privacy laws. You must have a default geolocation rule group and a default geolocation rule within each geolocation rule group to define the behaviors to use when no other rules apply.

When a script is published, the template and geolocation rule will change to Active. If any changes are made to the geolocation or template, they will revert to Draft. Scripts will either be Draft if unpublished or Published after publishing.

Tip

If you have configured your Company Profile in Athena, the geolocation rule groups will be populated with recommended settings. For more information, see Athena Company Profile.

To add a geolocation rule group

  1. On the Cookie Consent menu, select Geolocation Rules. The Geolocation Rule Groups screen appears.

  2. Click the Create New button. The Create New Rule Group modal appears.

  3. Complete the Rule Group Name, Organization, and optional Description field.

    new_rule_group_modal.png
  4. Click the Create button.

To add a geolocation rule

  1. On the Cookie Consent menu, select Geolocation Rules. The Geolocation Rule Groups screen appears.

  2. Click on the name of the Geolocation Rule Group. The Geolocation Rule Group Details screen appears.

  3. Click the Add Rule button. A new rule is added.

  4. Complete the fields. For more information, see Geolocation Rule Configuration Screen Reference.

  5. Click the Save button.

Geolocation Rule Configuration Screen Reference

geolocation_config_1.png
geolocation_config_2.png

Field

Description

Rule Name

Enter a name for the rule.

Select the regions you like to assign this policy to

Select the geo-locations in which the rule should be applied. This can be regions, countries, or states.

Show Banner

Select this check box to show the banner on the domain for site visitors originating the applicable locations.

Template

Use the text box to search for the Template name. Select a Template to use for the rule.

IAB Purposes (IAB templates only)

Use this section to configure settings for IAB purposes. See the configuration fields below.

Consent Model

Select the consent model you would like to use. For more information, see Consent Models.

consent_model.png

Status

Select the default status for each category or purpose (IAB templates). For more information, see Category Statuses

Do Not Track

Select this check box to enable cookies or purposes (IAB templates) in the category to respond to Do Not Track requests sent by the browser.

Global Privacy Control

Select this check box to enable cookies in the category to respond to Global Privacy Control signals sent by the browser.

Google Consent Mode

Enable this setting to configure how Google tags behave based on the consent status of your users. You can define a storage type for each category.

GCM_categories.png

Behaviors - Close Banner

Select the check boxes for the actions site visitors can use to close the banner.

Behaviors - Accept All Cookies

Select the check boxes for the actions that site visitors can use to accept all cookies.

Enable IAB Europe transparency and consent framework

Enable this setting to include support for IAB Transparency and Consent Framework vendors and purposes.

Vendor Version List

Select the vendor list you want to use.

Set Global EU Consent

Enable this setting to set the EU 3rd party cookie that allows other CMPs to read the preferences set by the site visitor.

Capture Records of Consent

Enable this setting to log records of consent.

Unique Site Visitor ID

Chose how the Consent Records will be tracked.

Use this consent model if site visitor's IP address is unknown.

Enable this setting to make the Geolocation Rule the default rule. If changed, you will need to republish the script for the changes to take effect.

To assign a geolocation rule group to a domain

  1. On the Cookie Consent menu, select Geolocation Rules. The Geolocation Rule Groups screen appears.

  2. Click on the name of the rule group you want to assign. The Geolocation Rule Group Details screen appears.

  3. Go to the Assigned Domains tab.

  4. Click the Assign to Domains button. The Assign to Domains modal appears.

    assign_domains.png
  5. Select the check boxes for the domains you want to assign.

  6. Click the Assign button. The next time you publish the script for your domain, it will adhere to the rules configured in the policy. For more information on publish the script see Implementing Cookie Consent Scripts

To view geolocation rule versions

New versions of geolocation rules are created when an existing geolocation rule is edited and saved.

  1. On the Cookie Consent menu, select Geolocation Rules. The Geolocation Rule Groups screen appears.

  2. Click on the name of the Geolocation Rule Group. The Geolocation Rule Group Details screen appears.

  3. Select a geolocation rule from the list. The geolocation rule configuration appears in the editor.

  4. Click the Show Version History button in the header. The Geolocation Versions pane appears.

  5. View the version history for the geolocation rule.

    geolocation_history.png

To delete a geolocation rule group

  1. On the Cookie Consent menu, select Geolocation Rules. The Geolocation Rule Groups screen appears.

  2. Click the Context Menu icon context_menu_icon_v2.png on the row for the group you want to delete. The Context menu appears.

  3. Select Delete. A confirmation modal appears.

  4. Click the Submit button.

To delete a geolocation rule

Note

You cannot delete the default Geolocation Rule.

  1. On the Cookie Consent menu, select Geolocation Rules. The Geolocation Rule Groups screen appears.

  2. Click on the name of the rule group you want to delete. The Geolocation Rule Group Details screen appears.

  3. Click the Edit icon for the rule. All editable fields display.

  4. Click the Context menu icon. The Context menu appears.

  5. Select Remove Rule. A confirmation modal appears.

  6. Click the Remove button.

Consent Models

Notice Only. If you select Notice Only as the default consent model, all cookie categories will set and cannot be disabled by website visitors. A banner informing the visitor that the website uses cookies will be displayed on the landing page of the website.

Opt-out. If you select Opt-out, all cookie categories (besides Strictly Necessary) will be set to require opt-out. These cookies will be automatically enabled when the visitor lands on the website. The website visitor can disable the non-Strictly Necessary cookies in the preference center.

Opt-in. If you select Opt-in, all cookie categories (besides Strictly Necessary) will be set to opt-in. These cookies will not be set on the visitor's device unless they are enabled in the preference center.

Implied Consent. If you select Implied Consent, all cookie categories (besides Strictly Necessary) will be set to implied consent. These cookies are not set until the website visitor clicks the Accept button or engages in another implied consent behavior. The website visitor can disable cookie categories in the preference center.

Custom. If you select this option, you can set a different default status for each category of cookie on your site. You can customize the consent model to suit your organization's needs and can set the Do Not Track status for each category of cookie.

Category Statuses

For rules that use the Custom consent model, you can select the default status for each category of cookies or vendors. The status indicates the behavior of category and the conditions under which the cookies will be set. The statuses align with the consent models with which they share their names.

Notice Only. Cookies in a Notice Only category are automatically set and will be shown in the preference center, but cannot be disabled by the site visitors. Cookies in a Notice Only category cannot rely on Consent as the legal basis for processing data.

Opt-out. Cookies in an Opt-out category are automatically set and can be disabled by the site visitor in the preference center.

Opt-in. Cookies in an Opt-in category are not set by default and must be proactively selected by the site visitor in the preference center. Opt-in allows for the explicit consent of the site visitor.

Implied Consent. Cookies in an Implied Consent category are set when a site visitor engages in designated implied consent behaviors such acknowledging the banner, scrolling, clicking, or navigating to a new page.

 

Powered by