Sponsored Products Feed Integration¶

Abstract¶

Integration with Verizon Media’s Sponsored Products Feeds involves a series of steps outlined in this document, which you’ll need to follow in order to implement Sponsored Product Feeds for your brand website. The primary steps for integration with sponsored products are described in detail in Sponsored Product Integration v1.0.

Overview¶

Sponsored Products is a new publishing solution from Verizon Media aimed at major retailer brands and marketplaces, where customers search, discover and purchase various product offerings from online marketplace catalogs and offerings.

Brand-focused marketplaces that sell different brands on their websites will be able to grow supply to larger advertisers and other major brands, using Sponsored Products from Verizon Media.

In so doing, Sponsored Products enable publishers to increase revenue by 10-20% by leveraging strong purchase intent signals from customers coming to their websites.

Steps For Sponsored Products Feed Integration¶

You’ll need to follow these steps:

1. Implement a product feed that specifies general (Google product taxonomy) and custom categories set to the value of a particular product, like Nike shorts categorized as Mens’ activewear, activewear, mens shorts, and so on. Categories are specified as comma-separated values.

2. You’ll need to provide all the filters and categories that a consumer will navigate through on a website. Each product should be specified by a separate SKU ID.

3. For custom fields, ensure that you set up a meeting with your Verizon Media Account Manager or Solutions Engineer to define custom fields.

Feed Operations & File Formats¶

Verizon Media Dynamic Product Ads (DPA) provides support for the API endpoints and operations described in this section. Operations include creating, updating and deleting the sponsored product feed.

You can also download a sample product feed spreadsheet in .csv format here.

Sample product feeds can be .csv or .tsv files. For specific format requirements, refer to Bulk Operations Schema.

The current supported file formats include:

Create a Product Feed¶

The following API can be used to create a product feed into Native Ad Platform.

Make a POST call to this endpoint:

https://api.gemini.yahoo.com/v3/rest/feed

Request:

{
  "advertiserId": 11,
  "status": "ACTIVE",
  "userName": "ftp_username",
  "feedType": "DPA_RECURRING",
  "fileName": "yourfeedfile.csv",
  "password": "password",
  "feedUrl": "ftp://yourftpserver.yourwebsite.com",
  "scheduleInfo": {
    "feedFrequency": "DAILY",
    "dayOfMonth": null,
    "dayOfWeek": null,
    "hourMinute": "12:00"
  }
}

Check Feed Status¶

To check the feed status, make a GET call to this endpoint with the feed id, which is the response from creating a feed:

https://api.gemini.yahoo.com/v3/rest/feed/status?feedId=1421

response

{
"errors": null,
"timestamp": "2017-04-12 21:07:36",
"response": {
  "status": "COMPLETED",
  "startedTime": "2017-03-31 00:29:02",
  "finishedTime": "2017-03-31 00:29:02",
  "resultFile": "token",
  "results": {
    "Product_Ad": {
      "totalCount": 9,
      "addedCount": 0,
      "updatedCount": 9,
       "failedCount": 0

      }
    }
  }
}

https://api.gemini.yahoo.com/v3/rest/feed/error?resource=token

Sponsored Product Feed Fields¶

Sponsored product feed fields are described in the table below.