Magento ইন্টিগ্রেশন

ডেভেলপারের সহায়তা প্রয়োজন

ইন্টিগ্রেশন সেট আপ করার জন্য আপনার ডেভেলপমেন্ট টিমের সাহায্যের প্রয়োজন হবে। অনুগ্রহ করে এই গাইডটি তাদের সাথে শেয়ার করুন।

ইন্টিগ্রেশন ওভারভিউ

Magento একটি শীর্ষস্থানীয় ই-কমার্স প্ল্যাটফর্ম যা ব্যবসাগুলোকে বড় পরিসরে পণ্য, গ্রাহক এবং অর্ডার পরিচালনা করতে সাহায্য করে। Magento-কে Pushwoosh-এর সাথে ইন্টিগ্রেট করে, আপনি স্বয়ংক্রিয়ভাবে গ্রাহক, অর্ডার এবং পরিত্যক্ত কার্ট সিঙ্ক করতে পারেন, যা রিয়েল-টাইম মেসেজিং, টার্গেটেড সেগমেন্টেশন এবং ক্রস-চ্যানেল মার্কেটিং অটোমেশন সক্ষম করে। এটি আপনাকে আপনার স্টোরের কার্যকলাপ থেকে সরাসরি ব্যবহারকারীদের সাথে যুক্ত হতে এবং কনভার্সন বাড়াতে সাহায্য করে।

ইন্টিগ্রেশনের ধরণ

গন্তব্য: এই ইন্টিগ্রেশনটি আপনার Magento স্টোর থেকে Pushwoosh-এ ডেটা পুশ করে।

পূর্বশর্ত

এগিয়ে যাওয়ার আগে, নিম্নলিখিত বিষয়গুলো নিশ্চিত করুন:

• Magento অ্যাডমিন প্যানেলে অ্যাক্সেস

• একটি বৈধ Pushwoosh অ্যাকাউন্ট

• আপনার Pushwoosh API অ্যাক্সেস টোকেন এবং অ্যাপ কোড

• আপনার Magento সার্ভারে Composer ইনস্টল করা আছে

• সিস্টেমের প্রয়োজনীয়তা পূরণ করা হয়েছে:

  • PHP 7.4 / 8.x
  • Magento 2.3 / 2.4
  • Elasticsearch 7
  • RabbitMQ

শব্দকোষ

এনটিটির নামগুলো ভিন্ন হলে তাদের ম্যাপিং:

Magento	Pushwoosh
Customer	User

সিঙ্ক্রোনাইজ করা এনটিটির তালিকা:

• গ্রাহক
• অর্ডার
• পরিত্যক্ত কার্ট

ব্যবহারের ক্ষেত্র

• অর্ডার তৈরি এবং কার্ট পরিত্যক্ত হওয়ার ইভেন্টের উপর ভিত্তি করে পুশ নোটিফিকেশন পাঠান।

• গ্রাহকদের অ্যাট্রিবিউট (যেমন, অবস্থান, জন্মদিন) এর উপর ভিত্তি করে সেগমেন্ট করুন এবং টার্গেটেড ক্যাম্পেইন পাঠান।

• ব্রাউজার-ভিত্তিক প্রচারমূলক নোটিফিকেশন পাঠান।

ইন্টিগ্রেশন সেট আপ করুন

ইনস্টলেশন

নোট

Pushwoosh ইন্টিগ্রেশন ইনস্টল করার জন্য, নিশ্চিত করুন যে আপনার Composer ইনস্টল করা আছে।

1. আপনার Magento প্রজেক্টের রুটে নিম্নলিখিত Composer কমান্ডটি চালান:

composer require pushwoosh/magento2-integration

2. প্যাকেজটি ইনস্টল হয়ে গেলে, মডিউলটি ইনস্টল করার জন্য Magento সেটআপ চালান:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:clean

পোস্ট-ইনস্টলেশন কনফিগারেশন

ইনস্টলেশন সম্পন্ন করার পর:

1. Magento অ্যাডমিন প্যানেলে লগ ইন করুন।

2. Stores > Configuration > Pushwoosh > Configuration-এ নেভিগেট করুন।

সাধারণ সেটিংস

General বিভাগে, নিম্নলিখিত ক্ষেত্রগুলো কনফিগার করুন:

• Status: ইন্টিগ্রেশন সক্রিয় করতে এটি Enable-এ সেট করুন।
• API URL: Pushwoosh API এন্ডপয়েন্ট লিখুন: https://api.pushwoosh.com/
• API Key: অনুরোধ প্রমাণীকরণের জন্য প্রয়োজনীয় আপনার Pushwoosh API কী পেস্ট করুন। Pushwoosh API অ্যাক্সেস কী সম্পর্কে আরও জানুন
• App Code: আপনার মোবাইল বা ওয়েব অ্যাপ্লিকেশনের সাথে সঙ্গতিপূর্ণ Pushwoosh অ্যাপ কোড লিখুন।

