Shopping Ads

Shopping ads utilize your existing product data to dynamically create ads across our platform. The product data you submit contains detailed information about the products you sell. We use these details to match a user's search to your ads, ensuring that the most relevant products are shown.

Shopping ads help you promote your online and local inventory, increase traffic to your website or local store, and attract better-qualified leads. To get started, send us your product data and create a campaign in Armanet Ads. Based on your campaign and product data, we will create ads on Armanet and other placements around the web, depending on the campaign type.

Unlike text ads that display only text, Shopping ads show users a photo of your product, a title, price, store name, and more. These ads provide users with a strong sense of the product before they click the ad, resulting in more qualified leads.

Benefits of Shopping Ads

  • Improved Sales: By showcasing product images along with essential details like price and store name, shopping ads provide potential customers with a visual and informative experience, leading to higher conversion rates.
  • Maximized Advertising Campaigns: Shopping ads attract more qualified leads by displaying comprehensive product information, which helps in better targeting and engagement.
  • Increased Traffic: These ads help in driving more traffic to your website or local store by capturing the interest of users actively searching for products you offer.

Integration Details

To create Shopping ads, your product catalog must be ingested by Armanet. This is achieved via feeds.

What are Feeds?

A feed is a file that contains a list of products you want to advertise through Armanet. When you add your products, you’ll assign attributes to each one. Your product feeds will use these attributes to group your products together. Once created, a feed can be used multiple times across various Armanet features.

CSV Format

The CSV feed must be available on a public URL that we’ll sync with every few minutes. For example: https://www.yourwebsite.com/feed.csv.

  • Name
    id
    Type
    string
    Required
    required
    Description
    • Unique identifier for each product.
    • Use the product SKU where possible.
    • Keep the ID consistent when updating your data.
    • Use only valid Unicode characters.
    • Use the same ID for the same product across countries or languages.
  • Name
    title
    Type
    string
    Required
    required
    Description
    • Product name.
    • Accurately describe your product and match the title from your landing page.
    • Avoid promotional text like “free shipping”, all capital letters, or foreign characters.
  • Name
    description
    Type
    string
    Optional
    optional
    Description
    • Product description.
    • Accurately describe your product and match the description from your landing page.
    • Avoid promotional text like “free shipping”, all capital letters, or foreign characters.
  • Name
    link
    Type
    string
    Required
    required
    Description
    • Product landing page URL.
    • Example: https://www.armanet.us/
    • Use your verified domain name.
    • Start with https.
    • Use an encoded URL that complies with RFC 2396 or RFC 1738.
  • Name
    image_link
    Type
    string
    Required
    required
    Description
    • Product image URL.
    • Example: https://i.armanet.us/product.jpg
    • Link to the main image of your product.
    • Start with https.
    • Use an encoded URL that complies with RFC 2396 or RFC 1738.
    • Accurately display the product.
    • Accepted formats: JPEG (.jpg/.jpeg), WebP (.webp), PNG (.png), non-animated GIF (.gif).
  • Name
    availability
    Type
    enum
    Optional
    optional
    Description
    • Product availability status.
    • Defaults to in_stock when the column is missing.
    • Example: in_stock
    • Syntax: enum of in_stock, out_of_stock, preorder, backorder.
    • If sending a number, 0 or lower will be out_of_stock, anything higher than 0 will be in_stock.
  • Name
    price
    Type
    float
    Required
    required
    Description
    • Product price.
    • Example: 249.99
    • Submit the product price accurately in floating point.
    • For bulk quantities or bundles, submit the total price of the minimum purchasable quantity.
    • If the product price is 0 and the sale price is not effective, the product will be hidden.
  • Name
    sale_price
    Type
    float
    Optional
    optional
    Description
    • Product sale price.
    • Example: 149.99
    • Same requirements as the price attribute.
  • Name
    sale_price_effective_date
    Type
    timestamp
    Optional
    optional
    Description
    • Date range during which the sale price applies.
    • Example: 2023-02-24T11:07+0100/2023-02-28T23:59
    • Syntax: ISO 8601 dates, separated by /.
    • Use together with the sale price attribute.
    • If no date range is submitted, the sale price always applies.
  • Name
    product_category
    Type
    string
    Optional
    optional
    Description
    • Category name for this product.
    • Helps Armanet group products for targeting and reporting.
    • Use standardized category names where possible.
  • Name
    product_type
    Type
    string
    Optional
    optional
    Description
    • More specific classification of the product.
    • Helps refine ad targeting and improves catalog organization.
  • Name
    brand
    Type
    string
    Optional
    optional
    Description
    • Product brand name.
    • Example: BCM
    • Helps refine ad targeting and improves catalog organization.
  • Name
    upc
    Type
    string
    Optional
    optional
    Description
    • Product Universal Product Code (UPC).
    • Example: 642230261129
    • Submit the UPC exactly as printed on the product.
    • Leave empty if the product has no UPC.
  • Name
    tags
    Type
    string
    Optional
    optional
    Description
    • Comma-separated list of tags for this product.
    • Example: "clearance,new arrivals"
    • Wrap the value in double quotes when it contains more than one tag.
    • Tags are converted to lowercase, and any character that is not a letter, number or space is removed.
    • Duplicate and empty tags are ignored.

