Инструкция по применению

Это сервис, который позволяет получить «оригинальные» товары офферов из admitad.com. По одной ссылке можно получить товары разных офферов, разложенные по категориям. При этом в выгрузке не будет дублей товаров и товаров, которые считаются мусором.

Основные задачи и принципы работы сервиса

Основной задачей является упрощение жизни вебмастерам при загрузки обработанных товаров офферов. Не для кого не секрет, что оригинальная выгрузка оффера — это огромный файл, обработать который на обычном хостинге или небольшом VPS очень сложно, а иногда и не возможно.

При этом, с большой долей вероятности вебмастеру нужно всего 2000 (цифра для примера) товаров, а не все 200 000 тысяч. ранее вебмастеру приходилось грузить все 200 тысяч, либо на локальной машине редактировать файл оффера и отбирать те товары которые нужны.

Как правило, такие товары загружались один раз и не обновлялись, либо обновлялись крайне редко. Отсюда неактуальные цены на товар, товар которого нет в наличии и другие проблемы. Как следствие — снижение конверсии.

adimport.ru на 99% решает поставленую выше задачу!

На мощном сервере, мы ежедневно обрабатываем терабайты оригинальных выгрузок, склеиваем дубли, отсеиваем мусор.

Таким образом, вебмастеру остается только сформировать ссылку на нужную его витрине группу товаров, загрузить товары в витрину и регулярно обновлять. Проблема актуальности товара, верной цены на товар, сложностью обработки больших объемов данных и другие проблемы будут решены.

Что такое дубль товара?

Дублем считается товар, у которого, в оригинальной выгрузке, в конкретно взятой категории оффера, есть товары с аналогичной ссылкой на карточку товара на сайте оффера. Больше всего дублей встречается в одежде. Связано это с тем, что одежда часто бывает разного размера и цвета (есть и другие параметры). При этом каждый размер и цвет в оригинальной выгрузке идет как отдельный товар, со своим id.

Что происходит с дублями при импорте товаров?

На момент первоначальной загрузки товаров в нашу систему и при обновлении, дубли склеиваются. Это означает следующее: из нескольких товаров (их бывает и 200 штук) получается один, который содержит в себе ВСЕ имеющиеся цвета, размеры, и прочие параметры. При этом, такой товар будет иметь минимальную цену из всех имеющихся дублей.

Дубли не загружаются в вашу витрину

Что такое мусорный товар?

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

Мусорный товар не загружаются в вашу витрину

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

Как начать работать

Програмные решения и тонкая настрока сервера позволила нам добиться максимальной скорости формирования файла для экспорта и отдачи файла пользователю. Так, для примера, csv файл содержащий 7000 товаров и размером 12 Мб формируется за 0.3 секунды, полностью скачивается за 0.5 секунды. Сервер adimport.ru находится в Москве, что удобно для подавляющего большинства пользователей.

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

Кликнув на главной странице adimport.ru на вышеуказанную ссылку вы попадаете не сервер api.admitad.com, где даете свое согласие на запуск приложения.

Внимание!

Если на момент запуска приложения вы не авторизированы на сайте admitad.com вам будет предложено авторизироваться, а уже затем вы сможете дать свое согласие на запуск приложения.

После успешной авторизации вам будет предложено выбрать площадку, с которой вы будите работать в данной сессии. Данные о площадке мы получим через admitad.com.

После выбора площадки вам будет доступно дерево оригинальной категоризации офферов для данной площадки.

Внимание!

Вы увидите только тех офферов, товары которых мы загрузили к себе в базу данных и к которым вы подключены в admitad.com

Далее, раскрываете нужных офферов, выбираете нужные категории и сохраняете шаблон экспорта.

Либо поиском по категориям (1) ищите нужные категории, отмечаете их (2) и сохраняете шаблон экспорта (3).

Посмотреть шаблоны экспорта можно в соседней вкладке, их можно редактировать

Структура выгрузки

При импорте товаров из выгрузки adimport учитывайте, что:

    1. Разделитель столбцов вертикальная черта |
    2. Ограничитель текста в ячейках одинарная кавычка '
    3. Разделитель изображений в поле picture пробел

Названия полей в сериализованной строке http://adimport.ru/?action=get_fields_import

Получить название полей можно так

	    <?php
			$str = file_get_contents('http://adimport.ru/?action=get_fields_import');
			$fields = unserialize($str);
			echo '<pre>';
			print_r($fields);
			echo '</pre>';
	

Приводим описание полей в выгрузке. Следует учесть, что у разных офферов значения остальных полей могут отличаться.

Поля в выгрузке adImport.ru
Элементы Описание
id_adimport Уникальный идентификатор товара в системе adimport.ru. По нему можете обновлять товары
ISBN International Standard Book Number — международный уникальный номер книжного издания, если их несколько, то указываются через запятую
adult Элемент обязателен для обозначения товара, имеющего отношение к удовлетворению сексуальных потребностей, либо иным образом эксплуатирующего интерес к сексу
age Возрастная категория товара
article Артикул товара
attrs ...
author Автор
available Статус доступности товара