গ্রাহক, অর্ডার এবং পরিত্যক্ত কার্ট সিঙ্ক করার জন্য উপলব্ধ কনফিগারেশন বিকল্পগুলো নিচে দেওয়া হলো।

অর্ডার সিঙ্ক কনফিগারেশন

আপনার Magento স্টোর এবং Pushwoosh-এর মধ্যে অর্ডারের ডেটা কীভাবে সিঙ্ক্রোনাইজ করা হবে তা নির্ধারণ করুন।

নিম্নলিখিত ক্ষেত্রগুলো পূরণ করুন:

Order Sync Enable	স্বয়ংক্রিয় অর্ডার সিঙ্ক্রোনাইজেশন সক্ষম করতে Yes-এ সেট করুন। যদি সক্ষম করা হয়, প্রক্রিয়াটি নির্ধারিত ক্রোন সময়সূচী অনুসরণ করবে। স্বয়ংক্রিয় সিঙ্ক্রোনাইজেশন অক্ষম করতে No-তে সেট করুন।
Cron Settings	শুধুমাত্র অর্ডার সিঙ্ক সক্ষম থাকলেই উপলব্ধ। ক্রোন জব কখন চালানো উচিত তা নিম্নলিখিত ক্ষেত্রগুলো ব্যবহার করে নির্ধারণ করুন: Minute, Hour, Day, Month, Weekday। Cron একটি সময়-ভিত্তিক শিডিউলার যা নির্দিষ্ট বিরতিতে স্বয়ংক্রিয়ভাবে কাজ চালায়।
Order Sync Numbers	প্রতিটি সিঙ্ক এক্সিকিউশনের সময় কতগুলো অর্ডার প্রসেস করা হবে তা নির্দিষ্ট করুন।
Order Sync in Real Time	অর্ডার প্লেস করার সাথে সাথে সিঙ্ক করতে Yes-এ সেট করুন।

এখানে আপনি অর্ডার সিঙ্ক্রোনাইজেশনের স্থিতিও দেখতে পারেন:

• Total Orders: সিঙ্ক্রোনাইজেশনের জন্য মূল্যায়ন করা মোট অর্ডারের সংখ্যা প্রদর্শন করে।
• Synced Orders: সফলভাবে Pushwoosh-এর সাথে সিঙ্ক্রোনাইজ করা অর্ডারের সংখ্যা।
• Not Synced Orders: যে অর্ডারগুলো এখনও সিঙ্ক্রোনাইজ করা হয়নি।
• Fail Synced Orders: যে অর্ডারগুলোর সিঙ্ক্রোনাইজেশন প্রচেষ্টা ব্যর্থ হয়েছে।

পরিত্যক্ত কার্ট সিঙ্ক কনফিগারেশন

আপনার Magento স্টোর এবং Pushwoosh-এর মধ্যে পরিত্যক্ত শপিং কার্টের ডেটা সিঙ্ক্রোনাইজেশন কনফিগার করুন।

নিম্নলিখিত ক্ষেত্রগুলো পূরণ করুন:

Abandoned Cart Syncing	পরিত্যক্ত কার্ট ডেটার স্বয়ংক্রিয় সিঙ্ক্রোনাইজেশন সক্ষম করতে Yes-এ সেট করুন। যদি সক্ষম করা হয়, সিঙ্ক্রোনাইজেশন নির্ধারিত ক্রোন সময়সূচী অনুযায়ী চলবে।
Cron Schedule Configuration	সিঙ্ক কখন চালানো উচিত তা নিম্নলিখিত ক্ষেত্রগুলো ব্যবহার করে নির্ধারণ করুন: Minute, Hour, Day, Month, Weekday। Cron একটি সময়-ভিত্তিক জব শিডিউলার যা নির্দিষ্ট বিরতিতে স্বয়ংক্রিয়ভাবে কাজ চালায়।
Number of Abandoned Cart	প্রতিটি সিঙ্ক্রোনাইজেশন রানের সময় কতগুলো পরিত্যক্ত কার্ট প্রসেস করা হবে তা নির্দিষ্ট করুন।
Minimum Inactivity Time	একটি কার্টকে পরিত্যক্ত হিসেবে বিবেচনা করার জন্য ন্যূনতম নিষ্ক্রিয়তার সময় (মিনিটে) সেট করুন। উদাহরণস্বরূপ, 60 মানে কমপক্ষে 60 মিনিট ধরে নিষ্ক্রিয় থাকা কার্টগুলো সিঙ্ক করার জন্য যোগ্য হবে।

