Загрузка тизеров через RSS/en — различия между версиями

Материал из Справочник сервиса Kadam.net
Перейти к: навигация, поиск
(Новая страница: «Download teasers via RSS»)
 
 
Строка 1: Строка 1:
 
<languages/>
 
<languages/>
<b>Технология RSS</b> позволяет массово загружать необходимую Вам информацию, без посещения площадки на которой она хранится. RSS существенно экономит время если вы регулярно посещаете одни и те же ресурсы, либо же выполняете однообразные действия.
+
<b> RSS technology </b> allows you to massively download the information you need, without visiting the site where it is stored. RSS saves a lot of time if you regularly visit the same resources, or perform the same actions.
Также технология RSS может быть использована для массовой загрузки тизеров без необходимости постоянно создавать их вручную.<br>
+
 
==Загрузка тизеров через RSS==
+
Also, RSS technology can be used for bulk loading of teasers without the need to constantly create them manually. <br />
1. Для загрузки тизеров с помощью RSS, необходимо в своем личном кабинете найти соответствующую тизерную рекламную кампанию и зайти в перечень рекламных материалов:
+
 
<i>Личный кабинет / Кампании / Кампании / Управление тизерами</i>
+
== Download teasers via RSS ==
2. В появившейся форме необходимо выделить тизер и нажать для него на кнопку "RSS":
+
1. To download teasers using RSS, you need in your personal account to find the appropriate teaser advertising campaign and go to the list of promotional materials:
[[Файл:RSS teasers 111.jpg|100px|centre|frame|рис. 1]]
+
 
3. На форме "Управление RSS" в поле "URL" следует внести ссылку на файл с rss-лентой. В течение 30 минут после сохранения, объявления попадут на модерацию при условии, что статус кампании "Активна" / "Приостановлена" / "Ожидает оплаты". Параллельно будет произведено сравнение существующих материалов с материалами в RSS ленте, если опция "Не удалять материалы при проверке RSS" не выбрана:
+
<i> My Account / Campaigns / Campaigns / Manage Teasers </i>
 +
 
 +
2. In the form that appears, select the teaser and click on the "RSS" button for it:
 +
[[File: RSS teasers 111.jpg | 100px | center | frame | image 1]]
 +
 
 +
3. On the "RSS management" form, in the "URL" field, add a link to the file with the rss feed. Within 30 minutes after saving, ads will be moderated if the campaign status is Active / Suspended / Awaiting Payment. In parallel, existing materials will be compared with materials in the RSS feed, if the option "Do not delete materials when checking RSS" is not selected:
 
<ul>
 
<ul>
      <li>Если материал есть в системе, но его нет в RSS - текущий материал будет удален;</li>
+
       <li> If the material is in the system, but not in the RSS, the current material will be deleted; </li>
      <li>Если материала нет в системе, но он есть в RSS - будет создан новый материал</li>
+
       <li> If the material is not in the system, but it is in RSS - a new material will be created </li>
 
</ul>
 
</ul>
[[Файл:Rssprimer.png|100px|centre|frame|рис. 2]]
+
[[File: Rssprimer.png | 100px | center | frame | image 2]]
4. Требования к загружаемому материалу:
+
 
 +
4. Requirements for downloadable material:
 
<ol>
 
<ol>
    <li>Сочетание «Изображение + заголовок + текст материала» должно быть уникально по системе;</li>
+
     <li> The combination “Image + header + text of the material” must be unique in the system; </li>
    <li>Длина заголовка не более 30 символов;</li>
+
     <li> Header length is no more than 30 characters; </li>
    <li>Длина текста не более 70 символов;</li>
+
     <li> Text length not exceeding 70 characters; </li>
    <li>Размер картинки не более 150Кб. Формат картинки: jpg, png, gif, jpeg;</li>
+
     <li> Picture size is no more than 150Kb. Picture format: jpg, png, gif, jpeg; </li>
    <li>Домен в URL материала должен совпадать с доменом в URL родительской кампании.</li>
+
     <li> Domain in the material URL must match the domain in the URL of the parent campaign. </li>
</ol>
+
</ ol>
Материалы, не подходящие по указанным выше параметрам, не будут пропускаться. Также в кампании создается количество материалов, разрешенное настройками пользователя.
+
 
