Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

A Marketplace Match Report measures how well a supplier’s data overlaps with — and enriches — your first-party identity data. This guide walks through the five-step builder that produces a report.
Marketplace Match Reports run on Snowflake data planes. The builder generates a workflow that materializes the report as a dataset; the dataset appears in the Reports listing once the workflow’s final step completes.

​
Prerequisites

  • A first-party edge dataset built with Graph Studio. The match report uses these edges as its starting inventory of identifiers.
  • An access rule granting you access to a supplier dataset that has been mapped to Rosetta Stone identifier attributes and (optionally) demographic attributes.
  • A Snowflake data plane selected in the data plane switcher.

​
Open the builder

Navigate to My Data > Reports and click New report. The builder loads with a five-step left rail:
  1. Source dataset — your first-party edge dataset.
  2. Supplier dataset — the third-party access rule you are evaluating.
  3. Match identifiers — which identifier types to match on.
  4. Supplier enrichment — which identifiers and demographic attributes to pull from the supplier for matched people.
  5. Finalize — name and schedule the report.
You can move forward only when the current step is valid. You can return to any earlier step at any time; downstream selections are preserved when they remain valid.

​
Step 1: Select a source dataset

Pick the edge dataset that holds the customers you want to evaluate. Only datasets eligible to act as a graph source — those with Rosetta Stone identifier mappings and statistics that the report can read — appear in the picker.
A match report requires exactly one source dataset. Selecting a different dataset replaces the current selection rather than adding to it.

​
Step 2: Select a supplier dataset

Choose the access rule for the supplier you want to evaluate. Only access rules that the report builder can join against your source dataset appear in the list. The builder shows an inline message when a supplier is ineligible — typically because it has no overlapping identifier types with your source. You can select one supplier access rule per report. To compare multiple suppliers, build one report per supplier.

​
Step 3: Choose match identifiers

Match identifiers determine which identifier types the report uses to match your people to the supplier. The grid lists every identifier type your source dataset has in common with the supplier; all are selected by default. Deselect a type to exclude it from matching. The match rate the report reports is the share of your people who matched on any selected identifier type, so a broader selection generally raises the match rate but may include lower-confidence matches.
You must keep at least one identifier type selected to continue.

​
Step 4: Configure supplier enrichment

Supplier enrichment defines what the report pulls from the supplier for the people who matched in step 3. Two selections live on this step:
  • New identifiers — additional identifier types the supplier contributes for your matched people (e.g., a hashed email the supplier has that you do not). These drive the Enrichment card and the ID Enrichment KPI.
  • Demographic and behavioral attributes — categorical attributes from the supplier (e.g., gender, education level, income range). Each attribute you select becomes a panel in the Demographic & Behavioral Enrichment section of the rendered report.
Only attributes the supplier has mapped to Rosetta Stone are available. Selecting nothing is allowed — the report will still produce match metrics and identifier enrichment without demographic panels.

​
Step 5: Finalize the report

Name the report, optionally describe it, and choose a refresh schedule.
1

Set the unique name

The unique name is the NQL-safe identifier for the generated dataset. The builder uppercases the name on blur and surfaces a conflict warning if another dataset already uses the same name.
2

Set the display name and description

The display name is what readers see in the Reports listing and at the top of the rendered report. If you leave the display name blank, the builder copies the unique name into it when you finish editing.
3

Choose a refresh schedule

The default is Daily. Match reports are materialized views under the hood, so the schedule controls how often the underlying workflow re-runs and the report’s numbers update.
4

Review the workflow preview

The collapsible workflow preview shows the multi-step workflow the builder will submit — including the intermediate datasets it creates and the final materialized view that backs the report. Use this to sanity-check what will run on your data plane.
5

Submit

Click Build report. The builder submits the workflow and returns you to the Reports listing.

​
After submission

The report appears in the Reports listing immediately. While the producing workflow runs, the row shows the workflow’s run state (pending, running, or failed) and is not yet clickable. Once the workflow’s final step has materialized the dataset, the row becomes a link to the rendered report.
If the workflow fails, open the run from the listing to see step-level errors. Re-submitting the builder with the same unique name will conflict with the failed workflow’s dataset — change the unique name or archive the failed dataset before retrying.