এখানে আপনি সিঙ্ক্রোনাইজেশন কার্যকলাপের রিয়েল-টাইম মেট্রিক্সও দেখতে পারেন:

• Total Abandoned Carts: পরিত্যক্ত হিসেবে চিহ্নিত করা মোট কার্টের সংখ্যা।
• Synced Abandoned Carts: সফলভাবে Pushwoosh-এর সাথে সিঙ্ক্রোনাইজ করা কার্টের সংখ্যা।
• Not Synced Abandoned Carts: যে কার্টগুলো এখনও সিঙ্ক্রোনাইজ করা হয়নি।
• Fail Synced Abandoned Carts: যে কার্টগুলোর সিঙ্ক্রোনাইজেশন ব্যর্থ হয়েছে।

গ্রাহক সিঙ্ক কনফিগারেশন

আপনার Magento স্টোর থেকে Pushwoosh-এ গ্রাহক ডেটার সিঙ্ক্রোনাইজেশন কনফিগার করুন যাতে গ্রাহকের অ্যাট্রিবিউটের উপর ভিত্তি করে অডিয়েন্স সেগমেন্টেশন এবং ব্যক্তিগতকৃত মেসেজিং সক্ষম করা যায়।

নিম্নলিখিত ক্ষেত্রগুলো পূরণ করুন:

Customer Syncing	সমস্ত বিদ্যমান এবং নতুন গ্রাহক রেকর্ড সিঙ্ক্রোনাইজেশন সক্ষম করতে Yes-এ সেট করুন। সিঙ্কিং নির্ধারিত ক্রোন সময়সূচী অনুসরণ করবে এবং নির্দিষ্ট অ্যাট্রিবিউট ম্যাপিং ব্যবহার করবে।
Cron Schedule Configuration	সিঙ্ক কখন চালানো উচিত তা নিম্নলিখিত ক্ষেত্রগুলো ব্যবহার করে নির্ধারণ করুন: Minute, Hour, Day, Month, Weekday। Cron একটি সময়-ভিত্তিক জব শিডিউলার যা নির্দিষ্ট বিরতিতে স্বয়ংক্রিয়ভাবে কাজ চালায়।
Mapping Customer Custom Fields	সঠিক ডেটা স্থানান্তরের জন্য Magento গ্রাহক অ্যাট্রিবিউটগুলোকে Pushwoosh কাস্টম ফিল্ডে ম্যাপ করুন। উদাহরণ: Date of Birth → Birthday, First Name → firstName
Number of Customers	প্রতি ক্রোন রানে সিঙ্ক করার জন্য সর্বোচ্চ গ্রাহকের সংখ্যা সেট করুন।

এখানে আপনি সিঙ্ক্রোনাইজেশন পরিসংখ্যানও দেখতে পারেন:

• Total Customer: সিঙ্কিংয়ের জন্য চিহ্নিত মোট গ্রাহক রেকর্ডের সংখ্যা।
• Synced Customer: সফলভাবে Pushwoosh-এর সাথে সিঙ্ক্রোনাইজ করা গ্রাহকের সংখ্যা।
• Not Synced Customer: সিঙ্ক্রোনাইজেশনের জন্য অপেক্ষারত গ্রাহক।
• Fail Synced Customer: ত্রুটির কারণে সিঙ্ক করতে ব্যর্থ হওয়া গ্রাহক।

ওয়েব নোটিফিকেশন কনফিগারেশন

আপনার স্টোর ভিজিটরদের জন্য ওয়েব পুশ নোটিফিকেশন সক্ষম করতে Yes-এ সেট করুন। এই কার্যকারিতা অক্ষম করতে No-তে সেট করুন।

সক্ষম করা হলে, আপনার Magento স্টোর ব্যবহারকারীদের তাদের ব্রাউজারের মাধ্যমে রিয়েল-টাইম মেসেজ পাঠাতে পারে। নোটিফিকেশনগুলো প্রচারমূলক অফার, অর্ডার স্ট্যাটাস আপডেট, পরিত্যক্ত কার্ট রিমাইন্ডার এবং অন্যান্য মার্কেটিং যোগাযোগের জন্য ব্যবহার করা যেতে পারে।

কনফিগারেশন সংরক্ষণ করুন

সমস্ত প্রয়োজনীয় ক্ষেত্র পূরণ হয়ে গেলে, উপরের ডান কোণায় অবস্থিত Save Config বোতামে ক্লিক করুন। পরিবর্তনগুলো প্রয়োগ করার জন্য অনুরোধ করা হলে Magento ক্যাশে ক্লিয়ার করুন।

ম্যানুয়াল সিঙ্ক অপশন

নির্বাচিত গ্রাহকদের Pushwoosh-এ সিঙ্ক করুন

