Использование раскрывающегося списка «Общий канал»

Папка «Общий канал» позволяет загружать несколько типов каналов в один ящик для каждой среды. В этом руководстве рассказывается, как использовать общий ящик, и приводятся ссылки на соответствующее руководство для соответствующего канала, который вы планируете использовать.

Общий дропбокс предполагает наличие двух отдельных загрузок:

1. Файл дескриптора: описывает тип канала, который вы будете загружать.
2. Файл(ы) фида: содержание фактического фида.

Структурирование поля дескриптора

Файл дескриптора загружается, чтобы сообщить нашей системе, какой тип фида вы загружаете. Это позволяет нам правильно проверять и обрабатывать фид. Файл дескриптора должен быть загружен перед содержимым фида и должен соответствовать следующим требованиям к именованию:

• Используйте расширение файла .filesetdesc.json.
• Каждое имя файла дескриптора должно быть уникальным и не может использоваться повторно при загрузке. Мы рекомендуем включать в имя файла метку времени создания.
  • Пример: Offers_1524606581.filesetdesc.json

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

Возможные значения поля name :

Пример файла дескриптора JSON для фида предложений с двумя сегментами доступен ниже:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

Структурирование контента ленты

После загрузки файла дескриптора вы затем загрузите все файлы фида для типа данных фида, соответствующего файлу конфигурации фида, указанному в вашем файле дескриптора. Имена файлов и пути к ним (относительно папки Dropbox) должны точно соответствовать тому, что было включено в поле data_file . Если какой-либо файл отсутствует, имеет неправильное имя или загружен в другое место, весь канал не будет обработан.

Содержимое этих файлов данных фида должно соответствовать соответствующей спецификации фида, указанной в файле дескриптора.

Имя каждого файла файла фида должно быть уникальным и не может использоваться повторно при загрузке. Мы рекомендуем включать в имя файла метку времени создания и номер сегмента (инкрементный идентификатор).

• Пример: Offer_1524606581_1.json

Размеры файлов фида и частота загрузки

• Размер файла фида не должен превышать 200 МБ (после сжатия).
• Для большинства интеграций потребуется использовать только один сегмент. Вы должны использовать как можно меньше осколков. Максимум 1000 шардов на фид.
• Отдельные записи, отправленные в одном сегменте, не обязательно отправлять в будущих фидах с тем же номером сегмента.
• Для повышения производительности разделите данные поровну между сегментами, чтобы все файлы сегментов были одинаковыми по размеру.
• При необходимости используйте gzip для сжатия каналов. Однако сделайте это для каждого отдельного сегмента канала.

Устранение неполадок и отладка

После загрузки файлов (файлов дескриптора и каналов) перейдите на панель мониторинга истории каналов ( документация ) на партнерском портале (перейдите в раздел «История» > «Фиды» ), чтобы следить за ходом приема ваших каналов.

Найдите введенное вами name в файле дескриптора в столбце «Название фида», чтобы найти свой фид.

После того как канал будет принят (со статусом « Success или Fail ), вы можете щелкнуть его строку, чтобы просмотреть подробную информацию об ошибках и предупреждениях.