Клавијо интеграција

Препораките и автоматизациите на Klaviyo работат само ако имаат ажурирана слика од вашиот каталог. Откако каталогот ќе се синхронизира, Klaviyo ги комбинира податоците за вашите производи со однесувањето на лице место и преку е-пошта (прегледани производи, настани за додадени во кошничка, настани за започната наплата и историја на купување) за да изгради персонализирани блокови за препораки, да активира известувања за враќање на залиха кога залихата ќе се надополни и да ги пополни е-пораките за напуштање на кошничката и прелистување со точните производи што ги прегледал купувачот. Klaviyo забележува дека производите на кои им недостасуваат клучни податоци, како што е слика, автоматски се исклучуваат од препораките и дека веќе купените или недостапните артикли се филтрираат од блоковите за предлози, па затоа комплетноста и точноста на фидот директно одредуваат колку добро функционираат овие текови.

Откако ќе се синхронизира прилагодениот каталог, Klaviyo им овозможува на маркетерите да влечат блок на производ во е-пошта за тек или кампања и да го пополнат динамички, без да пишуваат HTML, бидејќи во сопствената документација на Klaviyo се забележува дека „блоковите на производи не поддржуваат никаков прилагоден HTML“. Овие блокови можат да извлечат неодамна прегледани производи (врз основа на метриката „Прегледан производ“, артикли слични на она што го прегледал или нарачал клиентот, производи додадени во кошничката (од настаните „Додадено во кошничка“ или „Започната наплата“) или класични листи со бестселери и статички листи. За понапредни случаи на употреба, како што е сопственички механизам за препораки, Klaviyo исто така поддржува ознаки за пребарување во каталог кои се однесуваат на одредени артикли според нивниот уникатен ID на артикл во шаблоните. Сето ова зависи од тоа дали фидот на каталогот содржи чисти, комплетни записи за артикли со точни идентификатори.

Klaviyo поддржува две патеки за синхронизирање на надворешен каталог: хостиран прилагоден фид за каталог или директна интеграција преку Catalogs API.

За хостиран фид, Klaviyo прифаќа JSON или XML - CSV не е поддржан. Фидот мора да биде јавно достапен преку HTTPS, а Klaviyo го презема по фиксен распоред, а не по барање. Водичот на Klaviyo е експлицитен дека податоците во фидот треба да бидат „длабочини само на еден јазол, а не вгнездени JSON или XML“ (фидовите на Google Merchant се единствениот документиран исклучок), дека првата ставка во фидот мора да содржи секое поле што сакате да го мапирате за да може Klaviyo да ја детектира шемата и дека ниедно задолжително поле не треба да остане празно - Klaviyo препорачува да се користи „0“ за недостапни броеви и „n/a“ за недостапен текст, наместо да се изоставува полето. Датотеките на фидот можат да бидат до 100MB, иако Klaviyo препорачува да останат под 50MB за сигурна обработка, а поголемите каталози можат да се поделат на повеќе датотеки што се внесуваат во еден каталог.

Алтернативно, системите на кои им се потребни ажурирања во реално време или водени од настани можат директно да ги испраќаат ставките преку API-то на каталози на Klaviyo, кое користи формат на ID на ресурс од {integration_type}:::{catalog_type}:::{external_id} - на пример $custom:::$default:::3829918373-TShirt-1Клавијо моментално поддржува само $custom тип на интеграција спарен со $default тип на каталог.

Feedance го генерира хостираниот JSON или XML каталошки фид што Klaviyo го очекува, мапиран поле-по-поле на шемата на Klaviyo, така што не мора рачно да градите рамен фид со еден јазол или сами да одржувате прилагодена API интеграција.

1. Во Feedance, креирајте нов фид и изберете Klaviyo како шаблон за дестинација.
2. Мапирајте ги податоците за вашиот производ со задолжителните полиња на Klaviyo ($id, $title, $description, $link, $image_link) и додадете ги опционалните полиња што сакате да ги користите, како што се $price, $inventory_quantity, $inventory_policy и категории.
3. Објавете го фидот за да добиете јавна URL-адреса на фид хостирана на HTTPS од Feedance.
4. Во Klaviyo, одете во Содржина > Производи > Управување со прилагодени извори на каталог, кликнете на Додај нов извор и залепете ја URL-адресата на Feedance feed.
5. Конфигурирајте го мапирањето на полињата на страницата „Прилагодени извори“ на Klaviyo за да потврдите дека секој атрибут е правилно порамнет, а потоа контактирајте ја Поддршката на Klaviyo со вашите релевантни имиња на метрики и имиња на својства на ID на ставка, за да може нивниот тим да го финализира каталогот за производство, како што бара самиот процес на поставување на Klaviyo.
6. Откако Klaviyo ќе потврди дека каталогот е активен, следете ја првата синхронизација во Feedance и во Klaviyo за да ги откриете сите проблеми со мапирањето пред блоковите со препораки или тековите „Назад на залиха“ да бидат активни.

Klaviyo извлекува прилагодени каталошки канали на фиксен 6-часовен циклус. Ако вашиот канал се наоѓа зад слој за кеширање, документацијата на Klaviyo предупредува дека мора да го оневозможите кеширањето или рачно да го освежите кешот кога основните податоци ќе се променат, во спротивно Klaviyo ќе продолжи да извлекува застарени, кеширани податоци дури и по ажурирањата на вашиот извор. Освен самата синхронизација на каналот, моделите за препораки на Klaviyo имаат потреба од сопствена писта: платформата наведува дека обично се потребни од 2 дена до една недела за неговите системи да се обучат на нов каталог и дека моделите за препораки генерално се преобучуваат на секои 2-7 дена во зависност од употребата. Feedance, освежувајќи го вашиот канал сигурно на 6-часовниот каденца на Klaviyo, ги одржува промените во цените, залихите и новите производи да течат во таа јамка за обука толку брзо колку што дозволува сопствената архитектура на Klaviyo.

Документацијата за синхронизација и решавање проблеми на Klaviyo наведува неколку повторувачки причини за неуспеси во синхронизацијата на каталогот:

• Фидот не е достапен: Klaviyo не може да стигне до изворната URL-адреса, обично затоа што е заштитена со лозинка или на друг начин блокирана зад безбедносен слој.
• Застарени кеширани податоци: Слојот за кеширање пред URL-то на фидот му прикажува на Klaviyo стара верзија на датотеката, така што ажурирањата никогаш не се појавуваат сè додека кешот не се исчисти или освежи.
• Вгнездени структури на податоци: Парсерот на Klaviyo очекува податоците да бидат „длабочини само на еден јазол“, па затоа вгнездените JSON или XML (надвор од исклучокот на фидот на Google Merchant) нема да се мапираат правилно.
• Нецелосна прва ставка: Бидејќи Klaviyo ја користи првата ставка во фидот за да ја детектира шемата, ставка на која ѝ недостасуваат полиња што се појавуваат подоцна во датотеката може да предизвика тие полиња да бидат отфрлени за целиот каталог.
• Дупликати или недостасувачки идентификатори: Klaviyo има посебна статија за решавање проблеми со грешки во дупликат или недостасувачки идентификатор, а од страната на Catalogs API, обидот за креирање ставка со external_id што веќе постои враќа конфликт 409; неуспесите во групните задачи го наведуваат специфичното поле и причина во низа грешки во одговорот на API.
• Недостасуваат слики: Предметите без URL-адреса на слика се исклучени од моторот за препораки на Klaviyo, дури и ако остатокот од записот е валиден.

Одржувајте го ID-то на артикалот стабилен низ секоја синхронизација - Klaviyo ги совпаѓа артиклите на оваа вредност, така што промената на ID-то го тера Klaviyo да го третира постоечкиот производ како сосема нов и да ги ресетира сите акумулирани препораки и историја на залихи за него. Пополнете ги сите опционални полиња што Klaviyo може да ги користи за автоматизација, особено $price и $inventory_quantity, бидејќи податоците за залихите се потребни за да се вклучат тековите „Назад на залиха“ и кампањите за намалување на цените со извори на податоци за цени. Осигурајте се дека секоја артикл има валидна URL-адреса на HTTPS слика, бидејќи Klaviyo тивко ги отфрла производите без слика од блоковите за препораки, наместо да прави грешки. Ако управувате со повеќе од приближно 50MB податоци од каталогот, поделете ги на повеќе датотеки со канали насочени кон истиот каталог, наместо да туркате една преголема датотека, и ако вашиот каталог се приближува до документираните ограничувања на Klaviyo од 250,000 артикли, 500,000 варијанти или 2,500 категории, или вашиот канал ќе надмине 1 милион артикли, планирајте да контактирате со Поддршката на Klaviyo пред поставувањето, според нивните сопствени упатства.

Дали Klaviyo прифаќа CSV канали?
Не. Синхронизацијата на прилагодениот каталошки фид на Klaviyo прифаќа само JSON или XML; CSV не е поддржан формат.

По што се разликува прилагодениот фид на каталогот од API-то на каталозите?
Прилагодениот каталошки фид е хостирана датотека што Klaviyo ја влече според свој 6-часовен распоред. API-то на Catalogs ви овозможува директно да ги активирате креирањата, ажурирањата и бришењата на артиклите, што им одговара на трговците на кои им се потребни побрзи или ажурирања водени од настани отколку што може да обезбеди анкетиран фид.

Зошто мојот каталог не се ажурира во Клавијо?
Најчестите причини за документите на Klaviyo се кеширачки слој што прикажува застарени податоци, URL-адреса на фид што станала недостапна или заштитена или деформирана/вгнездена структура на фид што не го исполнува условот на Klaviyo со еден јазол.

Што ми е потребно во мојот фид за да ги овозможам известувањата „Назад на залиха“?
Водичот „Назад на залиха“ на Klaviyo бара полето $inventory_quantity на секоја ставка во вашиот прилагоден каталошки фид; без него, Klaviyo нема сигнал за залиха за да активира известување за повторно залиха.

Може ли да користам прилагоден HTML во блоковите за препораки за производи на Klaviyo?
Не. Документацијата на Klaviyo наведува дека блоковите на производи не поддржуваат прилагоден HTML; напредното форматирање бара користење на опцијата Source во текстуален блок или ознаки за пребарување во каталог.