false — товарное предложение на заказ. Магазин готов принять заказ и осуществить поставку товара в течение согласованного с покупателем срока, не превышающего двух месяцев (за исключением товаров, изготавливаемых на заказ, ориентировочный срок поставки которых оговаривается с покупателем во время заказа).

true — товарное предложение в наличии. Магазин готов сразу договариваться с покупателем о доставке / покупке товара.
barcode Штрихкод товара, указанный производителем
binding Переплет
brand ...
categoryId Название категории товара у оффера
country_of_origin Страна производства товара
currencyId Идентификатор валюты товара (RUR, USD, UAH, KZT)
delivery Элемент позволяет указать возможность доставки соответствующего товара

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

false — товар не может быть доставлен;

true — товар доставляется
description Описание товарного предложения
downloadable Элемент предназначен для обозначения товара, который можно скачать
format Формат аудиокниги
gender ...
id Уникальный идентификатор товара в системе admitad.com
local_delivery_cost Стоимость доставки данного товара
manufacturer_warranty Элемент предназначен для отметки товаров, имеющих официальную гарантию производителя.

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

false — товар не имеет официальной гарантии;

true — товар имеет официальную гарантию.
market_category Категория товара, в которой он должен быть размещен на Яндекс.Маркете
model Модель
modified_time Дата последнего изменения товара на сервере admitad.com
name Название товара
oldprice Старая цена
orderingTime ...
page_extent Количество страниц в книге
param Сожердит в себе сериализованную строку с параметрами товара Подробнее про содержимое в param
performed_by Исполнитель
pickup Элемент позволяет указать возможность зарезервировать выбранный товар и забрать его самостоятельно.

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

false — возможность «самовывоза» отсутствует;

true — товар можно забрать самостоятельно.
picture Изображение, может быть несколько через пробел
price Цена
publisher Издательство
sales_notes Элемент используется для отражения информации о минимальной сумме заказа, минимальной партии товара или необходимости предоплаты, а так же для описания акций, скидок и распродаж
series Серия
store Элемент позволяет указать возможность купить соответствующий товар в розничном магазине.

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

false — возможность покупки в розничном магазине отсутствует;

true — товар можно купить в розничном магазине.
syns ...
topseller ...
type ...
typePrefix Группа товаров / категория.
url Ваш партнреский адрес на карточку товара
vendor Производитель, бренд
vendorCode Код товара, указывается код производителя
weight Элемент предназначен для указания веса товара
year Год издания
advcampaign_id Идентификатор оффера у admitad.com
advcampaign_name Название оффера у admitad.com
deeplink Ваш deeplink у admitad.com

Поле param

Для получения параметров на странице сайта в виде паметр = значение необходимо выполнить над param следующие действия:

    
    <?php
		$p = unserialize($item['param']);
		if ($p)
		{
			$res = '<p><small>';
			foreach ($p as $k => $v)
			{
				$res .= $k.' : ';
				foreach ($v as $k1=>$v1)
					$res .= ' '.$k1;
				$res .= '<br>';
			}
			$res .= '</small></p>';
		}
    

В результате в строке $res будет находится строка с выводом параметров в виде Параметр : значение

Названия полей в выгрузке

По умолчанию, .CSV выгрузки формируются без названия полей. Почему?

Для того, что бы получить название полей в файле выгрузки необходимо в конец ссылки добавить

&fields_name=true

Обычная ссылка без названия полей

http://adimport.ru/export/?id=17272&last_import=&user=2&format=csv

Ссылка с названиями полей

http://adimport.ru/export/?id=17272&last_import=&user=2&format=csv&fields_name=true

Настройка Excel, OpenOffice

При работе с .CSV выгрузками adimport в программах типа Excel, OpenOffice следует учитывать, что:

    1. Разделитель столбцов вертикальная черта |
    2. Ограничитель текста в ячейках одинарная кавычка '

Поэтому настройка импорта .CSV файла в OpenOffice выглядит так, сделайте в точности как на изображении

Импорт в adCMS (начиная с версии 7.21)

Помните! Вы сможете делать импорт только тех товаров/купонов к офферам которым вы подключены в admitad

Поиском по категориям (1) ищите нужные категории, отмечаете их (2) и сохраняете шаблон экспорта (3).

Посмотреть шаблоны экспорта можно в соседней вкладке, их можно редактировать

Созданные шаблоны экспорта указывайте в разделе Редактирование ссылок

Внимание! Необходимо что бы категорий в adCMS уже существовали на момент импорта в них товаров.

Товар грузите в подкатегории (конечные категории) родитель уже будет содержать товары дочек

Запускаете импорт товаров

Дополнительные поля в выгрузке

Посмотреть сопоставленные поля можно в разделе Настройка импорта

Основные поля, которые важны для нормального функционирования импорта будут сопоставлены автоматически. Остальные на ваше усмотрение.

Один раз настраиваем импорт для всех категорий сразу!

