---
layout: page_v2
page_type: module
title: Module - topicsFpdModule
description: how to get topics data using Topics API
module_code : topicsFpdModule
display_name : Topics FPD Module
enable_download : false
sidebarType : 1
---

# Topics First Party Data (FPD) Module

{: .alert.alert-warning :}
Chrome has removed the Topics API. Since Prebid.js 11.26, this module is a no-op: it logs a warning, adds no topics to `user.data`, and loads no topics iframes. The `userSync.topics` configuration described below is ignored. The rest of this page describes the module as it worked before 11.26.

This module is use to call the Topics API (document.browsingTopics()) which will fetch the first party domain as well third party domain(Iframe) topics data which will be sent onto user.data in bid stream.

To learn more about topics in general, visit [googles blog "Get to know the new Topics API for Privacy Sandbox"](https://blog.google/products/chrome/get-know-new-topics-api-privacy-sandbox/).

This document covers the steps necessary for publishers to enable Topics Data on their inventory. It also describes
the configuration needed to override topics Iframe Default implementation

## Publisher Integration

Publishers wishing to enable must compile Prebid.js with support for this module.
This is accomplished by adding the `topicsFpdModule` module to the list of modules they are already using:

```bash
gulp build --modules=topicsFpdModule,...
```

# Description

The intent of the Topics API is to provide callers (including third-party ad-tech or advertising providers on the page that run script) with coarse-grained advertising topics that the page visitor might currently be interested in.

Topics Module(topicsFpdModule) should be included in prebid final package to call topics API.
Module topicsFpdModule helps to call the Topics API which will send topics data in bid stream (onto user.data)

```javascript
try {
    if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
        topics = document.browsingTopics();
    }
} catch (e) {
    console.error('Could not call topics API', e);
}
```

# Topics Iframe Configuration

Topics iframe implementation is the enhancements of existing module under topicsFpdModule.js where different bidders will call the topic API under their domain to fetch the topics for respective domain and the segment data will be part of ORTB request under user.data object. Default config is maintained in the module itself.

Below are the configuration which can be used to configure and override the default config maintained in the module.

```javascript
pbjs.setConfig({
    userSync: {
        // ...,
        topics: { 
            maxTopicCaller: 4,
            bidders: [{
                bidder: 'pubmatic',
                iframeURL: 'https://ads.pubmatic.com/AdServer/js/topics/topics_frame.html'
            }, {
                bidder: 'rtbhouse',
                iframeURL: 'https://topics.authorizedvault.com/topicsapi.html'
            }, {
                bidder: 'openx',
                iframeURL: 'https://pa.openx.net/topics_frame.html'
            }, {
                bidder: 'improvedigital',
                iframeURL: 'https://hb.360yield.com/privacy-sandbox/topics.html'
            }, {
                bidder: 'onetag',
                iframeURL: 'https://onetag-sys.com/static/topicsapi.html'
            }, {
                bidder: 'taboola',
                iframeURL: 'https://cdn.taboola.com/libtrc/static/topics/taboola-prebid-browsing-topics.html'
            }, {
                bidder: 'discovery',
                iframeURL: 'https://api.popin.cc/topic/prebid-topics-frame.html'
            }, {
                bidder: 'undertone',
                iframeURL: 'https://creative-p.undertone.com/spk-public/topics_frame.html'
            }, {
                bidder: 'vidazoo',
                iframeURL: 'https://static.vidazoo.com/topics_api/topics_frame.html'
            }]
        }
        // ...
    }
})
```

## Topics Config Descriptions

{: .table .table-bordered .table-striped }
| Field | Required? | Type | Description |
| --- | --- | --- | --- |
| topics.maxTopicCaller | no | integer | Defines the maximum numbers of Bidders Iframe which needs to be loaded on the publisher page. Default is 1 which is hardcoded in Module. Eg: topics.maxTopicCaller is set to 3. If there are 10 bidders configured along with their iframe URLS, random 3 bidders iframe URL is loaded which will call TOPICS API. If topics.maxTopicCaller is set to 0, it will load random 1(default) bidder iframe atleast. |
| topics.bidders | no | Array of objects | Array of topics callers with the iframe locations and other necessary informations like bidder(Bidder code) and expiry. Default Array of topics in the module itself. |
| topics.bidders[].bidder | yes | string | Bidder Code of the bidder(SSP). |
| topics.bidders[].iframeURL | yes | string | URL which is hosted on bidder/SSP/third-party domains which will call Topics API. |
| topics.bidders[].expiry | no | integer | Max number of days where Topics data will be persist. If Data is stored for more than mentioned expiry day, it will be deleted from storage. Default is 21 days which is hardcoded in Module. |