Интеграция на вътрешни лица

Уиджетите за персонализиране на Insider, карусели с препоръки, потоци за изоставени колички и междуканални кампании (уеб push, имейл, SMS, WhatsApp, банери на сайта) се четат от един и същ продуктов каталог. Без синхронизиран фийд, Insider няма имена на продукти, цени, изображения или състояние на наличността, които да вмъква в тези изживявания.

Предоставянето на чист, правилно картографиран каталог на Insider също така защитава вашия Google Merchant Center и други рекламни емисии. Ако вашият екип вече поддържа оптимизиран за Feedance фийд за Google Merchant Center или Meta, обикновено можете да използвате повторно същите основни данни за продукта – преоформяйки ги във формата, очакван от Insider – вместо да изграждате и поддържате напълно отделен експорт.

Документацията на Insider относно интеграцията на каталог описва синхронизацията в реално време (или планираната) като механизма, който поддържа Smart Recommender да работи с актуални данни: с актуализирането на каталога ви, Insider One автоматично премахва продукти, които не са налични, от кампании и джаджи за препоръки, така че на купувачите никога да не се показват артикули, които не могат да купят.

Insider не публикува вътрешната логика за класиране на своя двигател за препоръки, така че третирайте това като гаранция за актуалност на данните, а не като описание на самия алгоритъм за персонализиране: поддържайте емисията точна и актуална, а препоръките надолу по веригата също остават точни и актуални.

Интеграцията с продуктов каталог на Insider (документирана в Методологията за интеграция на продуктов каталог, базирана на XML) приема XML фийдове в един от трите поддържани формата:

1. XML формат на Criteo — за търговци, които вече изнасят стандартизиран от Criteo фийд.
2. XML формат на Google Merchant — общата структура на именното пространство `g:`, използвана за Google Merchant Center, която системата за съпоставяне на атрибути в продуктовия каталог на Insider може автоматично да съпостави със собствените си атрибути.
3. Персонализиран XML формат — самодефинирана структура, където ръчно съпоставяте всеки етикет с атрибут Insider.

Insider също така поддържа актуализации на каталога чрез своите Ingest/Update API (базирани на JSON) като алтернатива на XML. Insider изрично не позволява едновременното изпълнение на XML фийда и API интеграцията за един и същ каталог — трябва да изберете един метод.

По време на настройката в панела Insider (InOne), вие също така посочвате името на продуктовия етикет (обикновено item освен ако вашият XML използва различна терминология), езиковата променлива и кои валути се показват във файла — XML интеграциите се конфигурират за всяка езикова променлива/магазин.

Списъкът с атрибути на продуктовия каталог на Insider документира набор от атрибути по подразбиране, които разпознава автоматично, когато името и типът на полето съвпадат, плюс поддръжка за напълно персонализирани атрибути, които сами дефинирате. Състоянието на изискването варира в зависимост от избрания тип емисия (вижте по-долу), но основните полета са:

Документацията на Insider предупреждава, че продуктите, на които липсва задължителен атрибут (като например item_id or in_stock) се игнорират по време на обработката, вместо да доведат до неуспех на целия фийд.

1. Във Feedance създайте или изберете продуктовия фийд, който искате да изпратите към Insider, като съпоставите изходните си данни с полетата, които Insider очаква: item_id, name, image_url, url, in_stock, Плюс price/original_price ако ще използвате емисия, базирана на приходи от акции.
2. Изберете Google Merchant XML като изходен формат във Feedance, ако искате автоматичното съпоставяне на атрибути на Insider да работи с минимално ръчно съпоставяне — това използва повторно същата структура на тагове `g:`, която много екипи вече поддържат за Google Merchant Center.
3. Публикувайте емисията и копирайте получения URL адрес на Feedance емисията.
4. В панела InOne на Insider отидете на „Интеграция с продуктов каталог“, изберете XML като метод на интеграция, наименувайте интеграцията, изберете Google Merchant (или Custom) като формат и поставете URL адреса на емисията Feedance като източник.
5. Задайте локал, продуктов етикет (по подразбиране за Insider е item), период на синхронизиране, приложими валути и активиране на откриване на изчерпване на наличности, ако е приложимо.
6. Ако URL адресът на вашия Feedance фийд е защитен, добавете необходимата двойка Header Key/Header Value, за да може Insider да удостовери самоличността си; в противен случай се уверете, че IP адресите на Insider са в списъка с разрешени, ако вашият хостинг има защитна стена/WAF/бот защита пред тях.
7. Картографирайте всички останали персонализирани атрибути, след което потвърдете — Insider ще валидира емисията и ще докладва броя на продуктите и покритието на атрибутите, преди да я активира.

