Product Catalog
Product Catalog offers a powerful, flexible, and efficient solution for businesses aiming to leverage sponsored listings for a wide range of products or services. Its comprehensive feature set not only simplifies the management and promotion of listings but also enhances the accuracy and effectiveness of digital advertising efforts.
Key Features
Seamless Product Inventory Synchronization: Automatically synchronizes your product inventory with the Surfside platform, ensuring that your sponsored product ads are always up-to-date with the latest inventory changes.
Versatility in Product Feeds: Surfside's Feed can handle product feeds of any size and complexity, from thousands to millions of items, accommodating any data structure and ensuring quick searchability by various attributes.
Industry and Vertical Agnostic: The system is designed to support a wide range of items, including but not limited to consumer goods, services, content pieces like articles or blog posts, and more, making it a versatile tool for various industries.
Customizable Indexing: Allows for indexing based on custom fields defined by customers, such as brand names, product IDs, and categories, facilitating easy item promotion by Ad Operations teams.
Dynamic Ad Creation: Enables the automatic generation of ads that are dynamically updated to reflect changes in pricing, availability, or other key attributes, ensuring ads always present accurate information.
Native Integration: Offers advanced filtering and fetching capabilities for ads, making it simpler to manage and promote items effectively based on detailed criteria.
Benefits of Implementing Feed
Efficiency and Time Savings for Ad Operations: By automating the synchronization of product information and eliminating the need to duplicate data across systems, AdOps teams can focus more on strategy and less on manual data management.
Empowerment of Advertisers: Provides advertisers with a self-service portal, granting them the autonomy to select and promote products according to their advertising strategies.
Unified Source of Truth: Establishes a centralized repository for all product information, ensuring consistency across ads and reducing the risk of displaying outdated or incorrect information.
Scalability and Flexibility: Whether dealing with a modest inventory or managing millions of listings, the Feed system is designed to scale according to business needs while accommodating a diverse range of products and services.
- Seamless Creation of Recommendations: Allows clients to seamlessly create user and product recommendations, enhancing personalization and improving customer engagement.
Feed Types
Surfside uses product level data for creating the dynamic creatives, sponsored product and search campaigns and for training our machine-learning algorithms. Product data is made available to Surfside via a feed.
A feed is a file that contains a list of products you want to stock or would like to advertise through Surfside Commerce Media. When you add your products, you’ll define the attributes associated to each one. Your product feeds will use these attributes to filter or group your products together. Currently there are two types of Feed feed - a Primary Feed and a Refresh Feed.
- Primary feeds are the main data sources for your Surfside Feed inventory. If every product you add to your primary feed meets Surfside’s data and eligibility requirements, you won’t need to create any more feeds.
- Refresh feeds are used only to update product data that already exists in one or more primary feeds. You can have multiple supplementary feeds, and each one can supplement data in any number of primary feeds.
Primary Feed (Required)
A primary feed is the central data source that we use to access and display your product data. Use primary feeds to add or remove product data, set category, variant, pricing and product availability, and set feed rules for your product data ie, if you wish to allow advertising from a given product, brand or category. Primary feeds are the only feed type that can add or remove targeting restrictions.
Surfside recommends submitting all of your products in a single primary feed.
Refresh Feed
A refresh feed is a secondary data feed used to provide more details or update existing details, such as required or optional product attributes, that may change over time from your primary feed. A refresh feed can't be used to add or remove targeting restrictions or be used as a standalone feed.
Each supplemental feed must have an ID [id] attribute column, along with at least one additional column with the data you would like to connect to a primary feed.
Uploading Your Data
To upload your product data to the Surfside Product Feed, you'll first need to create a feed to which you can submit your data. This step is required for any new feed, and when a feed is registered, you can update the existing feed without having to register it again.
Feed API
The Feed API allows developers and platforms to interact directly with Surfside and can be used as an input source for creating a Primary Feed, or submitting an update via a Refresh Feed as it is updated on your site. Feed API requires you to authenticate with the Surfside API and then submit a request stating the Account and Feed that you wish to update.
Fetch Updates
This method allows you to create an uploading schedule for your data feed hosted on your website or cloud provider. Based on the schedule you create, we will take best efforts to download the file from your website and upload it to your account for you in accordance with your schedule.
Specification
Use this guide to format your product information for Commerce Media. Surfside uses this data to make sure that it's matched to the right queries. Sharing your product data in the correct format is important for creating successful campaigns.
| Value | Type | Example Value | Description |
|---|---|---|---|
| account_id | TEXT | n76f7 | Unique identifier for the account. |
| site_id | TEXT | s982sl | Unique identifier for the site. |
| location_id | TEXT | 123456789012 | Unique identifier for the location. |
| item_id | VARCHAR(255) | "A123" | Unique identifier for the item. |
| name | VARCHAR(255) | "Example Product" | Name of the product. |
| list | VARCHAR(255) | "Main Feed" | List or Feed the product belongs to. |
| brand | VARCHAR(255) | "BrandName" | Brand of the product. |
| category | VARCHAR(255) | "Electronics" | Category of the product. |
| variant | VARCHAR(255) | "Model X" | Variant of the product. |
| price | DECIMAL(10, 2) | 99.99 | Price of the product. |
| quantity | INT | 50 | Available quantity of the product. |
| coupon | VARCHAR(255) | "DISCOUNT10" | Coupon code applicable to the product. |
| position | VARCHAR(255) | "Top Seller" | Position or ranking of the product. |
| currency | VARCHAR(10) | "USD" | Currency of the product price. |
| product_type | VARCHAR(255) | "Gadget" | Type of product. |
| product_category | VARCHAR(255) | "Home Electronics" | More specific category of the product. |
| color | VARCHAR(255) | "Black" | Color of the product. |
| size | VARCHAR(255) | "Medium" | Size of the product. |
| material | VARCHAR(255) | "Plastic" | Material of the product. |
| pattern | VARCHAR(255) | "Solid" | Pattern of the product. |
| condition | VARCHAR(255) | "New" | Condition of the product. |
| cost_of_goods_sold | DECIMAL(10, 2) | 50 | Cost of goods sold. |
| shipping | DECIMAL(10, 2) | 5.99 | Shipping cost. |
| shipping_weight | DECIMAL(10, 2) | 1.5 | Weight of the product for shipping. |
| parent | VARCHAR(255) | "Parent123" | Parent for the item. |
| gender | VARCHAR(255) | "Unisex" | Gender for which the product is intended. |
| age_group | VARCHAR(255) | "Adult" | Age group for which the product is intended. |
| adult | BOOLEAN | TRUE | Whether the product is for adults. |
| restricted | BOOLEAN | FALSE | Whether the product is restricted. |
| country | VARCHAR(255) | "USA" | Country of origin. |
| state | VARCHAR(255) | "CA" | State of origin. |
| zip | VARCHAR(20) | "90210" | ZIP code of origin. |
| description | TEXT | "High-quality gadget." | Description of the product. |
| link | TEXT | "http://example.com" | URL to the product page. |
| image_link | TEXT | "http://example.com/img.jpg" | URL to the product image. |
| additional_image_link | TEXT | "http://example.com/extra_img.jpg" | URL to an additional image. |
| model_3d_link | TEXT | "http://example.com/model_3d" | URL to the 3D model of the product. |
| lifestyle_image_link | TEXT | "http://example.com/lifestyle_img.jpg" | URL to the lifestyle image. |
| availability | VARCHAR(255) | "In Stock" | Availability status of the product. |
| availability_date | DATE | "2024-06-01" | Date when the product will be available. |
| expiration_date | DATE | "2024-12-31" | Expiration date of the product. |
| sale_price | DECIMAL(10, 2) | 79.99 | Sale price of the product. |
| sale_price_effective_date | DATE | "2024-05-01" | Date when the sale price is effective. |
| mpn | VARCHAR(255) | "MPN123" | Manufacturer part number. |
| gtin | VARCHAR(255) | "123456789012" | Global Trade Item Number. |