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
  • Delivery and taxonomy destination paths on the PubMatic SFTP server

​
Supported identifiers

Identifier TypeRosetta Stone Attribute
Mobile advertising ID (MAID)unique_id.maid
Android Advertising IDunique_id.android_advertising_id
Apple IDFAunique_id.apple_idfa
Mobile IDunique_id.mobile_id_unique_identifier
SHA256 hashed emailunique_id.hashed_email.sha256
Hashed emailunique_id.hashed_email
Your dataset must contain at least one of the supported identifier types. 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
  • Delivery Destination — the SFTP path where audience data files are delivered
  • Taxonomy Destination — the SFTP path for taxonomy files
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.

​
Related content

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