Технически изисквания за рекламни фийдове


На тази страница ще намерите повече информация за различните рекламни фийдове, с които работи платформата и как да подготвите вашите файлове според изискванията ни. Изполвайте линковете, за да отидете точно в секцията, която ви е нужна:

Формат на файла

Форматът на файла, който приемаме е XML или CSV, като е нужно да спазите специфичната структура на информацията за продуктите, както е описано по-долу в раздел "Атрибути на продуктов фийд" и "Атрибути на фийд със статии".

Статичен и динамичен фийд

Системата ни работи както с локални файлове, които се опресняват ръчно при всяко качване на файла в системата, така и с динамично обновяващи се фийдове, които изтегляме от посочен URL-адрес на вашия сайт. За да можем ежедневно да обхождаме и опресняваме съдържанието на продуктите (най-вече актуалната цена), препоръчваме използването на динамичен фийд.

Честота на обхождане на динамичен фийд

Когато използвате динамичен фийд, той се обработва от нашата система регулярно. По подразбиране обхождането се случва един път на ден. Можем да увеличим честотата и да обхождаме вашия фийд по-често. Максималната честота на опресняване е 24 пъти на денонощие - по веднъж на час. Ако спецификата на вашия бизнес изисква често обхождане на фийда ви, обърнете се към нашия екип, за да ви съдействаме да постигнете оптимална регулярност и бързина.

Специфики на изображенията

Изображенията във вашия фийд се обхождат от нашата система при всяко опресняване на фийда и се запазват като оптимизирани ресурси на нашите сървъри, за да гарантираме мигновенното сервиране в последствие. Важно е всички изображения във фийда ви да са с равна или по-голяма резолюция от минималните допустими, а именно 250х250 пиксела. При твърде малки изображения, системата няма да може да валидира продукта и той няма да бъде запазен и обходен. Нашата система оптимизира тежестта на изображенията, за да са максимално лесни за изтегляне и показване на потребителските устройства. Поддържаните формати за обхождане са .jpg, .jpeg, .png и .webp

Препоръки за WooCommerce (WordPress) фийд-плъгин

WooCommerce е една от най-популярните платформи и най-лесният вариант за работа с нея е използването на плъгин, който да прави списък с продукти и да генерира линк с динамичен фийд. Нашата система ще обхожда този линк ежедневно, за да актуализира цените и друга информация за продуктите. Препоръчаме Product Feed PRO for WooCommerce by AdTribes или CTX Feed – WooCommerce Product Feed Manager by Webappick

Видове фийдове според съдържанието им

Фийдовете се делят на два вида спрямо тяхното съдържание и цел - продуктови фийдове (за електронни магазини) и фийдове със статии (за реклама на блогове и новини). Спрямо вида има различни изисквания за структурата на фийда:

