ÃÛ¶¹ÊÓƵ

In Customer Journey Analytics, select Data Management > Data views.

On the Data views page, select the data view that contains data that you want to analyze in the map visualization.

Select the Components tab.

(Conditional) If you are using the Web SDK and you have configured latitude and longitude to be populated in your data stream, or if you are using the Analytics Source Connector to populate event data, then latitude and longitude fields should already be available in your schema and populated with the correct context labels.

Locate these Latitude and Longitude schema fields (in Event datasets > placeContext > geo > _schema) and drag them into your data view as dimensions if they aren’t already present.

When these schema fields exist as dimensions in your data view, their context labels are automatically applied, and the map visualization uses them without any additional configuration.

(Conditional) If you have custom dimensions that you want to use for latitude and longitude data, you can configure the context labels on the custom fields:

1. In the Dimensions section, select the dimension that contains the longitude data.

2. In the Component settings section in the right rail, in the Context labels field, begin typing Longitude, then select it from the drop-down menu.

   

3. Repeat this process to add the Latitude context label to the dimension that contains the latitude data.

4. (Optional) By default, these dimensions are precise to the town or zip code level in the map visualization, and they show 2 decimal places in Workspace reports. You can adjust them to be precise within a single meter in the map visualization and to show 5 decimal places in Workspace reports. For more information about how to adjust the precision level, see Configure precise locations for dimensions.

Select Save and continue > Save and finish.

In Customer Journey Analytics, select Data Management > Data views.

On the Data views page, select the data view that contains data that you want to analyze with pre-built templates that use the map visualization. In this data view, pick five dimensions: one with the country data, one with the region data, one with the city data, one with the state data, and one with the DMA data. Then, label those dimensions with the corresponding context label.

Select the Components tab.

(Conditional) If you are using the Web SDK and you have configured geo fields to be populated in your data stream, or if you are using the Analytics Source Connector to populate event data, then geo fields should already be available in your schema and populated with the correct context labels.

Locate the appropriate schema fields, such as City, Postal code, State or province (in Event datasets > placeContext > geo), then drag them into your data view as dimensions if they aren’t already present.

When these schema fields exist as dimensions in your data view, their context labels are automatically applied, and the geo templates use them without any additional configuration.

(Conditional) If you have custom dimensions that you want to use for geo data, you can configure the context labels on the custom fields:

1. Select the dimension that contains the country data.

2. In the Component settings section in the right rail, in the Context labels field, begin typing Geo Country, then select it from the drop-down menu.

   

3. Repeat this process to add the Geo: Geo Region, Geo: Geo City, Geo: Geo State, and Geo: Dma context label to each dimension that contains the corresponding data.

Select Save and continue > Save and finish.

Select the Visualizations icon in the left rail, then drag the Map visualization into a panel that contains a freeform table.

Or

Add a map visualization in any of the ways described in the Add visualizations to a panel section in Visualizations overview.

{width="50%"}

Specify the following basic information to configure the map visualization:

• Add metric: In the metric drop-down list, select a metric or calculated metric. (You can also drag a metric from the left rail.)

  note important
  IMPORTANT
  If you choose a metric that has attribution applied, the same attribution is applied to the latitude and longitude pairs within the map visualization’s current viewport.

• Add segment: (Optional) In the segment drop-down list, select a segment. Or drag in a segment from the list of segments.

You can update this information after the visualization is built by selecting the Edit icon in the visualization header.

Select Build.

A world map visualization with bubbles is generated.

Continue with View a map visualization and Configure visualization settings.

If you haven’t already, build a map visualization as described in Build a map visualization.

In the map visualization in Analysis Workspace, do any of the following:

• Zoom in: You can zoom in on the map to magnify certain areas in any of the following ways:

  • Double-click the map with your mouse.

  • Use your mouse scroll wheel or similar action on your trackpad.

  • Select the plus icon on the map visualization.

  The map zooms accordingly. The required dimension (country > state > city) is automatically updated, based on the zoom level.

