رفتن به محتوای اصلی
legion logomark logo
API لژیون

داده مشتری را با API به لژیون بفرستید

مشخص کنید چه داده‌ای ارسال می‌شود. هر رکورد باید شناسه مشتری و زمان واقعی داشته باشد. درخواست تکراری نیز نباید ایونت تازه بسازد.

  • معنی روشن برای هر ایونت
  • شناسه یکتا برای جلوگیری از تکرار
  • زمان وقوع، جدا از زمان دریافت
نمونه اکوسیستم اتصال سرویس‌ها به لژیون
پاسخ مستقیم

API لژیون چه کاری انجام می‌دهد؟

API اطلاعات را میان سیستم شما و لژیون جابه‌جا می‌کند. می‌توانید مشتری، خرید یا ایونت‌های پشتیبانی‌شده را ارسال کنید. هر درخواست به ساختار و شناسه مشخص نیاز دارد.

  • معنی روشن برای هر ایونت
  • شناسه یکتا برای جلوگیری از تکرار
  • زمان وقوع، جدا از زمان دریافت

برندهایی که از لژیون برای مدیریت رابطه با مشتری استفاده کرده‌اند

سینره
لیموهاست
کافه نون
رهنما
میس ویک
تیتانا
مسئله

این اتصال کجا معمولاً به مشکل می‌خورد؟

اتصال فنی زمانی ارزش دارد که منبع حقیقت، هویت مشتری، زمان ایونت و مسئولیت هر سیستم روشن بماند. مسئله‌های همین صفحه را قبل از توسعه دامنه اتصال بررسی کنید.

نمای جریان داده و قواعد در لژیون
۱

ایونت بدون معنی روشن

ممکن است درخواست از نظر فنی درست باشد. اما معنی ایونت اشتباه تعریف شده باشد. معنی هر ایونت را پیش از توسعه بنویسید.

۲

ثبت چندباره یک ایونت

خطای شبکه ممکن است ارسال را تکرار کند. بدون شناسه یکتا، همان رفتار چند بار ثبت می‌شود.

۳

زمان اشتباه ایونت

زمان دریافت با زمان وقوع یکسان نیست. برای داده تاریخی، زمان واقعی رفتار را بفرستید.

۴

فیلدهای ناهماهنگ

نام یا نوع فیلد نباید بدون هماهنگی تغییر کند. نسخه قرارداد را پیش از توسعه مشخص کنید.

معماری اتصال

داده، هویت و اقدام باید در یک جریان قابل بررسی قرار بگیرند

قابلیت‌های این صفحه نشان می‌دهند اتصال فقط انتقال رکورد نیست؛ داده باید به هویت درست برسد و در ادامه بتواند در سگمنت‌بندی، سفر مشتری یا اقدام بعدی استفاده شود.

ارسال ایونت مشتری

نام ایونت، شناسه یکتا و زمان وقوع را بفرستید. فقط اطلاعات لازم را همراه آن ارسال کنید.

به‌روزرسانی ویژگی مشتری

فیلد موردنظر را به شناسه مشتری وصل کنید. منبع اصلی آن فیلد باید مشخص باشد.

تعریف ایونت اختصاصی

ایونت می‌تواند خرید، دریافت خدمت یا تکمیل مرحله باشد. نام آن باید یک معنی ثابت داشته باشد.

جلوگیری از ثبت تکراری

برای هر ایونت یک شناسه یکتا بسازید. تلاش دوباره باید همان شناسه را نگه دارد.

ثبت زمان واقعی

زمان وقوع رفتار را جدا بفرستید. زمان دریافت درخواست نباید جای آن را بگیرد.

استفاده در اتومیشن

ایونت می‌تواند یک اتومیشن را شروع کند. رفتار ایونت دیررس یا تکراری را هم مشخص کنید.

نتیجه

اتصال درست چه چیزی را باید بهتر کند؟

نتیجه اتصال باید در کیفیت داده، یکپارچگی هویت و امکان استفاده از ایونت در تصمیم بعدی مشتری دیده شود.

داده سیستم اختصاصی در لژیون

رفتار ثبت‌شده در سیستم شما می‌تواند وارد پروفایل مشتری شود.

اجرای مسیر پس از ایونت

ایونت معتبر می‌تواند سگمنت را تغییر دهد. همچنین می‌تواند اتومیشن مشخصی را شروع کند.

فیلدهای متناسب با کسب‌وکار

می‌توانید ویژگی یا ایونت موردنیاز خود را تعریف کنید. معنی هر مورد باید مستند باشد.

خطای قابل پیگیری

شناسه و نسخه قرارداد، پیدا کردن خطا را ساده‌تر می‌کنند. درخواست تکراری نیز قابل تشخیص می‌ماند.

نحوه کار

این اتصال از منبع داده تا اقدام چگونه پیش می‌رود؟

ترتیب مراحل کمک می‌کند قرارداد داده و مالکیت هر مرحله قبل از گسترش اتصال روشن بماند.

  1. ۱

    قرارداد داده را بنویسید

    نام ایونت و فیلدهای لازم را مشخص کنید. شناسه مشتری و ایونت را هم بنویسید.

  2. ۲

    دسترسی API را امن کنید

    روش احراز هویت را طبق مستندات تنظیم کنید. کلیدها نباید در کد عمومی باشند.

  3. ۳

    یک درخواست نمونه بفرستید

    یک ایونت واقعی با شناسه مشخص ارسال کنید. نتیجه را در پروفایل همان مشتری ببینید.

  4. ۴

    خطا و تلاش دوباره را آزمایش کنید

    درخواست ناقص را آزمایش کنید. ارسال دوباره همان شناسه نباید رکورد تازه بسازد.

  5. ۵

    ایونت را به کاربرد وصل کنید

    پس از تأیید داده، آن را در سگمنت یا اتومیشن استفاده کنید. خطاها را نیز پیگیری کنید.

