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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

পূর্বশর্ত

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

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

Source

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

Destination

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

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

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

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

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

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

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

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

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

নোট

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

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

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

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

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

নোট

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

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

Stream

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

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

Events

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

ইভেন্টের নাম	বিবরণ
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	ইমেল আনসাবস্ক্রাইব লিঙ্কে ক্লিক করা হয়েছে

Event Properties

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

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

Destinations যোগ করা

এখন আপনার Source সেট আপ হয়ে গেছে, আপনি এটিকে Destinations-এর সাথে সংযোগ করতে পারেন।

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

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

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

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

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

Destination

track-user

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

post-event

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

delete-user

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

Source

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

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

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

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

Destination

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

Source

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

ইভেন্ট অমিল

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

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

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

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

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

FAQ

Pushwoosh থেকে Segment-এ কোন ধরণের ইভেন্ট পাঠানো হয়?

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

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

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

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

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

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

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

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

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