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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

পূর্বশর্ত

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

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

সোর্স

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

ডেস্টিনেশন

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

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

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

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

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

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

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

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

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

নোট

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

একটি ডেস্টিনেশন কনফিগার করা

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

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

3. আপনি যে সোর্সগুলির সাথে ডেস্টিনেশন সংযোগ করতে চান তা চয়ন করুন।

4. ডেস্টিনেশন সেটিংসে যান:

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

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

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

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

6. 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 সেগমেন্ট থেকে ইভেন্টস এবং ব্যবহারকারীর অ্যাট্রিবিউট গ্রহণ করা শুরু করবে। এই ডেটার উপর ভিত্তি করে, আপনি অত্যন্ত টার্গেটেড কাস্টমার জার্নি তৈরি করতে এবং আপনার পুশ নোটিফিকেশন, ইন-অ্যাপ মেসেজ এবং ইমেলগুলি ব্যক্তিগতকরণ করতে পারেন।

একটি সোর্স কনফিগার করা

1. আপনার ওয়ার্কস্পেসের সোর্স ক্যাটালগ পৃষ্ঠা থেকে, Add Source-এ ক্লিক করুন।
2. সোর্স ক্যাটালগে “Pushwoosh” অনুসন্ধান করুন, Pushwoosh নির্বাচন করুন এবং Add Source-এ ক্লিক করুন।
3. পরবর্তী স্ক্রিনে, সোর্সটিকে একটি নাম দিন এবং অন্য কোনো সেটিংস কনফিগার করুন।

নোট

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

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

স্ট্রিম

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

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

ইভেন্টস

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

ইভেন্টের নাম	বর্ণনা
Email Sent	ইমেল সফলভাবে পাঠানো হয়েছে
Push Sent	পুশ নোটিফিকেশন সফলভাবে পাঠানো হয়েছে
SMS Sent	প্রাপকের কাছে SMS পাঠানো হয়েছে
Push Opened	পুশ নোটিফিকেশন খোলা হয়েছে
Email Opened	ইমেল নোটিফিকেশন খোলা হয়েছে
Email Delivered	ইমেল সফলভাবে ডেলিভার করা হয়েছে
Push Delivered	পুশ নোটিফিকেশন সফলভাবে ডেলিভার করা হয়েছে
SMS Delivered	SMS সফলভাবে ডেলিভার করা হয়েছে
SMS Not Delivered	SMS ডেলিভারি ব্যর্থ হয়েছে
Email Bounced	স্থায়ী ত্রুটির কারণে প্রেরকের কাছে ইমেল ফিরে এসেছে
Email Unsubscribed	ইমেল আনসাবস্ক্রাইব লিঙ্কে ক্লিক করা হয়েছে

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

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

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

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

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

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

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

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

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

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

ডেস্টিনেশন

track-user

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

post-event

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

delete-user

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

সোর্স

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

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

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

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

ডেস্টিনেশন

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

সোর্স

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

ইভেন্ট অমিল

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

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

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

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

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

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

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

সংরক্ষিত ইভেন্ট যেমন Push Sent, Email Sent, SMS Sent, Push Delivered, Email Delivered, SMS Delivered, এবং Email Bounced সেগমেন্টে পাঠানো হয়।

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

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

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

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

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

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

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

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