ادغام کلاویو

موتورهای توصیه و اتوماسیون Klaviyo فقط در صورتی کار می‌کنند که تصویر به‌روزی از کاتالوگ شما داشته باشند. پس از همگام‌سازی کاتالوگ، Klaviyo داده‌های محصول شما را با رفتار در سایت و ایمیل (محصولات مشاهده شده، رویدادهای اضافه شده به سبد خرید، رویدادهای شروع پرداخت و سابقه خرید) ترکیب می‌کند تا بلوک‌های توصیه شخصی‌سازی شده ایجاد کند، هنگام تکمیل موجودی، اعلان‌های بازگشت موجودی را فعال کند و سبد خرید رها شده و ایمیل‌های رها شده را با محصولاتی که خریدار دقیقاً به آنها نگاه کرده است، پر کند. Klaviyo خاطرنشان می‌کند که محصولاتی که داده‌های کلیدی مانند تصویر را ندارند، به‌طور خودکار از توصیه‌ها حذف می‌شوند و اقلام از قبل خریداری شده یا ناموجود از بلوک‌های پیشنهاد فیلتر می‌شوند، بنابراین کامل بودن و دقت فید مستقیماً میزان عملکرد این جریان‌ها را تعیین می‌کند.

پس از همگام‌سازی یک کاتالوگ سفارشی، Klaviyo به بازاریابان اجازه می‌دهد تا یک بلوک محصول را به یک ایمیل جریان یا کمپین بکشند و آن را به صورت پویا و بدون نوشتن HTML پر کنند، زیرا مستندات خود Klaviyo خاطرنشان می‌کند که "بلوک‌های محصول از هیچ HTML سفارشی پشتیبانی نمی‌کنند." این بلوک‌ها می‌توانند محصولات اخیراً مشاهده شده (بر اساس معیار محصول مشاهده شده)، اقلامی مشابه آنچه مشتری مشاهده یا سفارش داده است، محصولات اضافه شده به سبد خرید (از رویدادهای اضافه شده به سبد خرید یا پرداخت شروع شده) یا لیست‌های کلاسیک پرفروش و استاتیک را استخراج کنند. برای موارد استفاده پیشرفته‌تر، مانند یک موتور توصیه اختصاصی، Klaviyo همچنین از برچسب‌های جستجوی کاتالوگ پشتیبانی می‌کند که اقلام خاص را با شناسه منحصر به فرد آنها در قالب‌ها ارجاع می‌دهند. همه اینها به فید کاتالوگ که حاوی سوابق اقلام تمیز و کامل با شناسه‌های مناسب است، بستگی دارد.

کلاویو از دو مسیر برای همگام‌سازی یک کاتالوگ خارجی پشتیبانی می‌کند: یک فید کاتالوگ سفارشی میزبانی‌شده یا ادغام مستقیم از طریق API کاتالوگ‌ها.

برای یک فید میزبانی‌شده، Klaviyo فرمت‌های JSON یا XML را می‌پذیرد - CSV پشتیبانی نمی‌شود. فید باید از طریق HTTPS به صورت عمومی قابل دسترسی باشد و Klaviyo آن را بر اساس یک برنامه ثابت و نه بر اساس تقاضا دریافت می‌کند. راهنمای Klaviyo به صراحت بیان می‌کند که داده‌های موجود در فید باید "فقط یک گره عمیق باشند، نه JSON یا XML تو در تو" (فیدهای Google Merchant تنها استثنای مستند هستند)، اولین مورد در فید باید شامل هر فیلدی باشد که قصد نگاشت آن را دارید تا Klaviyo بتواند طرحواره را تشخیص دهد، و هیچ فیلد الزامی نباید خالی بماند - Klaviyo توصیه می‌کند از "0" برای اعداد غیرقابل دسترس و "n/a" برای متن غیرقابل دسترس به جای حذف فیلد استفاده کنید. فایل‌های فید می‌توانند تا 100 مگابایت باشند، اگرچه Klaviyo توصیه می‌کند برای پردازش مطمئن، کمتر از 50 مگابایت باقی بماند و کاتالوگ‌های بزرگتر را می‌توان در چندین فایل تقسیم کرد که به یک کاتالوگ تغذیه می‌شوند.

