সেগমেন্ট ইন্টিগ্রেশন

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

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

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

ইন্টিগ্রেশন সেট হয়ে গেলে, সেগমেন্ট নিম্নলিখিত ডেটা Pushwoosh-এ পাঠাবে:

• ব্যবহারকারীর অ্যাট্রিবিউট: নাম, ডিভাইস, পছন্দ, অবস্থান, আচরণ ইত্যাদি। Pushwoosh এই ডেটা প্রতিটি ব্যবহারকারীর জন্য ট্যাগ এবং তাদের মান হিসাবে সংরক্ষণ করবে।
• ইভেন্ট: প্রতিটি সেগমেন্ট ইভেন্ট Pushwoosh-এ স্থানান্তরিত হবে এবং একই নামে একটি Pushwoosh ইভেন্ট হিসাবে সংরক্ষিত হবে। Pushwoosh প্রতিটি ব্যবহারকারী কোন কোন ইভেন্ট ট্রিগার করেছে সেই তথ্যও পাবে।

সেগমেন্ট ডেটা ব্যবহার করে, আপনি Pushwoosh-এ আপনার দর্শকদের জন্য নির্বিঘ্ন যোগাযোগ চালিয়ে যেতে পারেন। দুটি প্ল্যাটফর্মের শক্তিকে কাজে লাগানোর দুটি উদাহরণ নিচে দেওয়া হলো:

১. ব্যবহারকারীর আচরণের ডেটার উপর ভিত্তি করে টার্গেটেড ক্যাম্পেইন তৈরি করুন। নির্দিষ্ট ব্যবহারকারীর আচরণের উপর ভিত্তি করে Pushwoosh-এ সুনির্দিষ্ট ব্যবহারকারী সেগমেন্ট তৈরি করতে সেগমেন্ট থেকে ইভেন্ট ডেটা ব্যবহার করুন।

উদাহরণস্বরূপ, সেগমেন্ট SubscribedToOffers ইভেন্ট সম্পর্কে ডেটা Pushwoosh-এ পাঠায়। আপনি Pushwoosh-এ এমন ব্যবহারকারীদের একটি সেগমেন্ট তৈরি করতে পারেন যারা বিশেষ অফারে সাবস্ক্রাইব করেছেন:

তারপর, আপনি আপনার অফারে সাবস্ক্রাইব করা ব্যবহারকারীদের জন্য প্রোমো বার্তা এবং ডিসকাউন্ট সহ আকর্ষণীয় কাস্টমার জার্নি তৈরি করতে পারেন:

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

উদাহরণস্বরূপ, সেগমেন্ট searched_product অ্যাট্রিবিউটের মান Pushwoosh-এ পাঠায়। আপনি এমন একটি পুশ প্রিসেট তৈরি করতে পারেন যা ব্যবহারকারীর পূর্বে অনুসন্ধান করা বিভাগ থেকে পণ্যের উপর ডিসকাউন্ট অফার করে:

প্রতিটি ব্যবহারকারী ঠিক সেই পণ্যের বিভাগে একটি ডিসকাউন্ট অফার করে একটি পুশ পাবেন যা তারা আগে ব্রাউজ করেছিল। উদাহরণস্বরূপ, যারা স্পোর্টস জুতা অনুসন্ধান করেছিল তারা এই বার্তাটি দেখতে পাবে:

ইন্টিগ্রেশনের সংক্ষিপ্ত বিবরণ

ইন্টিগ্রেশনের প্রকার

• Destination: ডেটা সেগমেন্ট থেকে Pushwoosh-এ পাঠানো হয়।
• Source: ডেটা Pushwoosh থেকে সেগমেন্টে পাঠানো হয়।

পূর্বশর্ত

Pushwoosh এবং সেগমেন্ট উভয় ক্ষেত্রেই পেইড অ্যাকাউন্ট

সিঙ্ক্রোনাইজড সত্তা

Source

• পুশ পরিসংখ্যান

Destination

• ডিভাইস
• ট্যাগ

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

নোটিফিকেশন ট্র্যাকিং

পুশ নোটিফিকেশন পাঠান এবং তাদের স্ট্যাটাস ট্র্যাক করুন, যার মধ্যে রয়েছে সেগুলি সফলভাবে পাঠানো এবং ডেলিভারি হয়েছে কিনা।

ইভেন্ট বিশ্লেষণ

ব্যবহারকারী-ট্রিগার করা ইভেন্টগুলি বিশ্লেষণ করুন, যেমন পুশ নোটিফিকেশন বা ইমেল ডেলিভারি, এবং নিশ্চিত করুন যে এই ইভেন্টগুলি সেগমেন্টে সঠিকভাবে রেকর্ড করা হয়েছে।