سناریوهای کاربردی

این اتصال در چه موقعیت‌هایی استفاده می‌شود؟

سناریوهای صفحه نشان می‌دهند داده ورودی چگونه باید به هویت مشتری و اقدام قابل استفاده متصل شود.

خرید از سیستم اختصاصی

خرید نهایی با شناسه مشتری ارسال می‌شود. زمان واقعی و شناسه یکتای خرید نیز ثبت می‌شوند.

تکمیل فرم یا مرحله

تکمیل یک فرم می‌تواند ایونت باشد. این ایونت می‌تواند پیگیری مشخصی را شروع کند.

تغییر وضعیت مشتری

وضعیت عضویت یا شعبه مرجع می‌تواند به‌روز شود. منبع اصلی این فیلد باید مشخص باشد.

ارسال داده تاریخی

ایونت قدیمی را با زمان واقعی بفرستید. ابتدا یک نمونه محدود را آزمایش کنید.

شروع اتومیشن با ایونت

یک ایونت اختصاصی می‌تواند اتومیشن را شروع کند. شرط توقف نیز باید از قبل نوشته شود.

وابستگی‌ها

این اتصال با کدام سیستم‌ها و جریان‌های داده درگیر است؟

برای هر وابستگی باید نقش سیستم، منبع داده و رفتار خطا یا تلاش مجدد مشخص باشد.

سیستم اختصاصی

ایونت یا ویژگی مشتری را با شناسه مشخص می‌فرستد.

n8n یا ابزار واسط

درخواست را به ساختار قرارداد لژیون تبدیل می‌کند.

پلتفرم داده مشتری لژیون

داده معتبر را در پروفایل مشتری ثبت می‌کند.

اتومیشن مشتری

ایونت معتبر را به شرط یا شروع مسیر وصل می‌کند.

استقرار

راه‌اندازی اتصال چگونه مرحله‌ای و قابل بررسی می‌ماند؟

قبل از توسعه دامنه، منبع داده، قرارداد فیلدها، هویت مشتری و سناریوی خطا را روی دامنه محدود بررسی کنید.

  1. مرحله ۱

    انتخاب یک ایونت

    برای فاز اول، یک ایونت واقعی را انتخاب کنید. نمونه داده آن را آماده کنید.

  2. مرحله ۲

    تنظیم احراز هویت

    دسترسی لازم را محدود کنید. نسخه قرارداد نیز باید از ابتدا مشخص باشد.

  3. مرحله ۳

    ارسال نمونه درخواست

    درخواست را با شناسه مشتری و زمان وقوع بفرستید. نتیجه را در پروفایل بررسی کنید.

  4. مرحله ۴

    اتصال به کاربرد

    ایونت تأییدشده را به یک سگمنت یا اتومیشن وصل کنید.

  5. مرحله ۵

    آزمایش خطا

    ورودی نامعتبر و تلاش دوباره را آزمایش کنید. درخواست تکراری نباید ایونت تازه بسازد.

پرسش‌های پرتکرار

سوالات پرتکرار

پاسخ کوتاه به پرسش‌هایی که معمولاً هنگام بررسی این راهکار، نیازهای فنی و مسیر راه‌اندازی مطرح می‌شوند.

شناسه ایونت چه کاربردی دارد؟

شناسه یکتا از ثبت دوباره همان ایونت جلوگیری می‌کند. در تلاش دوباره، همان شناسه را بفرستید.

پاسخ سؤال ۱

آیا می‌توان ایونت‌های قدیمی را وارد کرد؟

بله، اگر زمان واقعی و شناسه یکتا دارید. ابتدا یک نمونه محدود را آزمایش کنید.

پاسخ سؤال ۲

شناسه مشتری چه باید باشد؟

از شناسه‌ای استفاده کنید که در منبع اصلی پایدار است. قواعد شماره یا ایمیل را یکسان کنید.

پاسخ سؤال ۳

اگر API موقتاً خطا داد چه کنیم؟

خطا را ثبت کنید. سپس درخواست را با همان شناسه دوباره بفرستید.

پاسخ سؤال ۴

آیا API می‌تواند اتومیشن را شروع کند؟

بله، اگر ایونت در لژیون تعریف شده باشد. شرط توقف مسیر را هم مشخص کنید.

پاسخ سؤال ۵

آیا ووکامرس به API نیاز دارد؟

ابتدا اتصال آماده ووکامرس را بررسی کنید. API برای داده یا فرایند اختصاصی مناسب است.

پاسخ سؤال ۶

پیش از توسعه چه چیزی مستند شود؟

نمونه درخواست، فیلدها و شناسه‌ها را بنویسید. احراز هویت و رفتار خطا را هم مشخص کنید.

پاسخ سؤال ۷

لژیون را برای کسب‌وکارتان بررسی کنید

در دمو، نمونه درخواست و نتیجه آن را بررسی می‌کنیم.

همه یکپارچه‌سازی‌هاپلتفرم داده مشتریباشگاه مشتریان لژیونمستندات فنی لژیونسفر مشتری خودکاردرخواست دمو

API لژیون؛ اتصال داده و رویدادهای مشتری | لژیون