Skip to main content
The PubMatic Connector delivers audience data to PubMatic’s platform via SFTP, enabling data providers and advertisers to make their segments available for programmatic advertising across PubMatic’s exchange.

​
Overview

The connector pushes your audience data to PubMatic through a secure SFTP connection. Once delivered, your segments become available for targeting by advertisers buying inventory through PubMatic’s exchange. Each connector profile stores your SFTP credentials and PubMatic Data Provider ID (DPID), so you can manage multiple delivery configurations.

​
Requirements

​
Account access

  • A PubMatic account with a Data Provider ID (DPID) from your PubMatic account representative
  • SFTP credentials (host, port, username, and password) provided by PubMatic

​
Supported identifiers

Your data must include at least one of these identifier types, mapped to the corresponding Rosetta Stone attribute: The connector also accepts the generic mobile_id_unique_identifier attribute when its type resolves to one of the identifiers above.
Hashed identifiers must use SHA256. See Hashing PII for Upload for formatting requirements.

​
Installation

1

Navigate to the connector

In Narrative, go to Installed Apps and select PubMatic Connector.
2

Create a profile

Click New Profile and provide the following information:
  • Profile name — a unique name to identify this configuration
  • Data Provider ID (DPID) — the numeric identifier from your PubMatic account representative
  • SFTP Host — the SFTP server address (defaults to sftp-uswest.pubmatic.com)
  • SFTP Port — the port number for the SFTP connection (defaults to 8822)
  • SFTP Username — your PubMatic SFTP username
  • SFTP Password — your PubMatic SFTP password
3

Test the connection

Click Test Connection to verify your SFTP credentials before saving. This confirms that Narrative can reach PubMatic’s SFTP server with the provided settings.
4

Save the profile

Once the connection test succeeds, click Create Profile to save your configuration.

​
Delivering audiences

After creating a profile, you can connect datasets for delivery:
  1. Navigate to the dataset you want to deliver.
  2. Open the Connections tab and select the PubMatic Connector.
  3. Choose your PubMatic profile and configure the audience name.
  4. Optionally enable Deliver all data to include existing data in addition to new records.

​
Audience membership duration

Membership duration is how long a delivered identifier remains active in the destination audience before the destination platform expires it. It is distinct from the dataset’s retention policy (which governs data stored in Narrative) and the interface’s refresh window (which governs how stale the source dataset may get). The connector does not set an expiration on individual memberships — the membership files it delivers have no expiry field. PubMatic does automatically deactivate a segment (not its individual members) that goes unused for 90 days; this is PubMatic platform behavior and cannot be configured through the connector.

​
Opt-outs

The Opt Out Configuration tab on the connector page connects a dataset of opted-out users to PubMatic. Removals are written against the Data Provider ID (DPID) on the connection’s profile, so they apply to every segment belonging to that data provider — not only the segments Narrative delivers. Two profiles that carry different Data Provider IDs are therefore two separate sets of removals, and the tab lists the profile each connection was created under.
1

Open the Opt Out Configuration tab

In Installed Apps, open PubMatic Connector and select the Opt Out Configuration tab. The tab lists the datasets currently feeding opt-outs, with the dataset id, dataset name, profile, and connection id for each connection.
2

Connect a dataset

Click Connect opt out dataset. The picker offers datasets that aren’t already wired up as an opt-out source and that carry both an identifier column PubMatic matches on and a geographic column — iso_3166_1_country or ip_address. The geographic column is required because the removal file PubMatic reads carries a country column.
3

Confirm the opt-out

A confirmation names the dataset you picked and the connector it applies to. Connecting it opts every identifier in the dataset out of PubMatic and cannot be undone, so check the name before you click Accept.
You need at least one enabled PubMatic profile before you can create an opt-out connection. The connection is created under your first profile.

​
Related content

PubMatic Conversions API Connector

Send conversion events to PubMatic for ad attribution

Data Activation Overview

Understand how connectors deliver data

Hashing PII

Prepare identifiers for PubMatic delivery

Structuring Audiences

Organize datasets for delivery

Schema Incompatibility Errors

Resolve errors when a dataset schema doesn’t match a connector