ব্যবহারকারী ব্যবস্থাপনা

ব্যবহারকারীর তথ্য নিবন্ধন এবং পরিচালনা করুন, যার মধ্যে ব্যবহারকারীদের প্রাসঙ্গিক অ্যাট্রিবিউট দিয়ে ট্যাগ করা বা প্রয়োজনে ব্যবহারকারীদের মুছে ফেলা অন্তর্ভুক্ত।

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

নোট

সেগমেন্টের সাথে ইন্টিগ্রেশন সেট আপ করার আগে, নিশ্চিত করুন যে Pushwoosh SDK ইন্টিগ্রেট করা আছে।

একটি Destination কনফিগার করা

১. সেগমেন্ট ইন্টারফেসে, Connections → Destinations-এ নেভিগেট করুন এবং Add Destination-এ ক্লিক করুন।

২. Pushwoosh অনুসন্ধান করুন এবং এটি নির্বাচন করুন।

৩. আপনি যে Source-গুলির সাথে Destination সংযোগ করতে চান তা চয়ন করুন।

৪. Destination সেটিংসে যান:

৫. Pushwoosh API কী এবং অ্যাপ্লিকেশন কোড লিখুন। নিশ্চিত করুন যে Enable Destination সুইচটি চালু আছে। এর পরে, Save Changes-এ ক্লিক করুন।

আমি API কী এবং অ্যাপ্লিকেশন কোড কোথায় পাব?

আপনি Settings → API Access বিভাগে API কী খুঁজে পেতে পারেন:

অ্যাপ্লিকেশন কোডটি Pushwoosh ইন্টারফেসের উপরের বাম কোণে, প্রকল্পের নামের ঠিক নিচে পাওয়া যাবে:

৬. Mappings ট্যাবে যান এবং নিশ্চিত করুন যে Create or Update User Profile এবং Track Events বিকল্পগুলি সক্রিয় আছে:

আপনার ইভেন্টগুলি সঠিকভাবে প্রক্রিয়া করা হয়েছে তা নিশ্চিত করার জন্য আপনার উৎস থেকে Pushwoosh-এ ইভেন্ট ক্ষেত্রগুলির ম্যাপিং যাচাই করা গুরুত্বপূর্ণ।

যদি একটি ইভেন্টে device_platform ক্ষেত্র না থাকে বা এই ক্ষেত্রটি ভুল হয়, তবে আপনার ইভেন্টটি উপেক্ষা করা হবে। উপরন্তু, যদি একটি ইভেন্টে userId বা deviceId কোনোটিই না থাকে, তবে এটিও উপেক্ষা করা হবে।

আপনার ম্যাপিং সঠিকভাবে কনফিগার করা হয়েছে তা নিশ্চিত করতে, Pushwoosh as Destination > Settings-এ যান।

তারপর, Mapping ট্যাবটি নির্বাচন করুন এবং Track Events পদ্ধতির জন্য Edit Mapping-এ ক্লিক করুন।

এরপরে, নিশ্চিত করুন যে আপনার ইভেন্টগুলির ম্যাপিং Pushwoosh-এ পাঠানো ইভেন্টগুলির সাথে সঠিক, এবং Device Platform এবং External User ID (বা Device ID) ক্ষেত্রগুলি সঠিকভাবে মিলেছে।

আপনার ইভেন্ট উপরের দেওয়া উদাহরণ থেকে ভিন্ন হতে পারে। তবে, মূল বিষয় হলো Pushwoosh-এ পাঠানো ইভেন্টের জন্য প্ল্যাটফর্ম এবং ডিভাইসের ডেটা স্থানান্তর মেলানো।

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

একটি Source কনফিগার করা

১. আপনার ওয়ার্কস্পেসের Sources catalog page থেকে, Add Source-এ ক্লিক করুন। ২. Sources Catalog-এ “Pushwoosh” অনুসন্ধান করুন, Pushwoosh নির্বাচন করুন এবং Add Source-এ ক্লিক করুন। ৩. পরবর্তী স্ক্রিনে, Source-কে একটি নাম দিন এবং অন্য কোনো সেটিংস কনফিগার করুন।

নোট