Более детальное описание процедуры работы с тизерами можно найти в статье по <b>[[Список_материалов_кампаний#Тизеры |тизерам]]</b>.
+
Materials that are not suitable for the above parameters will not be skipped. The campaign also creates the amount of materials allowed by the user's settings.
Параметры RSS файла, которые обязательно должны быть заполнены:
+
 
 +
A more detailed description of the procedure for working with teasers can be found in the article on <b> [[List of materials from campaigns # Teasers | teasers]] </b>.
 +
 
 +
Parameters of the RSS file, which must be filled in:
 
<pre>
 
<pre>
          <item>
+
           <item>
                    <title>......</title>
+
                    <title> ...... </title>
                    <link>......</link>
+
                    <link> ...... </link>
                    <description>......</description>
+
                    <description> ...... </description>
                    <enclosure url=....../>                  
+
                    <enclosure url = ...... />
          </item>
+
           </item>
 
</pre>
 
</pre>
Данные по тизеру передаются в тэге <item>:
+
 
 +
Data on the teaser is transmitted in the <item> tag:
 
<ul>
 
<ul>
      <li><title> - заголовок тизера</li>
+
      <li> <title> - teaser title </li>
      <li><link> - ссылка для перехода</li>
+
      <li> <link> - link to go </li>
      <li><description> - текст тизера</li>
+
      <li> <description> - teaser text </li>
      <li><enclosure> - элемент для иллюстрации изображений, где в параметре url необходимо вставить ссылку на изображение</li>
+
      <li> <enclosure> - an element to illustrate images, where in the url parameter you need to insert a link to the image </li>
 
</ul>
 
</ul>
5. Правила сопоставления тэгов загружаемого файла с тэгами Kadam (данной логики необходимо придерживаться при заполнении полей на форме "Управление RSS"):
+
 
- Если тэг входит в древо другого тэга, иерархию между ними следует выделять через символы "//" (title//title1 или parameter//parameter1//parameter2). Указывать иерархию для тэгов 1-го уровня вложености не надо.
+
5. Rules for the mapping of downloadable file tags with Kadam tags (this logic must be followed when filling in the fields on the "RSS Management" form):
- Если тэг имеет определенный аттрибут, данный аттрибут необходимо выделить символами "::" (item//enclosure:url или parameter1//parameter2//parameter3//parameter4::atr1)
+
 
===Пример===
+
- If the tag is included in the tree of another tag, the hierarchy between them should be selected through the characters "//" (title // title1 or parameter // parameter1 // parameter2). It is not necessary to specify a hierarchy for tags of the 1st level of nesting.
Для корректной загрузки RSS файла, очень важно правильно сопоставить тэги используемые в Вашем файле с тэгами на стороне Kadam. Пример ниже иллюстрирует структуру загружаемого RSS файла, а также тэги, которые необходимо проставить на форме "Управление RSS":
+
 
 +
- If the tag has a specific attribute, this attribute must be selected with the characters "::" (item // enclosure: url or parameter1 // parameter2 // parameter3 // parameter4 :: atr1)
 +
 
 +
=== Example ===
 +
To correctly download the RSS file, it is very important to correctly match the tags used in your file with the tags on the Kadam side. The example below illustrates the structure of the downloadable RSS file, as well as tags that need to be put on the form "RSS management":
 +
 
 
<pre>
 
<pre>
    <item>
+
     <item>
              <title>Квест-комнаты в Москве.</title>
+
              <title> Quest Rooms in Moscow. </ title>
              <main>
+
              <main>
                    <link>
+
                    <link>
                      http://example-rss.ru/go_xml/tst:news::/inf_id:4810::/tsr_id:10481::/redirect:aHR0cDofcnNzMnRyYW5zaXQ/dXRtX3V0bV9tMz::
+
                      http://example-rss.ru/go_xml/tst:news::/inf_id:4810::/tsr_id:10481::/redirect:aHR0cDofcnNzMnRyYW5zaXQ/dXRtX3V0bV9tMz ::
                    </link>
+
                    </ link>
              </main>
+
              </ main>
              <description>
+
              <description>
                    <![CDATA[ Новое популярное развлечение, аж мурашки по коже! ]]>
+
                    <! [CDATA [New popular entertainment, already goosebumps! ]]>
              </description>
+
              </ description>
              <enclosure url="http://example-rss.ru/tiz.10481/300x300.jpg" type="image/jpeg" length="14953"/>            
+
              <enclosure url = "http://example-rss.ru/tiz.10481/300x300.jpg" type = "image / jpeg" length = "14953" />
    </item>
+
     </item>
 
</pre>
 
</pre>
Заполнение полей на форме "Управление RSS":
+
 
 +
Filling in the fields on the "RSS Management" form:
 
<table>
 
<table>
  <tr>
+
  <tr>
      <td><b>Поле</b></td>
+
      <td> <b> Field </b> </td>
      <td>     </td>
+
      <td> </td>
      <td><b>Значение поля</b></td>
+
      <td> <b> Field Value </b> </td>
  </tr>
+
  </tr>
  <tr>
+
  <tr>
      <td>Тело тизера</td>
+
      <td> Body Teaser </td>
      <td>     </td>
+
      <td> </td>
      <td>item</td>
+
      <td> item </td>
  </tr>
+
  </tr>
  <tr>
+
  <tr>
      <td>Заголовок</td>
+
      <td> Title </td>
      <td>     </td>
+
      <td> </td>
      <td>title</td>
+
      <td> title </td>
  </tr>
+
  </tr>
  <tr>
+
  <tr>
      <td>Ссылка для перехода</td>
+
      <td> Jump Link </td>
      <td>     </td>
+
      <td> </td>
      <td>main//link</td>
+
      <td> main // link </td>
  </tr>
+
  </tr>
  <tr>
+
  <tr>
      <td>Текст тизера</td>
+
      <td> Teaser Text </td>
      <td>     </td>
+
      <td> </td>
      <td>description</td>
+
      <td> description </td>
  </tr>
+
  </tr>
  <tr>
+
  <tr>
      <td>Ссылка на изображение картинки</td>
+
      <td> Image Link </td>
      <td>     </td>
+
      <td> </td>
      <td>enclosure::url</td>
+
      <td> enclosure :: url </td>
  </tr>
+
  </tr>
 
</table>
 
</table>

Текущая версия на 14:58, 11 февраля 2019

Другие языки:
English • ‎русский

RSS technology allows you to massively download the information you need, without visiting the site where it is stored. RSS saves a lot of time if you regularly visit the same resources, or perform the same actions.

Also, RSS technology can be used for bulk loading of teasers without the need to constantly create them manually.

Download teasers via RSS

1. To download teasers using RSS, you need in your personal account to find the appropriate teaser advertising campaign and go to the list of promotional materials:

My Account / Campaigns / Campaigns / Manage Teasers

2. In the form that appears, select the teaser and click on the "RSS" button for it:

image 1

3. On the "RSS management" form, in the "URL" field, add a link to the file with the rss feed. Within 30 minutes after saving, ads will be moderated if the campaign status is Active / Suspended / Awaiting Payment. In parallel, existing materials will be compared with materials in the RSS feed, if the option "Do not delete materials when checking RSS" is not selected:

           
  • If the material is in the system, but not in the RSS, the current material will be deleted;
  •        
  • If the material is not in the system, but it is in RSS - a new material will be created
image 2

4. Requirements for downloadable material:

         
  1. The combination “Image + header + text of the material” must be unique in the system;
  2.      
  3. Header length is no more than 30 characters;
  4.      
  5. Text length not exceeding 70 characters;
  6.      
  7. Picture size is no more than 150Kb. Picture format: jpg, png, gif, jpeg;
  8.      
  9. Domain in the material URL must match the domain in the URL of the parent campaign.
  10. </ ol>

    Materials that are not suitable for the above parameters will not be skipped. The campaign also creates the amount of materials allowed by the user's settings.

    A more detailed description of the procedure for working with teasers can be found in the article on teasers .

    Parameters of the RSS file, which must be filled in:

               <item>
                        <title> ...... </title>
                        <link> ...... </link>
                        <description> ...... </description>
                        <enclosure url = ...... />
               </item>
    

    Data on the teaser is transmitted in the <item> tag:

            
    • <title> - teaser title
    •       
    • <link> - link to go
    •       
    • <description> - teaser text
    •       
    • <enclosure> - an element to illustrate images, where in the url parameter you need to insert a link to the image

    5. Rules for the mapping of downloadable file tags with Kadam tags (this logic must be followed when filling in the fields on the "RSS Management" form):

    - If the tag is included in the tree of another tag, the hierarchy between them should be selected through the characters "//" (title // title1 or parameter // parameter1 // parameter2). It is not necessary to specify a hierarchy for tags of the 1st level of nesting.

    - If the tag has a specific attribute, this attribute must be selected with the characters "::" (item // enclosure: url or parameter1 // parameter2 // parameter3 // parameter4 :: atr1)

    Example

    To correctly download the RSS file, it is very important to correctly match the tags used in your file with the tags on the Kadam side. The example below illustrates the structure of the downloadable RSS file, as well as tags that need to be put on the form "RSS management":

         <item>
                  <title> Quest Rooms in Moscow. </ title>
                  <main>
                        <link>
                          http://example-rss.ru/go_xml/tst:news::/inf_id:4810::/tsr_id:10481::/redirect:aHR0cDofcnNzMnRyYW5zaXQ/dXRtX3V0bV9tMz ::
                        </ link>
                  </ main>
                  <description>
                        <! [CDATA [New popular entertainment, already goosebumps! ]]>
                  </ description>
                  <enclosure url = "http://example-rss.ru/tiz.10481/300x300.jpg" type = "image / jpeg" length = "14953" />
         </item>
    

    Filling in the fields on the "RSS Management" form:

                                                                                                                                                                     
    Field Field Value
    Body Teaser item
    Title title
    Jump Link main // link
    Teaser Text description
    Image Link enclosure :: url