Папка «Общий канал» позволяет загружать несколько типов каналов в один ящик для каждой среды. В этом руководстве рассказывается, как использовать общий ящик, и приводятся ссылки на соответствующее руководство для соответствующего канала, который вы планируете использовать.
(Обратитесь к разделу «Экспорт фидов (сквозной)» или «Фиды (стартовый)» документации).Общий дропбокс предполагает наличие двух отдельных загрузок:
- Файл дескриптора: описывает тип канала, который вы будете загружать.
- Файл(ы) фида: содержание фактического фида.
Структурирование поля дескриптора
Файл дескриптора загружается, чтобы сообщить нашей системе, какой тип фида вы загружаете. Это позволяет нам правильно проверять и обрабатывать фид. Файл дескриптора должен быть загружен перед содержимым фида и должен соответствовать следующим требованиям к именованию:
- Для файла дескриптора необходимо использовать расширение
.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 МБ (после сжатия).
- Размер каждого файла распакованных данных должен быть менее 2 ГБ.
- Для большинства интеграций потребуется использовать только один сегмент. Вы должны использовать как можно меньше осколков. Максимум 1000 шардов на фид.
- Отдельные записи, отправленные в одном сегменте, не обязательно отправлять в будущих фидах с тем же номером сегмента.
- Для повышения производительности разделите данные поровну между сегментами, чтобы все файлы сегментов были одинаковыми по размеру.
- При необходимости используйте gzip для сжатия каналов. Однако сделайте это для каждого отдельного сегмента канала.
Устранение неполадок и отладка
После загрузки файлов (файлов дескриптора и каналов) перейдите на панель мониторинга истории каналов ( документация ) на партнерском портале (перейдите в раздел «История» > «Фиды» ), чтобы следить за ходом приема ваших каналов.
Найдите введенное вами name в файле дескриптора в столбце «Название фида», чтобы найти свой фид.
После загрузки канала (статус « Success или Fail ) вы можете щелкнуть его строку, чтобы просмотреть подробную информацию об ошибках и предупреждениях.