Insider ви позволява да конфигурирате интервала на синхронизиране между 1 час и 5 дни при настройване на XML интеграцията. В собствената документация на Insider се отбелязва, че промените в каталога се прилагат при следващия цикъл на синхронизация, а не мигновено – така че ако разчитате на точност на наличностите или цените в реално време за светкавични продажби или бързо движещи се запаси, изберете най-краткия интервал, който вашият график за генериране на емисия на Feedance може да поддържа, вместо да приемате, че промените се разпространяват незабавно.

Insider Surfaces показва състоянието на интеграцията чрез състояния на валидиране, показани в панела InOne: Активно, Пасивно, Изчакващо валидиране, Готово за активиране, Неуспешно валидиране и Системна грешка. Документираните причини, които си струва да се следят, са:

• Липсват задължителни атрибути — липсващи продукти item_id, name или in_stock (или други полета, изисквани от избрания от вас тип емисия) се премахват безшумно от обработката, вместо да се блокира цялата емисия.
• URL адресът на емисията е блокиран от защитна стена/WAF/бот защита — ако вашият хостинг защитава XML URL адреса с IP ограничения или откриване на ботове, заявките за извличане на данни от Insider ще се провалят, освен ако IP адресите на Insider не са изрично в разрешения списък.
• Несъответстващо име на етикет на продукт — ако вашият XML не използва item като етикета на продукта и не зададете правилното име на етикета по време на настройката, Insider няма да може да анализира отделни продукти.
• Едновременно изпълнение на XML и API интеграция — Insider позволява само един активен метод за интеграция с каталог едновременно; активирането и на двата не се поддържа.

Това са общи практики за хигиена на фуражите, а не специфични изисквания за вътрешни лица:

• Държа in_stock и полетата за ценообразуване са толкова актуални, колкото позволява интервалът ви на синхронизиране — препоръките и релевантността на кампанията зависят пряко от актуалността на тези данни.
• Изберете типа на емисията (Наличност-Приходи, Наличност, Време на публикуване или Време на начало-край), който съответства на вашия бизнес модел, вместо да използвате по подразбиране общия модел за електронна търговия, тъй като Insider използва типа на емисията, за да реши кое измерение управлява филтрирането на препоръките.
• Използвайте повторно фийд, форматиран от Google Merchant, когато е възможно, така че автоматичното съпоставяне на атрибути на Insider да свърши съпоставянето вместо вас.
• Попълнете незадължителни атрибути като category, brand, и group_code въпреки че не са задължителни — те обикновено подобряват начина, по който персонализацията и групирането на варианти работят надолу по веригата.

Мога ли да използвам едновременно XML фийд и API интеграция за моя продуктов каталог на Insider?
Не. Insider позволява само един метод за интеграция — XML или API — да бъде активен за даден каталог едновременно.

Поддържа ли Insider директно фийдове, форматирани във формат на Google Merchant Center?
Да. Системата за съпоставяне на атрибути в продуктовия каталог на Insider е създадена за автоматично разпознаване на стандартната структура на етикета `g:` на Google Merchant, която е един от трите поддържани XML формата, наред с Criteo и Custom.

Колко бързо ще се покажат промените в цените или наличностите в Insider, след като актуализирам емисията си?
Само толкова бързо, колкото е конфигурираният от вас интервал за синхронизиране, който може да бъде зададен между 1 час и 5 дни — промените се прилагат при следващия цикъл на синхронизиране, а не мигновено.

Какви са минималните данни, необходими на Insider, за да приеме даден продукт?
Най-малко валиден item_id, nameи полетата, изисквани от избрания от вас тип емисия (например in_stock (за типове фийдове, които са съобразени с наличностите). Продуктите, на които липсват тези данни, се игнорират, вместо да се стигне до неуспех на целия фийд.