যদি আপনি সমস্ত গ্রাহককে স্বয়ংক্রিয়ভাবে সিঙ্ক্রোনাইজ করতে না চান, তাহলে আপনি ম্যানুয়ালি পৃথক বা নির্বাচিত গ্রাহকদের সিঙ্ক করতে পারেন।

1. Magento অ্যাডমিন প্যানেলে, Customers > All Customers-এ নেভিগেট করুন।
2. আপনি যে গ্রাহক(দের) সিঙ্ক করতে চান তাদের খুঁজুন এবং নির্বাচন করুন।
3. গ্রাহক তালিকার উপরে থাকা Actions ড্রপডাউন থেকে, Sync to Pushwoosh নির্বাচন করুন।

সিঙ্ক্রোনাইজেশন সম্পন্ন হলে, গ্রাহকের ডেটা আপনার Pushwoosh অ্যাকাউন্টের User Explorer বিভাগে প্রদর্শিত হবে, যেখানে Magento থেকে সমস্ত প্রাসঙ্গিক তথ্য স্থানান্তরিত হবে।

নির্বাচিত অর্ডার Pushwoosh-এ সিঙ্ক করুন

যদি আপনি সমস্ত অর্ডার স্বয়ংক্রিয়ভাবে সিঙ্ক্রোনাইজ করতে না চান, তাহলে আপনি ম্যানুয়ালি নির্দিষ্ট অর্ডার সিঙ্ক করতে পারেন। এর জন্য:

1. Magento অ্যাডমিন প্যানেলে, Sales > Orders-এ নেভিগেট করুন।

2. তালিকা থেকে এক বা একাধিক অর্ডার নির্বাচন করুন।

3. Actions ড্রপডাউন থেকে, Sync to Pushwoosh নির্বাচন করুন।

সিঙ্ক্রোনাইজেশনের পরে, অর্ডারটি Pushwoosh User Explorer-এর ব্যবহারকারী প্রোফাইলের ইভেন্টস বিভাগে PW_OrderCreated বা PW_OrderUpdated ইভেন্ট হিসেবে প্রদর্শিত হবে (যদি অর্ডারের স্থিতি পরিবর্তিত হয়), যার মধ্যে বিস্তারিত অর্ডারের তথ্য অন্তর্ভুক্ত থাকবে।

নির্বাচিত পরিত্যক্ত কার্ট সিঙ্ক করুন

ম্যানুয়ালি নির্বাচিত পরিত্যক্ত কার্ট সিঙ্ক করতে:

1. Magento অ্যাডমিন প্যানেলে, Abandoned Carts বিভাগে যান।
2. আপনি যে কার্টটি সিঙ্ক করতে চান তা নির্বাচন করুন।
3. Actions ড্রপডাউন থেকে, Sync to Pushwoosh নির্বাচন করুন।

দ্রষ্টব্য: নিশ্চিত করুন যে আপনি Abandoned Cart Sync সেটিংসে প্রয়োজনীয় নিষ্ক্রিয়তার সময়কাল কনফিগার করেছেন, যা নির্ধারণ করে কখন একটি কার্ট পরিত্যক্ত হিসেবে বিবেচিত হবে।

সিঙ্ক্রোনাইজেশনের পরে, পরিত্যক্ত কার্টের ডেটা Pushwoosh User Explorer-এর ব্যবহারকারী প্রোফাইলের Events বিভাগে PW_AbandonedCart ইভেন্ট হিসেবে বিস্তারিত তথ্যসহ প্রদর্শিত হবে।

এছাড়াও, ব্যবহারকারী প্রোফাইলে দুটি ট্যাগ সেট করা হবে:

• Abandoned Cart Date → PW_AbandonedCartDate
• Abandoned Cart ID → PW_AbandonedCartID

এই ট্যাগগুলো আপনার ইমেল টেমপ্লেটে কানেক্টেড কন্টেন্ট ব্যবহার করে পরিত্যক্ত কার্ট রিমাইন্ডার পাঠাতে ব্যবহার করা যেতে পারে। আরও জানুন

ইন্টিগ্রেশন কাজ করছে কিনা তা যাচাই করুন

ইন্টিগ্রেশন সঠিকভাবে কাজ করছে কিনা তা নিশ্চিত করতে:

1. Magento-তে একটি টেস্ট গ্রাহক তৈরি করুন।
2. গ্রাহকটিকে ম্যানুয়ালি Pushwoosh-এ সিঙ্ক করুন।
3. আপনার Pushwoosh ড্যাশবোর্ডে User Explorer খুলুন এবং গ্রাহকটিকে খুঁজুন।

যদি গ্রাহকটি User Explorer-এ প্রদর্শিত হয়, তাহলে এটি নির্দেশ করে যে সিঙ্ক্রোনাইজেশন সফল হয়েছে।