Если во время импорта в adCMS появляются ошибки

Когда появляется алерт с ошибкой

Это ошибка в 99% возникает когда у вас не хватает оперативной памяти на сервере.

Делайте импорт не сразу всем категориям, а одной или двум, не более. У шарад-хостингов импорт ограничен 3000 товарами за раз (у вебхоста webhost1.ru так)

Необходимо посмотреть причину. Скрин ошибки или описание сообщите нам

Что бы решить задачу с вашей ошибкой нам необходимо знать причину ее возникновения.


Ранее полностью удаленные товары не получается загрузить

Необходимо удалить даты последнего импорта в настройках

Если дата есть, то вы получите обновления выгрузки (новые товары), а не все товары. Может получится, что новых товаров не будет и вы не получите товаров.


Файл не содержит товаров

  1. Либо Ваш сервер не смог скачать файл за 29 секунд;
    Как увеличить время ожидания http://adimport.ru/faq.php#time-dowload-file на начало скачивания файла
  2. Либо наш не смог его сформировать за это время;
  3. В файле огромное количество товара, оперативной памяти вашего хостинга не хватает для обработки

С момента последнего импорта не было обновлено ни одного товара

  1. Либо действительно нет новых товаров (не обновил оффер выгрузку)
  2. Либо вы исчерпали лимит 1000 товаров/месяц (если у вас бесплатный абонемент).
    Абонементы http://adimport.ru/price.php

Данные на бесплатном аккаунте можно посмотреть в верхнем правом углу http://adimport.ru

Если у вас платный абонемент, то сообщите пожалуйста в техническую поддержку логин в admitad и ссылку по которой делайте импорт что бы мы проверили.


Как увеличить время ожидания на начало скачивания файла

Открыть файл classes/file_manager.class.php

    
    public static function get_curl_file_info ($url)
    {
     $ch = curl_init();
     curl_setopt($ch, CURLOPT_URL, $url);
     curl_setopt($ch, CURLOPT_HEADER, false);
     curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
     //curl_setopt($ch, CURLOPT_TIMEOUT, ini_get('max_execution_time')-1);
     curl_setopt($ch, CURLOPT_TIMEOUT, 29; // ограничимся 29-ю секундами, на шаредах 30 максимум
	

29 замените на 59

При этом не забудьте увеличить время работы скриптов php на сервере


Импорт в WordPress

Для примера возьмем популярный плагин WP All Import

Прежде чем делать импорт необходимо изменить пару строк в файлах, а именно:

1. Делаем разделитель текста одинарная кавычка

В файле site.ru/wp-all-import-pro/libraries/XmlImportCsvParse.php

Находим строчку


'escape' => '"'

Меняем ее на


'escape' => "'"

2. Делаем разделитель у изображений пробел

В файле site.ru/wp-all-import-pro/views/admin/import/preview_images.php

Находим строчку


$line_imgs = explode("\n", $featured_images);

Меняем ее на


$line_imgs = explode(" ", $featured_images);

Далее в файле site.ru/wp-all-import-pro/models/import/record.php

Находим строчку


$url = str_replace(" ", "%20", trim(pmxi_convert_encoding($img_url)));

Меняем ее на


$url = explode(" ", trim(pmxi_convert_encoding($img_url)));
$url = $url[0];	

При импорте товаров из выгрузки adimport учитывайте, что:

    1. Разделитель столбцов вертикальная черта |
    2. Ограничитель текста в ячейках одинарная кавычка '
    3. Разделитель изображений в поле picture пробел
Внимание!
Мы не оказываем поддержки по сторонним плагинам и модулям, пожалуйста, спрашивайте в поддержке у этих продуктов

Если вы обнаружили некачественный товар

Если вы заметили товар без изображения, цены, ссылки на карточку оффера

Передайте нам пожалуйста id_adimport такого товара

По всем вопросам http://www.cpasoft.ru/support/open.php

Благодарности

Мы выражаем огромную благодарность нашим пользователям, которые откликнулись на нашу просьбу поучаствовать в тестировании сервиса, и только благодаря им, работа сервиса «доведена до ума».

  • Неволько Игорь, Москва, Россия.
  • Ягжин Роман, Екатеринбург, Россия.
  • Пашнюк Виталий, Киев, Украина.
  • Крайнев Георгий, Тольятти, Россия.
  • Малахов Павел, Луганск, Украина.
  • Белоусов Дмитрий, Челябинск, Россия

Все пожелания и предложения по работе сервиса направлять сюда
http://adimport.ru/idea.php

Что будет дальше?

Будут добавлены все товары всех офферов, которые будут регулярно обновляться. Для adCMS будет написан функционал для обновления товаров по CRON.

Поиск товаров на Sphinx с возможностью выбрать необходимые товары.

Дальнейшее совершенствование и оптимизация сервиса.

Контакты

Разработчику


По братски, напиши отзыв :)


© «Инструменты партнерского маркетинга», 2014 —        

q: 4
/
t: 0.013

Made by CPASoft.Ru with love and caffeine