নামটি সেগমেন্ট অ্যাপে একটি লেবেল হিসাবে ব্যবহৃত হয়, এবং সেগমেন্ট আপনার ওয়্যারহাউসে একটি সম্পর্কিত স্কিমা নাম তৈরি করে। নামটি যেকোনো কিছু হতে পারে, তবে Pushwoosh এমন কিছু ব্যবহার করার সুপারিশ করে যা উৎসটিকেই প্রতিফলিত করে এবং আপনার পরিবেশগুলির মধ্যে পার্থক্য করে (উদাহরণস্বরূপ: Pushwoosh_Prod, Pushwoosh_Staging, Pushwoosh_Dev)।

৪. আপনার সেটিংস সংরক্ষণ করতে Add Source-এ ক্লিক করুন। ৫. সেগমেন্ট UI থেকে Write key কপি করুন। ৬. আপনার Pushwoosh অ্যাকাউন্টে লগ ইন করুন, এবং আপনি যে অ্যাপ্লিকেশনটি সংযোগ করতে চান তা নির্বাচন করুন। ৭. Settings > 3rd party integration > Segment-এ নেভিগেট করুন, Configure button-এ ক্লিক করুন, এবং আপনার সেগমেন্ট ওয়ার্কস্পেস থেকে আপনার Write key লিখুন। ৮. আপনি যে ইভেন্টগুলি এক্সপোর্ট করতে চান সেগুলির একটি তালিকা , ডিলিমিটার ব্যবহার করে Events ক্ষেত্রে লিখুন, অথবা যদি আপনি সমস্ত ইভেন্ট এক্সপোর্ট করতে চান তবে এটি খালি রাখুন, তারপর Apply-এ ক্লিক করুন।

স্ট্রিম

Pushwoosh সেগমেন্ট ইভেন্ট ডেটা পাঠাতে সেগমেন্ট স্ট্রিম Source কম্পোনেন্ট ব্যবহার করে। এটি সেগমেন্টে ডেটা পাঠাতে একটি সার্ভার-সাইড ট্র্যাক পদ্ধতি ব্যবহার করে। এই ইভেন্টগুলি তখন যেকোনো ডেস্টিনেশনে উপলব্ধ থাকে যা সার্ভার-সাইড ইভেন্ট গ্রহণ করে, এবং আপনার ডেটা ওয়্যারহাউসে একটি স্কিমাতে উপলব্ধ থাকে।

ডিফল্টরূপে, Pushwoosh সেগমেন্ট userId প্রপার্টি হিসাবে Pushwoosh User ID পাস করে। যদি কোনো সংশ্লিষ্ট User ID না থাকে, Pushwoosh সেগমেন্ট anonymousId হিসাবে HWID পাস করবে।

ইভেন্ট

নীচের সারণীতে সেই ইভেন্টগুলির তালিকা রয়েছে যা Pushwoosh সেগমেন্টে পাঠায়। এই ইভেন্টগুলি আপনার ওয়্যারহাউসে টেবিল হিসাবে এবং অন্যান্য ডেস্টিনেশনে নিয়মিত ইভেন্ট হিসাবে উপস্থিত হয়।

ইভেন্টের নাম	বর্ণনা
ইমেল পাঠানো হয়েছে	ইমেল সফলভাবে পাঠানো হয়েছে
পুশ পাঠানো হয়েছে	পুশ নোটিফিকেশন সফলভাবে পাঠানো হয়েছে
এসএমএস পাঠানো হয়েছে	প্রাপকের কাছে এসএমএস পাঠানো হয়েছে
পুশ খোলা হয়েছে	পুশ নোটিফিকেশন খোলা হয়েছে
ইমেল খোলা হয়েছে	ইমেল নোটিফিকেশন খোলা হয়েছে
ইমেল ডেলিভার হয়েছে	ইমেল সফলভাবে ডেলিভার হয়েছে
পুশ ডেলিভার হয়েছে	পুশ নোটিফিকেশন সফলভাবে ডেলিভার হয়েছে
এসএমএস ডেলিভার হয়েছে	এসএমএস সফলভাবে ডেলিভার হয়েছে
এসএমএস ডেলিভার হয়নি	এসএমএস ডেলিভারি ব্যর্থ হয়েছে
ইমেল বাউন্স হয়েছে	স্থায়ী ত্রুটির কারণে ইমেল প্রেরকের কাছে ফিরে এসেছে
ইমেল আনসাবস্ক্রাইব করা হয়েছে	ইমেল আনসাবস্ক্রাইব লিঙ্কে ক্লিক করা হয়েছে

ইভেন্ট প্রপার্টি

নীচের সারণীতে উপরে তালিকাভুক্ত ইভেন্টগুলিতে অন্তর্ভুক্ত প্রপার্টিগুলির তালিকা রয়েছে।