• Zoom out: You can zoom out on the map to view larger areas in any of the following ways:

  • Hold the Shift key and double-click the map with your mouse.

  • Use your mouse scroll wheel or similar action on your trackpad.

  • Select the minus icon on the map visualization.

  The map zooms accordingly. The required dimension (country > state > city) is automatically updated, based on the zoom level.

• Rotate: You can rotate the map in 2D or 3D by holding the Ctrl key while dragging the map with your mouse.

  To reset the map to its original north alignment, select the compass icon .

• Selection tool: You can select an area of the map to create a segment, create a trend, or add a breakdown.

  Click the selection tool , then drag your mouse to select the desired area.

• Compare: You can compare two or more map visualizations in the same project by placing them side by side.

• Show period-over-period comparisons (such as year-over-year):

  • Show negative numbers.

    For example, if you are plotting a year-over-year metric, the map can show -33% over New York.

  • With metrics that are of type percent, clustering averages the percentages together.

  • A green and red color scheme indicates positive and negative.

• Additional visualization settings: Select the Settings icon in the visualization header to view additional settings for the map visualization. For more information, see Configure visualization settings.

Save the project to save all map settings (coordinates, zoom, rotation).

(Optional) The freeform table below the visualization can be populated by dragging in location dimensions and metrics from the left rail.

In Analysis Workspace, open an existing map visualization, or build a new one.

Hover over the map visualization, then select the Settings icon in the visualization header.

The following options are available:

In Customer Journey Analytics, select Data Management > Data views.

Select the data view that contains the dimensions that you want to configure to use more precise locations.

In the data view, select the Components tab.

Select the dimensions that you are using for latitude and longitude that you want to configure. For more information about which dimensions you’re using, see Required context labels for latitude and longitude in the map visualization.

Configure the level of precision for the dimension:

1. With the dimension that you want to configure still selected, expand the Format section in the right rail.

   

2. In the Decimal places field, change the number of decimals to reflect the desired level of precision:

   • 0: Precise to the large region or country level in the map visualization. Shows 0 decimal places in Workspace reports.

   • 1: Precise to the region or large city level in the map visualization. Shows 1 decimal place in Workspace reports.

   • 2: Precise to the town or zip code level in the map visualization. Shows 2 decimal places in Workspace reports.

     This is the default selection.

   • 3: Precise to the very small town or neighborhood level in the map visualization. Shows 3 decimal places in Workspace reports.

   • 4: Precise to a specific parcel of land or building level in the map visualization. Shows 4 decimal places in Workspace reports.

   • 5: Precise to a single meter in the map visualization. Shows 5 decimal places in Workspace reports.

Select Save and continue > Save and finish.

Zoom or pan to the area of the map that contains the data that you want to use for your segment.

Do either of the following:

• To create a segment from everything currently shown in the map: Right-click anywhere on the map, then select Create segment from current view.

• To create a segment for a more specific area of the map: Click the selection tool , drag your mouse to select the desired area, then select Create segment from selection.

Use the Segment builder to define the new segment. For more information, see Segment builder.

Zoom or pan to the area of the map that contains the data that you want to use for your audience.

Do either of the following:

• To create an audience from everything currently shown in the map: Right-click anywhere on the map, then select Create audience from current view.

• To create an audience for a more specific area of the map: Click the selection tool , drag your mouse to select the desired area, then select Create audience from selection.

Use the Audience builder to define the new audience. For more information, see Audience builder in Create and publish audiences

Zoom or pan to the area of the map that contains the data that you want to use for the trended line chart.

Do either of the following:

• To create a trended line chart from everything currently shown in the map: Right-click anywhere on the map, then select Trend from current view.

• To create a trended line chart for a more specific area of the map: Click the selection tool , drag your mouse to select the desired area, then select Trend.

A line visualization is built that includes a trendline. For more information about this visualization, see Line.