Catalog Feed (CSV) Template FAQ

    What is an Item ID vs. Variant ID?
  • itemId refers to the product (e.g., a t-shirt).
  • id refers to the variant (e.g., size or color).
  • You can have one itemId with multiple id values.

2. Where can i find the category ID?
  • You can refer to the  Google Category ID  

    Which fields are required?
You must provide the following:
  • categoryId (Google category ID)
  • description (Short variant description)
  • id (Globally unique variant ID)
  • isAvailable (In-stock status)
  • isBundle (Whether the variant is a bundle)
  • itemId (Shared ID across variants)
  • name (Variant name)
  • price (Original price before any discount)
  • primaryImageUrl (Main image; must be .jpg/.jpeg/.png)
  • webUrl (Landing page with pixel + View Item event)

    What media formats are supported?
  • Images: .jpg, .jpeg, .png
  • Videos: .mp4

    Can I include multiple images or videos?
Yes:
  • additionalImageUrls accepts an array of image URLs.
  • additionalVideoUrls accepts an array of video URLs.
  • Only primaryImageUrl and primaryVideoUrl determine the default visuals.

    What’s the difference between price, salePrice, and rewardPercent?
  • price: Regular price before discounts.
  • salePrice: Optional discounted price. Becomes active based on salePriceStartDate and salePriceEndDate.
  • rewardPercent: Optional customer reward percentage. Controlled by rewardStartDate and rewardEndDate.

    What happens if only one of the sale or reward dates is set?
  • If only salePriceStartDate is set, the sale runs indefinitely from that time.
  • If only salePriceEndDate is set, the sale is valid until that time.
  • If both are null, the promotion is considered inactive.

    How do I specify who the product is for?
Use the following fields:
  • ageGroup: One of ADULTS, ALL_AGES, INFANT, KIDS, NEWBORN, TODDLER
  • gender: One of FEMALE, MALE, UNISEX

    Can I show customer feedback for a variant?
Yes. You can include:
  • rating: Decimal (0–5 scale)
  • numberOfReviews: Integer count
These fields are optional but helpful for boosting consumer trust.

    What is isBundle?
Set this to true if the variant is a multi-item set sold together (e.g., skincare kits, outfit bundles).

    When is the brand field ignored?
If multiple variants share the same itemId, only one brand value is used; others are ignored.

    What does multipackQuantity mean?
Indicates the number of identical items in a single unit (e.g., a 6-pack of socks).

    What are the requirements for the webUrl?
The URL must:
  • Be publicly accessible.
  • Contain the product details.
  • Fire a View Item pixel event when loaded.
  • https the secure version of http

    What time zone should I use?
  • All date and time values should be formatted in UTC using the ISO-8601 standard.
  • Example format: 2025-01-01T00:00:00
  • Do not include a time zone offset or local time.

    How long does it take for the CSV to sync in the platform?
  • After you upload your CSV, it may take up to 24 hours for your catalog to fully sync on the platform.
  • Please plan accordingly and check back after that window if updates are not visible.

For more information please refer to  Dynamic Ads with Catalog Manager