RudderStack ইন্টিগ্রেশন
RudderStack একটি কাস্টমার ডেটা প্ল্যাটফর্ম যা আপনার অ্যাপ, ওয়েবসাইট, সার্ভার এবং ডেটা ওয়্যারহাউস থেকে ইভেন্ট সংগ্রহ করে এবং সেগুলো অন্যান্য টুলে পাঠায়। RudderStack-এ Pushwoosh destination ব্যবহার করলে, আপনি সেখানে ইতিমধ্যে যে ডেটা সংগ্রহ করছেন তা আপনার অ্যাপে অতিরিক্ত কোড ছাড়াই Pushwoosh-এ পৌঁছায়:
- Track ইভেন্ট Pushwoosh ইভেন্ট হয়ে যায়। সেগমেন্ট তৈরি করতে এবং Customer Journey শুরু বা শাখায় ভাগ করতে এগুলো ব্যবহার করুন।
- Identify ট্রেইট ইউজার-স্পেসিফিক ট্যাগ হয়ে যায়। পুশ নোটিফিকেশন, ইন-অ্যাপ বার্তা এবং ইমেল টার্গেট ও পার্সোনালাইজ করতে এগুলো ব্যবহার করুন।
শুরু করার আগে
Anchor link todestination সমস্ত ডেটা User ID দিয়ে মেলায়, তাই প্রথমে এই পূর্বশর্তগুলো পরীক্ষা করুন:
- আপনার অ্যাপে Pushwoosh SDK ইন্টিগ্রেট করা আছে।
- আপনার অ্যাপ
setUserIdকল করে সেই একই মান দিয়ে যা RudderStackuserIdহিসেবে পাঠায়। Pushwoosh এই মান দিয়ে আগত ইভেন্ট এবং ট্রেইটগুলোকে ব্যবহারকারীদের সাথে যুক্ত করে। - RudderStack কোনো ব্যবহারকারীর জন্য
identifyকল পাঠানোর আগে প্রত্যেক ব্যবহারকারীর ডিভাইস এই User ID দিয়ে রেজিস্টার করা থাকে। যে User ID Pushwoosh এখনও জানে না, তার ট্রেইট বাদ দেওয়া হয়। - API টোকেন তৈরি করার জন্য Pushwoosh-এ Settings → API Access-এ আপনার অ্যাক্সেস আছে।
- আপনার একটি RudderStack workspace আছে যেখানে অন্তত একটি সোর্স
trackবাidentifyকল পাঠায়।
RudderStack-এ Pushwoosh destination সেট আপ করুন
Anchor link toসেটআপের দুটি অংশ: আপনি Pushwoosh-এ দুটি মান সংগ্রহ করেন, তারপর RudderStack-এ destination তৈরি করেন।
অ্যাপ্লিকেশন কোড এবং একটি Device API token নিন
Anchor link toআপনার অ্যাপ্লিকেশনে ডেটা পাঠাতে RudderStack-এর দুটি মান প্রয়োজন: অ্যাপ্লিকেশন কোড এবং একটি Device API token।
- Pushwoosh-এ, যে অ্যাপ্লিকেশনে ডেটা পাঠাতে চান সেটি খুলুন।
- অ্যাপ্লিকেশন কোড কপি করুন। এটি উপরের বাম কোণে অ্যাপ্লিকেশনের নামের নিচে দেখানো হয় এবং
XXXXX-XXXXX-এর মতো দেখায়। - Settings → API Access-এ যান এবং Generate New Token-এ ক্লিক করুন।
- Token type-এ,
deviceবেছে নিন। - Name-এ, টোকেনের জন্য একটি নাম লিখুন, উদাহরণস্বরূপ
RudderStack। - Generate-এ ক্লিক করুন।
- টোকেন তালিকায়, নতুন টোকেনের পাশে তিন-বিন্দু মেনুতে ক্লিক করুন এবং Edit token… বেছে নিন।
- Applications-এর অধীনে, ধাপ 1-এর অ্যাপ্লিকেশন নির্বাচন করুন এবং Save-এ ক্লিক করুন।
- টোকেন তালিকা থেকে টোকেনের মান কপি করুন।
destination-এর জন্য একটি Device API token যথেষ্ট। আপনার Server API token প্রয়োজন নেই।
RudderStack-এ destination যোগ করুন
Anchor link toPushwoosh destination আপনার RudderStack সোর্সগুলোকে আপনার Pushwoosh অ্যাপ্লিকেশনের সাথে সংযুক্ত করে।
- RudderStack ড্যাশবোর্ডে, Collect → Destinations-এ যান।
- New destination-এ ক্লিক করুন।
- তালিকা থেকে Pushwoosh নির্বাচন করুন।
- destination-এর জন্য একটি নাম লিখুন এবং Continue-তে ক্লিক করুন।
- যে সোর্সগুলো Pushwoosh-এ পাঠাতে চান সেগুলো নির্বাচন করুন।
- Application Code-এ, অ্যাপ্লিকেশন কোড পেস্ট করুন।
- API Token-এ, Device API token পেস্ট করুন।
- destination সংরক্ষণ করতে সেটআপ শেষ করুন।
destination সমর্থিত প্রতিটি সোর্স টাইপের জন্য RudderStack নিজস্ব সার্ভার থেকে Pushwoosh-এ ডেটা পাঠায় (cloud mode)।
সেটআপের RudderStack অংশের জন্য, RudderStack ডকুমেন্টেশনে Pushwoosh destination গাইড দেখুন।
RudderStack Pushwoosh-এ কোন ডেটা পাঠায়
Anchor link todestination দুটি কল টাইপ সমর্থন করে, track এবং identify। এই destination-এর জন্য RudderStack অন্য যেকোনো কল টাইপ, যেমন page, screen, group, বা alias, প্রত্যাখ্যান করে।
প্রতিটি কলে একটি userId থাকতে হবে। RudderStack এটি ছাড়া কল পাঠায় না, কারণ Pushwoosh কোনো বেনামী কলকে কোনো ব্যবহারকারীর সাথে যুক্ত করতে পারে না।
Track কল Pushwoosh ইভেন্ট হয়ে যায়
Anchor link toপ্রতিটি track কল RudderStack ইভেন্টের একই নামের একটি Pushwoosh ইভেন্ট হয়ে যায়:
| RudderStack ফিল্ড | Pushwoosh |
|---|---|
event | ইভেন্টের নাম |
properties | ইভেন্ট অ্যাট্রিবিউট |
userId | User ID |
timestamp (অথবা originalTimestamp) | ইভেন্টের সময় |
context.device.id | Device ID, যদি থাকে |
context.device.type অথবা context.os.name | প্ল্যাটফর্ম: android; iOS, iPadOS, watchOS এবং tvOS-এর জন্য ios; অন্য যেকোনো মান বা কোনো মান না থাকলে web |
ইভেন্ট বা কোনো অ্যাট্রিবিউট অ্যাপ্লিকেশনে এখনও না থাকলে, Pushwoosh স্বয়ংক্রিয়ভাবে সেটি তৈরি করে।
এই ক্ষেত্রগুলোতে Pushwoosh পুরো ইভেন্ট বাদ দেয়। এটি কোনো ত্রুটি ফেরত দেয় না, তাই RudderStack ইভেন্টটিকে ডেলিভার হয়েছে বলে রিপোর্ট করে:
- কলে 100-এর বেশি প্রপার্টি আছে।
- কোনো প্রপার্টির মান 10 KB-এর বেশি দীর্ঘ।
- ইভেন্টের নাম 255 অক্ষরের বেশি দীর্ঘ।
- ইভেন্টটি নতুন, এবং এর নাম 128 অক্ষরের বেশি দীর্ঘ বা এতে কন্ট্রোল ক্যারেক্টার আছে।
একটি ইভেন্ট সর্বোচ্চ 100টি অ্যাট্রিবিউট রাখে। কোনো ইভেন্টের 100টি পরিচিত অ্যাট্রিবিউট হয়ে গেলে, Pushwoosh নতুন কল রেকর্ড করতে থাকে, কিন্তু নতুন প্রপার্টির নাম অ্যাট্রিবিউট হিসেবে যোগ করা হয় না।
properties-এর নেস্টেড অবজেক্ট JSON স্ট্রিং হিসেবে আসে, এবং null মানের প্রপার্টি বাদ দেওয়া হয়।
Identify কল ইউজার-স্পেসিফিক ট্যাগ হয়ে যায়
Anchor link toপ্রতিটি identify কল তার ট্রেইটগুলোকে প্রদত্ত userId-এর ব্যবহারকারীর ট্যাগ হিসেবে সেট করে। ট্রেইট আসে traits থেকে, অথবা traits খালি থাকলে context.traits থেকে।
- শুধুমাত্র ইউজার-স্পেসিফিক ট্যাগ লেখা হয়। আপনার অ্যাকাউন্টে ট্যাগ অটো-ক্রিয়েশন চালু থাকলে, নতুন নামের একটি ট্রেইট একটি ইউজার-স্পেসিফিক ট্যাগ তৈরি করে। একই নামের একটি General ট্যাগ আগে থেকেই থাকলে, Pushwoosh কোনো ত্রুটি ছাড়াই সেই ট্রেইট বাদ দেয়।
- মান অবশ্যই ট্যাগের টাইপের সাথে মিলতে হবে। কোনো ট্যাগ আগে থেকেই থাকলে এবং ট্রেইটের মান তার টাইপের সাথে না মিললে, যেমন Integer ট্যাগের জন্য টেক্সট, Pushwoosh কোনো ত্রুটি ছাড়াই সেই ট্রেইট বাদ দেয়।
- ব্যবহারকারীকে আগে থেকেই Pushwoosh-এ থাকতে হবে। ট্যাগ শুধুমাত্র তখনই প্রয়োগ হয় যখন Pushwoosh SDK এমন একটি ডিভাইস রেজিস্টার করেছে যার
setUserIdএকইuserId-এ সেট করা। অজানা ব্যবহারকারীর ট্রেইট কোনো ত্রুটি ছাড়াই বাদ দেওয়া হয়। - পরিচয় এবং যোগাযোগ ট্রেইট ট্যাগে কপি হয় না।
email,phone,firstName,lastName,name,address,id,userIdএবংanonymousIdকখনও ট্যাগ হিসেবে পাঠানো হয় না। শুধুমাত্র এই ট্রেইটগুলো থাকা একটিidentifyকলNo traits left to send as Pushwoosh tagsদিয়ে ব্যর্থ হয়। - খালি মান ট্যাগ মুছে দেয়। খালি স্ট্রিং বা খালি তালিকা সহ একটি ট্রেইট সেই ট্যাগে ব্যবহারকারীর বর্তমান মান মুছে দেয়।
- নেস্টেড অবজেক্ট JSON স্ট্রিং হিসেবে আসে।
nullমানের ট্রেইট বাদ দেওয়া হয়।
destination যা করে না
Anchor link todestination শুধুমাত্র track এবং identify ডেটা পাঠায়। এই কাজগুলো এর বাইরে থাকে:
- এটি ডিভাইস বা ইমেল ঠিকানা রেজিস্টার করে না। ডিভাইস আসে Pushwoosh SDK থেকে।
- এটি ব্যবহারকারী মুছে দেয় না। এই destination-এর জন্য RudderStack-এর ব্যবহারকারী মোছার অনুরোধ সমর্থিত নয়।
ইন্টিগ্রেশন কাজ করছে কিনা পরীক্ষা করুন
Anchor link todestination সংরক্ষণ করার পরে, এমন একটি userId সহ সোর্স থেকে একটি টেস্ট track এবং identify কল পাঠান যার Pushwoosh-এ ইতিমধ্যে একটি ডিভাইস আছে।
- ইভেন্ট: Pushwoosh-এ, Audience → Events-এ যান, ইভেন্টটি খুলুন এবং এটি গণনা হয়েছে কিনা পরীক্ষা করুন।
- ট্যাগ: Audience → User Explorer-এ যান, User ID দিয়ে ব্যবহারকারী খুঁজুন এবং ট্যাগের মান পরীক্ষা করুন।
প্রতিটি কলের ডেলিভারি ত্রুটি RudderStack-এ destination-এর Live Events ভিউতে দেখানো হয়।
সমস্যা সমাধান
Anchor link toকারণ এবং সমাধান জানতে, Live Events-এ destination-এর জন্য RudderStack যে ত্রুটি বার্তা দেখায় তা খুঁজুন।
Track কল unauthorized দিয়ে ব্যর্থ হয়
Anchor link toAPI টোকেন অ্যাপ্লিকেশন কোডের সাথে মেলে না। টোকেনটি অ্যাপ্লিকেশনের মতো একই Pushwoosh অ্যাকাউন্টের কিনা পরীক্ষা করুন।
identify কল টোকেন পরীক্ষা করে না, তাই ভুল টোকেন দিয়েও সেগুলো সফল হতে থাকে। টোকেন পরীক্ষা করতে একটি track কল ব্যবহার করুন।
কল application not found বা application code is not valid দিয়ে ব্যর্থ হয়
Anchor link toঅ্যাপ্লিকেশন কোড ভুল, অথবা অ্যাকাউন্টটি app.pushwoosh.com-এ হোস্ট করা নেই। track কল application not found দিয়ে ব্যর্থ হয়, এবং identify কল application code is not valid দিয়ে ব্যর্থ হয়। Pushwoosh Control Panel-এ কোডটি পরীক্ষা করুন। কোড সঠিক হলে, আপনার Customer Success Manager বা সাপোর্টের সাথে যোগাযোগ করুন।
কল Missing required value from userId দিয়ে ব্যর্থ হয়
Anchor link toকলে কোনো userId নেই। বেনামী কল Pushwoosh-এ পাঠানো হয় না। ব্যবহারকারী সাইন ইন করার পরে আপনার RudderStack সোর্সে identify কল করুন, যাতে পরবর্তী কলগুলোতে userId থাকে।
কল Invalid enum value দিয়ে ব্যর্থ হয়
Anchor link toকল টাইপ track বা identify নয়। Pushwoosh শুধুমাত্র এই দুটি টাইপ গ্রহণ করে। হয় শুধুমাত্র page, screen, group, বা alias কল পাঠানো সোর্সগুলো সংযুক্ত করবেন না, অথবা এই ত্রুটিগুলো উপেক্ষা করুন।
Identify কল No traits left to send as Pushwoosh tags দিয়ে ব্যর্থ হয়
Anchor link toকলের সমস্ত ট্রেইট পরিচয় বা যোগাযোগ ট্রেইট, যেমন email বা phone, যেগুলো কখনও ট্যাগে কপি হয় না। অন্তত একটি অন্য ট্রেইট যোগ করুন অথবা কলটি বাদ দিন।
Identify কল সফল হয় কিন্তু ট্যাগ দেখা যায় না
Anchor link toএগুলো ক্রমানুসারে পরীক্ষা করুন:
- এই User ID সহ একটি ডিভাইস Pushwoosh-এ রেজিস্টার করা আছে। Audience → User Explorer-এ ব্যবহারকারী খুঁজুন।
- অ্যাপটি
setUserIdকল করে ঠিক সেই মান দিয়ে যা RudderStackuserIdহিসেবে পাঠায়। - এই নামের ট্যাগটি User-specific। বিদ্যমান General ট্যাগের জন্য একটি ট্রেইট বাদ দেওয়া হয়। ট্যাগের স্কোপ পরিবর্তন করুন বা ট্রেইটের নাম পরিবর্তন করুন।
- ট্রেইটের মান বিদ্যমান ট্যাগের টাইপের সাথে মেলে।
- ট্রেইটটি কখনও কপি না হওয়া পরিচয় বা যোগাযোগ ট্রেইটগুলোর একটি নয়, যেমন
emailবাphone।