Feed Example

GET
https://www.yourwebsite.com/feed.csv

id,title,description,link,image_link,availability,price,sale_price,sale_price_effective_date,upc,tags
1,HK P2000 v2,The versatile and reliable P2000 incorporates many features of the legendary HK USP pistol,https://www.armoryiq.com/products/handguns-hk-81000039-642230261129-6528,"https://cdn.filestackcontent.com/Aucm0ze0SHM76x9FhaHgpz/resize=width:450,height:300/cache=expiry:max/https://www.filepicker.io/api/file/pxd2KmcQRY6p8246T61U",in_stock,899,799,2024-03-05T00:00/2024-03-13T23:59,642230261129,"clearance,new arrivals"

By following these guidelines, you can ensure that your product data is correctly ingested by Armanet, allowing for effective Shopping Ads creation and campaign optimization.

Filtering Products

Each Shopping ad has a feed configuration in the Armanet platform that controls which products from your feed are displayed. Every filter you fill in is applied together, so a product must satisfy all of them to be selected. Empty fields are ignored.

If fewer products match your filters than the configured Limit, the remaining slots are filled with other products from the same feed, so the ad is never shown empty.

Limit and Minimum Price

  • Limit: the number of products displayed in the ad. Accepted values are 12, 24 and 48.
  • Minimum Price: only products with a regular price equal to or higher than this value are displayed. Defaults to 1.

Filtering by Category and Product Type

The Category and Product Type fields match against the product_category and product_type columns of your feed.

  • Separate multiple values with spaces. A product is displayed if it matches any of them.
  • Wrap values that contain spaces in double quotes. For example, Rifles "Semi Shotguns" matches products in the Rifles or Semi Shotguns categories.

Filtering by Keywords

The Keyword filter searches product titles. Products whose title best matches the keywords are displayed first.

  • Unquoted keywords are separate terms.
  • Quoted keywords are single terms. For example, "AK 47".
  • Prefix a keyword with a dash to exclude it. For example, ar15 -pistol.
  • When the field is empty, products are picked at random.

Filtering by Tags

Once your feed includes the tags column, you can limit which products a Shopping ad displays by filling in the Tags field.

  • Products with at least one of the listed tags are displayed.
  • Unquoted tags are separate terms. For example, clearance sale matches products tagged clearance or sale.
  • Quoted tags are single terms. For example, "new arrivals" matches products tagged new arrivals.
  • Prefix a tag with a dash to exclude it. For example, -used excludes products tagged used.
  • Matching is case-insensitive and ignores punctuation, the same way tags are normalized in the feed.

For example, clearance "new arrivals" -used displays products tagged clearance or new arrivals, except those also tagged used.