প্রপার্টির নাম	বর্ণনা
message_type	বার্তার ধরন ধারণ করে (পুশ, ইমেল, ইন-অ্যাপ বা এসএমএস)
campaign_code	বার্তা প্রচারণার অনন্য শনাক্তকারী
device_type	ডিভাইসের ধরন

ডেস্টিনেশন যোগ করা

এখন যেহেতু আপনার Source সেট আপ করা হয়েছে, আপনি এটিকে ডেস্টিনেশনগুলির সাথে সংযোগ করতে পারেন।

আপনার ডাউনস্ট্রিম সরঞ্জামগুলিতে লগ ইন করুন এবং দেখুন আপনার ইভেন্টগুলি প্রত্যাশিতভাবে উপস্থিত হচ্ছে কিনা এবং সেগুলিতে আপনার প্রত্যাশিত সমস্ত প্রপার্টি রয়েছে কিনা। যদি আপনার ইভেন্ট এবং প্রপার্টিগুলি উপস্থিত না হয়, তবে ইভেন্ট ডেলিভারি পরীক্ষা করুন এবং প্রতিটি সরঞ্জামের জন্য ডেস্টিনেশন ডক্স দেখুন।

যদি সেগমেন্টে ইভেন্টগুলি পৌঁছানোর ক্ষেত্রে কোনো সমস্যা হয়, আমাদের সহায়তা দলের সাথে যোগাযোগ করুন।

ইন্টিগ্রেশন কীভাবে কাজ করে

১. পুশ নোটিফিকেশন শুরু: একজন ক্লায়েন্ট Pushwoosh ইন্টারফেসের মাধ্যমে একটি পুশ নোটিফিকেশন শুরু করে প্রক্রিয়াটি শুরু করে। ২. ইভেন্ট উৎপাদন: Pushwoosh ব্যাকএন্ড পুশ নোটিফিকেশন অনুরোধটি প্রক্রিয়া করে এবং একটি ইভেন্ট তৈরি করে। এই ইভেন্টটি তখন Pushwoosh দ্বারা পরিচালিত channels-tracking-log নামের একটি Kafka টপিকে পাঠানো হয়। ৩. ইভেন্ট গ্রহণ: সেগমেন্ট ইন্টিগ্রেশন পরিষেবা ক্রমাগত channels-tracking-log Kafka টপিকটি শোনে এবং ইভেন্টগুলি আসার সাথে সাথে গ্রহণ করে। ৪. ইভেন্ট প্রক্রিয়াকরণ: গৃহীত ইভেন্টগুলি সেগমেন্ট ইন্টিগ্রেশন পরিষেবা দ্বারা প্রক্রিয়া করা হয়, যা সেগুলিকে সেগমেন্ট ট্র্যাক ইভেন্টে রূপান্তরিত করে। ৫. ইভেন্ট প্রেরণ: প্রক্রিয়াকৃত সেগমেন্ট ট্র্যাক ইভেন্টগুলি তখন আরও হ্যান্ডলিং এবং বিশ্লেষণের জন্য সেগমেন্ট ব্যাকএন্ডে পাঠানো হয়।

আপনি কীভাবে জানবেন যে ইন্টিগ্রেশন কাজ করছে?

Destination

track-user

আপনার Pushwoosh account > Your Connected Application > Audience > User Explorer-এ যান। আপনার ব্যবহারকারী/ডিভাইস খুঁজুন এবং সেগমেন্ট যে ট্যাগগুলি পাঠিয়েছে তা পরীক্ষা করুন।

post-event

আপনার Pushwoosh account > Your Connected Application > Audience > Events-এ যান। ইভেন্টটি নির্বাচন করুন, তিনটি ডট মেনুতে ক্লিক করুন এবং Event Statistics চয়ন করুন। নিশ্চিত করুন যে ইভেন্টটি গণনা করা হয়েছে।

delete-user

আপনার PW account > Your Connected Application > Audience > User Explorer-এ যান। নিশ্চিত করুন যে ব্যবহারকারী/ডিভাইসটি বিদ্যমান নেই।

Source

Pushwoosh থেকে সেগমেন্টে পাঠানো ইভেন্টগুলি সনাক্ত করতে Source debugger ব্যবহার করুন।

সমস্যা সমাধান

ইন্টিগ্রেশন স্ট্যাটাস পরীক্ষা করুন

Pushwoosh ইন্টিগ্রেশনের সমস্যা সমাধানের জন্য, নিম্নলিখিতগুলি যাচাই করে শুরু করুন:

Destination