از طرف دیگر، سیستم‌هایی که به به‌روزرسانی‌های بلادرنگ یا رویدادمحور نیاز دارند، می‌توانند موارد را مستقیماً از طریق API کاتالوگ‌های Klaviyo ارسال کنند، که از قالب شناسه منبع ... استفاده می‌کند. {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، به محتوا > محصولات > مدیریت منابع کاتالوگ سفارشی بروید، روی افزودن منبع جدید کلیک کنید و آدرس فید Feedance را جایگذاری کنید.
5. نقشه‌برداری فیلد را در صفحه منابع سفارشی Klaviyo پیکربندی کنید تا از قرارگیری صحیح هر ویژگی در ردیف‌های مختلف اطمینان حاصل کنید، سپس با پشتیبانی Klaviyo تماس بگیرید و نام‌های معیار و نام‌های ویژگی شناسه کالا را ارائه دهید تا تیم آنها بتواند کاتالوگ را برای تولید نهایی کند، همانطور که جریان راه‌اندازی خود Klaviyo ایجاب می‌کند.
6. به محض اینکه Klaviyo تایید کرد که کاتالوگ فعال است، اولین همگام‌سازی را در Feedance و در Klaviyo زیر نظر بگیرید تا قبل از فعال شدن بلوک‌های توصیه یا جریان‌های بازگشت به موجودی، هرگونه مشکل نقشه‌برداری را برطرف کنید.

Klaviyo فیدهای کاتالوگ سفارشی را در یک چرخه ثابت ۶ ساعته دریافت می‌کند . اگر فید شما پشت یک لایه ذخیره‌سازی قرار دارد، مستندات Klaviyo هشدار می‌دهد که هنگام تغییر داده‌های اساسی، باید ذخیره‌سازی را غیرفعال کنید یا حافظه پنهان را به صورت دستی تازه کنید، در غیر این صورت Klaviyo حتی پس از به‌روزرسانی‌های منبع شما، به دریافت داده‌های قدیمی و ذخیره شده ادامه خواهد داد. فراتر از همگام‌سازی فید، مدل‌های توصیه Klaviyo به مسیر مخصوص به خود نیاز دارند: این پلتفرم بیان می‌کند که معمولاً ۲ روز تا یک هفته طول می‌کشد تا سیستم‌های آن روی یک کاتالوگ جدید آموزش ببینند و مدل‌های توصیه عموماً هر ۲ تا ۷ روز بسته به میزان استفاده، دوباره آموزش داده می‌شوند. Feedance که فید شما را به طور قابل اعتمادی در ریتم ۶ ساعته Klaviyo به‌روزرسانی می‌کند، باعث می‌شود قیمت، موجودی و تغییرات محصول جدید به سرعتی که معماری خود Klaviyo اجازه می‌دهد، در آن حلقه آموزشی جریان پیدا کنند.

مستندات همگام‌سازی و عیب‌یابی Klaviyo چندین علت مکرر شکست همگام‌سازی کاتالوگ را ذکر می‌کند:

• دسترسی به فید امکان‌پذیر نیست: Klaviyo نمی‌تواند به URL منبع دسترسی پیدا کند، معمولاً به این دلیل که با رمز عبور محافظت می‌شود یا در پشت یک لایه امنیتی مسدود شده است.
• داده‌های ذخیره‌شده‌ی قدیمی: یک لایه ذخیره‌سازی در جلوی URL فید، نسخه قدیمی فایل را به Klaviyo ارائه می‌دهد، بنابراین به‌روزرسانی‌ها هرگز ظاهر نمی‌شوند تا زمانی که حافظه پنهان پاک یا به‌روزرسانی شود.
• ساختارهای داده تو در تو: تجزیه‌گر Klaviyo انتظار دارد داده‌ها «فقط در عمق یک گره» باشند، بنابراین JSON یا XML تو در تو (خارج از استثنای فید Google Merchant) نمی‌توانند به درستی نگاشت شوند.
• مورد اول ناقص: از آنجا که Klaviyo از اولین آیتم در فید برای تشخیص طرحواره استفاده می‌کند، فیلدهای از دست رفته یک آیتم که بعداً در فایل ظاهر می‌شوند، می‌توانند باعث حذف آن فیلدها برای کل کاتالوگ شوند.
• شناسه‌های تکراری یا مفقود: Klaviyo یک مقاله عیب‌یابی اختصاصی برای خطاهای شناسه تکراری یا مفقود دارد و در سمت Catalogs API، تلاش برای ایجاد یک آیتم با external_id که از قبل وجود دارد، خطای 409 Conflict را برمی‌گرداند؛ شکست‌های دسته‌جمعی کار، فیلد و دلیل خاص را در یک آرایه خطا در پاسخ API فهرست می‌کنند.
• تصاویر گمشده: مواردی که آدرس اینترنتی تصویر ندارند، حتی اگر بقیه رکورد معتبر باشد، از موتور پیشنهاد Klaviyo حذف می‌شوند.

شناسه کالا را در هر همگام‌سازی ثابت نگه دارید - Klaviyo با اقلامی که این مقدار را دارند مطابقت می‌دهد، بنابراین تغییر شناسه باعث می‌شود Klaviyo با یک محصول موجود به عنوان محصول کاملاً جدید رفتار کند و هرگونه توصیه انباشته و تاریخچه موجودی را برای آن بازنشانی کند. هر فیلد اختیاری که Klaviyo می‌تواند برای اتوماسیون استفاده کند، به ویژه $price و $inventory_quantity را پر کنید، زیرا داده‌های موجودی برای فعال کردن بازگشت به جریان‌های موجودی و داده‌های قیمت، کمپین‌های کاهش قیمت را تغذیه می‌کنند. مطمئن شوید که هر کالا دارای یک URL تصویر HTTPS معتبر است، زیرا Klaviyo به جای خطا، بی‌سروصدا محصولات بدون تصویر را از بلوک‌های توصیه حذف می‌کند. اگر بیش از تقریباً 50 مگابایت داده کاتالوگ را مدیریت می‌کنید، آن را در چندین فایل فید که به همان کاتالوگ اشاره دارند تقسیم کنید، و اگر کاتالوگ شما به سقف‌های مستند Klaviyo یعنی 250,000 کالا، 500,000 نوع یا 2,500 دسته نزدیک می‌شود، یا فید شما از 1 میلیون کالا فراتر می‌رود، طبق راهنمایی‌های خود Klaviyo، قبل از راه‌اندازی با پشتیبانی Klaviyo تماس بگیرید.

آیا کلاویو فیدهای CSV را می‌پذیرد؟
خیر. همگام‌سازی فید کاتالوگ سفارشی Klaviyo فقط JSON یا XML را می‌پذیرد؛ CSV فرمت پشتیبانی‌شده‌ای نیست.

فید کاتالوگ سفارشی چه تفاوتی با API کاتالوگ‌ها دارد؟
فید کاتالوگ سفارشی، فایل میزبانی شده‌ای است که Klaviyo طبق برنامه ۶ ساعته خود دریافت می‌کند. API کاتالوگ‌ها به شما امکان می‌دهد ایجاد، به‌روزرسانی و حذف اقلام را مستقیماً ارسال کنید، که برای بازرگانانی که به به‌روزرسانی‌های سریع‌تر یا رویدادمحور نسبت به فید نظرسنجی نیاز دارند، مناسب است.

چرا کاتالوگ من در کلاویو به‌روزرسانی نمی‌شود؟
شایع‌ترین دلایل خرابی اسناد Klaviyo عبارتند از: یک لایه ذخیره‌سازی که داده‌های قدیمی را ارائه می‌دهد، یک URL فید که غیرقابل دسترس یا محافظت شده است، یا یک ساختار فید ناقص/تودرتو که الزام تک‌گره‌ای عمیق Klaviyo را برآورده نمی‌کند.

برای فعال کردن هشدارهای بازگشت موجودی، در فید خود به چه چیزهایی نیاز دارم؟
راهنمای موجودی مجدد Klaviyo به فیلد $inventory_quantity در هر کالا در فید کاتالوگ سفارشی شما نیاز دارد؛ بدون آن، Klaviyo هیچ سیگنال موجودی برای فعال کردن اعلان موجودی مجدد ندارد.

آیا می‌توانم از HTML سفارشی در بلوک‌های پیشنهاد محصول Klaviyo استفاده کنم؟
خیر. مستندات Klaviyo بیان می‌کند که بلوک‌های محصول از HTML سفارشی پشتیبانی نمی‌کنند؛ قالب‌بندی پیشرفته به جای آن نیاز به استفاده از گزینه Source در یک بلوک متنی یا برچسب‌های جستجوی کاتالوگ دارد.