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

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

(Обратитесь к разделу «Экспорт фидов (сквозной)» или «Фиды (стартовый)» документации).

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

  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 ), вы можете щелкнуть его строку, чтобы просмотреть подробную информацию об ошибках и предупреждениях.