1) Атрибути на продуктов фийд

  • Attribute
    Type
    Description
  • g:id

    Type: string

    *required

    Product ID

    A unique content ID for the item. Use the item's SKU if possible. Each content ID must appear only once in your catalog. If there are multiple instances of the same ID, we ignore all duplicates.

    Use only numbers, latin letters, underscores and dashes. White spaces are not allowed. The tag is not case-sensitive.

    Example: "123ABC" and "123abc" are the same IDs. "123_abc" or "123-abc" are allowed, "123 abc" is not allowed.

  • g:link

    Type: url address

    *required

    Product URL

    The URL to the specific product page for the item on your business's website where people can learn more about or buy that exact item. Links must begin with http:// or https://, be valid and be hosted on your business’s website domain.

    Example: https://yourdomain.com/product_page.html

  • g:title

    Type: string

    *required

    Product Title

    A specific, relevant title for the item.

    Character limit: 200, but we recommend a maximum of 65 to avoid longer titles being cut off.

    Example: White Sneakers

  • g:description

    Type: string

    optional

    Product Description

    A specific, relevant description for the item.

  • g:image_link

    Type: url address

    *required

    Product Image URL

    The URL should lead to an image in jpeg, png or webp format.

  • g:additional_image_link

    Type: url address

    optional

    Product Additional Image URL

    The URL should lead to an image in jpeg, png or webp format.

  • g:price

    Type: number

    *required

    Product Price

    Use only number without currency. Since each product feed has a fixed country setting and a currency, the price number will be saved automatically in the currency of your target country.

    For example: use 15.00 instead of 15.00 BGN

  • g:sale_price

    Type: number

    optional

    Product Sale Price

    If the product is on sale you should list the sale price among with the original (old) price to show the discount. Meet the same requirements as those for showing price via the price attribute

  • product_type

    Type: string

    optional

    Product Category

    If you have multiple levels (category path), then use > to separate them. Also, include a space before and after the > symbol.

    For example: Clothes > Women > Bags. We will take only the last category level, in this case: Bags.

  • g:brand

    Type: string

    optional

    Product Brand

    Only provide a brand if you are sure that it's correct. When in doubt, don't provide a brand (e.g. do not guess or make up a value like N.A. or similar).

  • g:availability

    Type: string

    optional

    Product Stock Status

    Allowed values: in_stock, out_of_stock and preorder. Any other values will be ignored.

  • g:condition

    Type: string

    optional

    Product Condition

    Allowed values: new, used. Any other values will be ignored.

  • g:gtin

    Type: string

    optional

    Global Trade or Manifacturer Number

    Used to uniquely identify a specific and unique product from the same manufacturer. Use this attribute to submit any of the following types of numbers: MPN, UPC, EAN, ISBN

  • Примерен продуктов фийд:
     <?xml version="1.0" encoding="UTF-8"?>
    <rss xmlns:g="http://base.google.com/ns/1.0" version="2">
      <channel>
        <title>Feed Title</title>
        <link>https://domain.com/</link>
        <description></description>
        <item>
          <g:id>112397</g:id>
          <g:gtin>Фабричен номер на продукта</g:gtin>
          <g:title>Заглавие на продукта</g:title>
          <g:description>Описание на продукта</g:description>
          <g:link>https://youreshop.com/</g:link>
          <g:image_link>https://youreshop.com/01.jpg</g:image_link>
          <g:additional_image_link>https://youreshop.com/01-2.jpg</g:additional_image_link>
          <g:availability>in stock</g:availability>
          <g:product_type>Категория на продукта</g:product_type>
          <g:brand>Марката на продукта</g:brand>
          <g:price>16.50</g:price>
          <g:sale_price>12.99</g:sale_price>
        </item>
      </channel>
    </rss>
    Изтеглете примерен XML продуктов фийд »
    Изтеглете примерен CSV продуктов фийд »


    2) Атрибути на фийд със статии

  • Attribute
    Type
    Description
  • guid

    Type: string

    *required

    Article ID

    A unique article ID. Each Article ID must appear only once in your feed. If there are multiple instances of the same ID, we ignore all duplicates.

    Only numbers and latin letters

    Example: 123AFE

  • link

    Type: url address

    *required

    Article URL

    The URL to the specific article page. Links must begin with http:// or https://, be valid and be hosted on your business’s website domain.

    Example: https://yourdomain.com/article_page.html

  • title

    Type: string

    *required

    Article Title

    A specific, relevant title for the Article.

    We recommend a maximum of 200 characters to avoid longer titles being cut off.

  • enclosure url=""

    Type: url address

    *required

    Article Image URL

    The URL should lead to an image in jpeg, png or webp format.

  • category

    Type: string

    optional

    Article Category

  • author

    Type: string

    optional

    Author

  • pubDate

    Type: date

    optional

    Article Publish Date

  • Примерен фийд със статии:
     <?xml version="1.0" encoding="UTF-8"?>
    <rss xmlns:g="http://base.google.com/ns/1.0" version="2">
      <channel>
        <title>Feed Title</title>
        <link>https://domain.com/</link>
        <description></description>
        <item>
          <guid>112397</guid>
          <title>Заглавие на статията</title>
          <link>https://domain.com/article-name</link>
          <enclosure url="https://domain.com/image_name.jpg" />
          <pubDate>Mon, 24 Jun 2024 06:11:18 +0000</pubDate>
          <category>Категория на продукта</category>
          <g:author>Иван Иванов</author>
        </item>
      </channel>
    </rss>
    Изтеглете примерен XML фийд със статии »
    Изтеглете примерен CSV фийд със статии »