English
Create an Ad

銷售

  1. 廣告目標 /
  2. 銷售 /
  3. 目錄設定 /

How to use Pixel Upload with Catalogs

Last updated: February 2025

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.


Learn about catalog event 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:

  1. Navigate to your catalog.

  2. Click Add Products.

  3. Select Pixel Upload.

  4. Select the Ad account where the pixel has been connected and installed.

  5. Select the Pixel associated with the selected ad account.

  6. Add trusted websites that are connected to your Pixel. This will retrieve information from specific or trusted sources.


*Was the information helpful?
Related Articles
关于付款失败
如何排查身份验证失败的问题
如何排查支付方式无效问题