• Track-User: Pushwoosh-এ Audience > User Explorer-এর অধীনে ব্যবহারকারী/ডিভাইস তথ্য এবং ট্যাগ যাচাই করুন।
• Post-Event: ইভেন্ট পরিসংখ্যান পরীক্ষা করে Pushwoosh-এ ইভেন্টটি গণনা করা হয়েছে তা নিশ্চিত করুন।
• Delete-User: নিশ্চিত করুন যে ব্যবহারকারী/ডিভাইসটি আর Pushwoosh-এ বিদ্যমান নেই।

Source

Pushwoosh থেকে ইভেন্টগুলি সঠিকভাবে সেগমেন্টে পাঠানো হয়েছে কিনা তা পরীক্ষা করতে Segment Debugger-এ সোর্স ডিবাগার ব্যবহার করুন।

ইভেন্টের অমিল

যদি ইভেন্টগুলি সেগমেন্টে সঠিকভাবে উপস্থিত না হয়, তবে নিশ্চিত করুন যে Pushwoosh ইভেন্টগুলি প্রদত্ত ম্যাপিং নিয়ম অনুযায়ী সেগমেন্ট ট্র্যাক ইভেন্টগুলির সাথে সঠিকভাবে ম্যাপ করা হয়েছে।

প্রমাণীকরণ সমস্যা

যাচাই করুন যে Pushwoosh এবং সেগমেন্টে অনুরোধগুলিতে সঠিক প্রমাণীকরণ টোকেন বা API কী ব্যবহার করা হয়েছে।

ডেটা প্রবাহ সমস্যা

নিশ্চিত করুন যে Pushwoosh এবং সেগমেন্টের মধ্যে ডেটা প্রবাহ নিরবচ্ছিন্ন এবং Kafka টপিকগুলি সঠিকভাবে পর্যবেক্ষণ করা হচ্ছে।

প্রায়শই জিজ্ঞাসিত প্রশ্ন

Pushwoosh থেকে সেগমেন্টে কোন ধরনের ইভেন্ট পাঠানো হয়?

সংরক্ষিত ইভেন্ট যেমন পুশ পাঠানো হয়েছে, ইমেল পাঠানো হয়েছে, এসএমএস পাঠানো হয়েছে, পুশ ডেলিভার হয়েছে, ইমেল ডেলিভার হয়েছে, এসএমএস ডেলিভার হয়েছে, এবং ইমেল বাউন্স হয়েছে সেগমেন্টে পাঠানো হয়।

আমি কীভাবে যাচাই করতে পারি যে ইভেন্টগুলি সঠিকভাবে সেগমেন্টে পাঠানো হয়েছে?

Pushwoosh থেকে পাঠানো ইভেন্টগুলি পরীক্ষা করতে সেগমেন্ট সোর্স ডিবাগার ব্যবহার করুন, এবং আপনার Pushwoosh অ্যাকাউন্টে ইভেন্ট পরিসংখ্যান পর্যালোচনা করুন যাতে সেগুলি সঠিকভাবে গণনা করা হয়েছে।

ইন্টিগ্রেশনের সাথে সমস্যা হলে আমার কী করা উচিত?

Pushwoosh-এ ব্যবহারকারী/ডিভাইস তথ্য, ইভেন্ট গণনা এবং ব্যবহারকারী মুছে ফেলা যাচাই করে ইন্টিগ্রেশন স্ট্যাটাস পরীক্ষা করুন। উপরন্তু, নিশ্চিত করুন যে সঠিক প্রমাণীকরণ টোকেন ব্যবহার করা হয়েছে এবং ডেটা প্রবাহ নিরবচ্ছিন্ন।

ইন্টিগ্রেশনে ব্যবহারকারী এবং ডিভাইসের তথ্য কীভাবে পরিচালনা করা হয়?

ব্যবহারকারী এবং ডিভাইসের তথ্য, অ্যাট্রিবিউট এবং ট্যাগ সহ, সেগমেন্ট থেকে অনুরোধের ভিত্তিতে Pushwoosh-এ নিবন্ধিত বা আপডেট করা হয়। মনে রাখবেন যে ডিফল্ট ট্যাগগুলি Pushwoosh-এ স্বয়ংক্রিয়ভাবে তৈরি হয় না।

আমি ইন্টিগ্রেশনের জন্য বিস্তারিত ডকুমেন্টেশন কোথায় পেতে পারি?

বিস্তারিত ডকুমেন্টেশন সেগমেন্ট এবং Pushwoosh ইন্টিগ্রেশন ম্যানুয়ালগুলিতে, সেইসাথে তাদের নিজ নিজ API ডকুমেন্টেশনে উপলব্ধ।