> ## 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.

# PubMatic Connector

> Deliver audience segments to PubMatic for programmatic advertising

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 Type              | Rosetta Stone Attribute                 |
| ---------------------------- | --------------------------------------- |
| Mobile advertising ID (MAID) | `unique_id.maid`                        |
| Android Advertising ID       | `unique_id.android_advertising_id`      |
| Apple IDFA                   | `unique_id.apple_idfa`                  |
| Mobile ID                    | `unique_id.mobile_id_unique_identifier` |
| SHA256 hashed email          | `unique_id.hashed_email.sha256`         |
| Hashed email                 | `unique_id.hashed_email`                |

<Note>
  Your dataset must contain at least one of the supported identifier types. See [Hashing PII for Upload](/guides/ingestion/hashing-pii) for formatting requirements.
</Note>

## Installation

<Steps>
  <Step title="Navigate to the connector">
    In Narrative, go to **Installed Apps** and select **PubMatic Connector**.
  </Step>

  <Step title="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
  </Step>

  <Step title="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.
  </Step>

  <Step title="Save the profile">
    Once the connection test succeeds, click **Create Profile** to save your configuration.
  </Step>
</Steps>

## 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

<CardGroup cols={2}>
  <Card title="Data Activation Overview" icon="bullseye-arrow" href="/concepts/data-activation/overview">
    Understand how connectors deliver data
  </Card>

  <Card title="Hashing PII" icon="hashtag" href="/guides/ingestion/hashing-pii">
    Prepare identifiers for PubMatic delivery
  </Card>

  <Card title="Structuring Audiences" icon="sitemap" href="/guides/activation/audience-strategies">
    Organize datasets for delivery
  </Card>

  <Card title="Schema Incompatibility Errors" icon="plug-circle-exclamation" href="/reference/errors/dataset-schema-connector-incompatible">
    Resolve errors when a dataset schema doesn't match a connector
  </Card>
</CardGroup>