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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

পূর্বশর্ত

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

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

Source

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

Destination

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

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

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

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

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

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

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

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

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

নোট

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

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

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

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

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

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

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

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

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

নোট

নামটি সেগমেন্ট অ্যাপে একটি লেবেল হিসাবে ব্যবহৃত হয়, এবং সেগমেন্ট আপনার ওয়্যারহাউসে একটি সম্পর্কিত স্কিমা নাম তৈরি করে। নামটি যেকোনো কিছু হতে পারে, তবে 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 সেগমেন্ট ইভেন্ট ডেটা পাঠাতে সেগমেন্ট স্ট্রিম Source কম্পোনেন্ট ব্যবহার করে। এটি সেগমেন্টে ডেটা পাঠাতে একটি সার্ভার-সাইড ট্র্যাক পদ্ধতি ব্যবহার করে। এই ইভেন্টগুলি তখন যেকোনো ডেস্টিনেশনে উপলব্ধ থাকে যা সার্ভার-সাইড ইভেন্ট গ্রহণ করে, এবং আপনার ডেটা ওয়্যারহাউসে একটি স্কিমাতে উপলব্ধ থাকে।

ডিফল্টরূপে, 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	বার্তার ধরন (পুশ, ইমেল, ইন-অ্যাপ বা এসএমএস) ধারণ করে
campaign_code	বার্তা প্রচারণার অনন্য শনাক্তকারী
device_type	ডিভাইসের ধরন

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

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

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

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

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

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

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

Destination

track-user

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

post-event

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

delete-user

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

Source

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

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

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

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

Destination

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

Source

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 ডকুমেন্টেশনে উপলব্ধ।