How to use Pixel Upload with Catalogs
Pixel Upload allows you to connect your catalog to a specific pixel event to automatically update product information in your catalog in real time. This will minimize product discrepancies and is an effective method to achieve high match rates.
Before you begin:
Only Pixels in Active state can be selected. If your Pixel does not post a new event within 7 days, it can not be used.
Each website URL must be within 100 characters, and only up to 20 domain names are supported.
Trusted websites listed are read as a "contain" condition. This means the product landing page of your products must contain any of your listed website URLs in this field in order to be added into the catalog.
Each time an event is triggered, it may take up to 15 minutes for the update to show in the catalog.
You'll need to configure the following mandatory pixel parameters:
Catalog Parameter Name | Pixel parameter Name | Description | Requirement | Value type |
sku id | content_id | Enter a unique ID for the item, such as a SKU.- Use only valid unicode characters, avoid invalid characters like control or function characters. | Either contents or content_id is required | Must be an array of objects (content parameter, id sub-object and quantity sub-object). |
sku id | contents | Only used when clients have multiple content IDs.If this parameter is used, client must also include the following in a sub-object:- product id or ids- quantity (number of items added to cart or purchased) | Either contents or content_id is required | string |
title | content_name | Name of the page/product | Required | string |
price | price | The price of the item | Required | number |
description | description | A short description describing the item. | Required | |
availability | availability | The current availability of the item in your store. Out of stock will not be able to be advertised. | Required | Supported values: in stock, available for order, preorder, out of stock, discontinued |
image | image_url | The image link of the product, which will be used for the creative generation of the advertisement. | Required | - For square (1:1) aspect ratios in the carousel ad format, your image should be ≥500x500.- All images should be in JPG or PNG format. |
link | product_url | The URL of the product landing page, or the website where you can buy the item. | Required | |
| currency | Refers to currency used as a means of circulation in social and economic activities such as USD | required, recommended to include for ecommerce customer | enum(string) |
| value** | The total price of the order | required, recommended to include for ecommerce customer | number |
| quantity | The number of product which is added to cart or bought by users | Optional | number |
| content_type | The content_type object property's value must be set to either product, or product_group, depending on how you will configure your data feed when you set up your product catalog.If you will be tracking events associated with individual products, set the value to product. If you are tracking events associated with product groups, set it to product_group instead. | Optional | Must be either product or product_group. |
| content_category | Category of the page/product | Optional | string |
How to use Pixel Upload with Catalogs
To use pixel upload:
Navigate to your catalog.
Click Add Products.
Select Pixel Upload.
Select the Ad account where the pixel has been connected and installed.
Select the Pixel associated with the selected ad account.
Add trusted websites that are connected to your Pixel. This will retrieve information from specific or trusted sources.