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

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

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

Amplitude, একটি শক্তিশালী প্রোডাক্ট অ্যানালিটিক্স প্ল্যাটফর্ম, যা ব্যবসাগুলোকে রিয়েল-টাইমে ব্যবহারকারীর আচরণ বুঝতে, ইন-প্রোডাক্ট ইন্টারঅ্যাকশন ট্র্যাক করতে এবং ব্যবহারকারীর এনগেজমেন্ট, রিটেনশন এবং রাজস্ব সম্পর্কে মূল্যবান অন্তর্দৃষ্টি পেতে সাহায্য করে।

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

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

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

গন্তব্য: ডেটা Amplitude থেকে Pushwoosh-এ পাঠানো হয়।

পূর্বশর্ত

Amplitude থেকে Pushwoosh-এ ইভেন্ট স্ট্রিমিং এবং কোহর্ট সিঙ্ক ইন্টিগ্রেশন সেট আপ করার জন্য, নিম্নলিখিত পূর্বশর্তগুলো পূরণ করা হয়েছে কিনা তা নিশ্চিত করুন:

• আপনার একটি সক্রিয় Pushwoosh অ্যাকাউন্ট প্রয়োজন।
• ডেটা পাঠানোর জন্য Pushwoosh-এ একটি API অ্যাক্সেস টোকেন জেনারেট করুন।
• ইন্টিগ্রেশন কনফিগার করার আগে আপনার Pushwoosh অ্যাপ কোডটি খুঁজে বের করুন।
• এই ইন্টিগ্রেশনটি শুধুমাত্র পেইড প্ল্যানসহ Amplitude গ্রাহকদের জন্য উপলব্ধ।
• এই ইন্টিগ্রেশনটি ব্যবহার করার জন্য আপনার একটি পেইড Pushwoosh প্ল্যান থাকতে হবে।

গ্লসারি (যদি এন্টিটির নাম ভিন্ন হয় তবে ম্যাপিং)

Amplitude-এর Cohorts = Pushwoosh-এর Segments

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

• ইভেন্টস
• ট্যাগস
• সেগমেন্টস

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

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

ডেটা ট্রান্সমিশন

• ইভেন্টস: Amplitude ইভেন্ট ডেটা Pushwoosh-এ পাঠায়। প্রতিটি ইভেন্টে একটি ইউজার আইডি (external_id), একটি অ্যাপ্লিকেশন কোড (app_id), একটি টাইমস্ট্যাম্প (created_at), এবং অতিরিক্ত অ্যাট্রিবিউট (attributes) থাকে।

• ট্যাগস: Pushwoosh ব্যবহারকারী প্রোফাইলের সাথে যুক্ত ট্যাগ গ্রহণ করে। এই ট্যাগগুলো একটি ইউজার আইডি (external_id), একটি অ্যাপ্লিকেশন কোড (app_id), এবং ট্যাগ প্রপার্টি (properties) সহ পাঠানো হয়।

• সেগমেন্টস: সেগমেন্টগুলো Pushwoosh যেভাবে CSV ইম্পোর্ট পরিচালনা করে সেভাবেই ইম্পোর্ট করা হয়। ব্যবহারকারীদের অনুরোধের মাধ্যমে সেগমেন্টে যোগ করা বা সরানো হয়।

ডেটা ফ্লো

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

• সেগমেন্টস: Amplitude যখন একটি অনুরোধ করে তখন Pushwoosh-এ সেগমেন্ট তৈরি হয়। Pushwoosh প্রতিটি সেগমেন্টের জন্য একটি ইউনিক আইডেন্টিফায়ার তৈরি করে, যা Amplitude ব্যবহারকারীদের যোগ বা অপসারণ করে সেগমেন্টটি ম্যানিপুলেট করতে ব্যবহার করে।

অনুরোধ

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

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

ইভেন্ট ট্র্যাকিং

Amplitude থেকে ব্যবহারকারীর কার্যকলাপ এবং ইন্টারঅ্যাকশন ট্র্যাক করুন এবং এই ইভেন্টগুলো Pushwoosh-এ পাঠান নোটিফিকেশন বা আপডেট ট্রিগার করার জন্য।

ইউজার ট্যাগিং

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

সেগমেন্ট ম্যানেজমেন্ট

Amplitude-এ কনফিগার করা ডেটা এবং সেগমেন্টের উপর ভিত্তি করে Pushwoosh-এ ব্যবহারকারী সেগমেন্ট তৈরি এবং পরিচালনা করুন। এটি ব্যক্তিগতকৃত বার্তা দিয়ে নির্দিষ্ট ব্যবহারকারী গ্রুপকে টার্গেট করতে সাহায্য করে।

স্বয়ংক্রিয় ইউজার ম্যানেজমেন্ট

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

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

কোহর্ট সিঙ্ক

Pushwoosh সেটআপ

1. Pushwoosh-এ, Settings > Integrations-এ নেভিগেট করুন।

2. Add Integration-এ ক্লিক করুন, তারপর Amplitude খুঁজে বের করে যোগ করুন।

   

3. Pushwoosh API Key এবং App Code আপনার ক্লিপবোর্ডে কপি করুন।

Amplitude সেটআপ

ইন্টিগ্রেশনের জন্য Amplitude কনফিগার করতে, এই ধাপগুলো অনুসরণ করুন:

1. আপনার Amplitude Data-তে, Catalog-এ যান এবং Destinations নির্বাচন করুন।
2. Cohort সেকশনের অধীনে, Pushwoosh খুঁজে বের করে ক্লিক করুন।

3. Add another destination-এ ক্লিক করুন।

4. একটি নাম দিন এবং Pushwoosh থেকে কপি করা API কী পেস্ট করুন।

5. Amplitude ইউজার আইডি ফিল্ডটি Pushwoosh ইউজার আইডি ফিল্ডের সাথে ম্যাপ করুন।
6. আপনার কাজ শেষ হলে সেটিংস সেভ করুন।

একটি কোহর্ট পাঠানো

আপনার প্রথম কোহর্ট সিঙ্ক্রোনাইজ করতে, নিম্নলিখিত ধাপগুলো সম্পন্ন করুন:

1. Amplitude-এ, যে কোহর্টটি আপনি সিঙ্ক্রোনাইজ করতে চান সেটি খুলুন, তারপর Sync-এ ক্লিক করুন।

2. Pushwoosh নির্বাচন করুন এবং যে অ্যাকাউন্টের সাথে সিঙ্ক্রোনাইজ করতে চান সেটি নির্বাচন করুন। তারপর, Next-এ ক্লিক করুন।

3. সিঙ্ক্রোনাইজেশন ক্যাডেন্স নির্ধারণ করুন এবং আপনার কনফিগারেশন সেভ করুন।

ইভেন্ট স্ট্রিমিং

Pushwoosh সেটআপ

1. আপনার Pushwoosh API কী সংগ্রহ করুন।

2. আপনার Pushwoosh অ্যাকাউন্টে অ্যাপ কোডটি খুঁজে বের করুন।

Amplitude সেটআপ

1. Amplitude-এ, Data Destinations-এ যান এবং Pushwoosh - Event Stream খুঁজে বের করুন।

2. একটি সিঙ্কের নাম লিখুন এবং তারপর Create Sync-এ ক্লিক করুন।

3. স্ট্যাটাস Disabled থেকে Enabled-এ পরিবর্তন করুন এবং আপনার Pushwoosh API অ্যাক্সেস টোকেন এবং অ্যাপ কোড পেস্ট করুন।

4. বাম ড্রপডাউন থেকে, আপনার Pushwoosh UserID-এর সাথে সঙ্গতিপূর্ণ Amplitude ইউজার প্রপার্টি নির্বাচন করুন।
5. (ঐচ্ছিক) Create & Update users টগলটি সক্রিয় করুন যদি আপনি রিয়েল-টাইমে ব্যবহারকারী এবং তাদের প্রপার্টি পাঠাতে চান যখনই Amplitude একটি ইউজার প্রপার্টি তৈরি বা আপডেট করে।

6. Send Events (“Events are sent to Pushwoosh”) সক্রিয় করুন যদি আপনি Pushwoosh-এ ইভেন্ট স্ট্রিম করতে চান। এটি স্বয়ংক্রিয়ভাবে Amplitude-এ ইভেন্টগুলো ইনজেস্ট হওয়ার সাথে সাথে Pushwoosh-এ ফরোয়ার্ড করবে। এই ইন্টিগ্রেশন ব্যবহার করে ইভেন্টগুলো একটি সময়সূচী বা চাহিদা অনুযায়ী পাঠানো হয় না।

8. তারপর, Select and Filter Events বিভাগে আপনি কোন ইভেন্টগুলো পাঠাতে চান তা নির্বাচন করুন। শুধুমাত্র Pushwoosh-এ আপনার প্রয়োজনীয় ইভেন্টগুলো নির্বাচন করুন; রূপান্তরিত ইভেন্ট সমর্থিত নয়।
9. একবার হয়ে গেলে, গন্তব্যস্থলটি সক্রিয় করুন এবং Save-এ ক্লিক করুন।

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

Amplitude এবং Pushwoosh ইন্টিগ্রেশন সঠিকভাবে কাজ করছে কিনা তা যাচাই করতে, আপনি নিম্নলিখিত পদ্ধতিগুলো ব্যবহার করতে পারেন:

Pushwoosh ড্যাশবোর্ড মনিটর করুন

• ইভেন্টস এবং ট্যাগস: Amplitude থেকে পাঠানো ইভেন্ট এবং ট্যাগগুলো প্রত্যাশিতভাবে দেখা যাচ্ছে কিনা তা দেখতে Pushwoosh ড্যাশবোর্ড চেক করুন। আপনার ইভেন্ট এবং ট্যাগ সম্পর্কিত সাম্প্রতিক কার্যকলাপ বা আপডেটগুলো সন্ধান করুন।
• সেগমেন্টস: Amplitude থেকে আসা ডেটার উপর ভিত্তি করে সেগমেন্ট তৈরি, আপডেট বা পরিবর্তিত হচ্ছে কিনা তা যাচাই করুন। নিশ্চিত করুন যে ব্যবহারকারীর সংখ্যা এবং সেগমেন্ট সদস্যতা প্রত্যাশিত পরিবর্তনগুলো প্রতিফলিত করছে।

API রেসপন্স চেক করুন

• সফল রেসপন্স: নিশ্চিত করুন যে আপনি Pushwoosh API এন্ডপয়েন্ট থেকে 200 OK রেসপন্স পাচ্ছেন। যদিও সবসময় একটি রেসপন্স বডি নাও থাকতে পারে, 200 OK স্ট্যাটাস নির্দেশ করে যে অনুরোধটি সফলভাবে গৃহীত হয়েছে।
• ত্রুটিপূর্ণ রেসপন্স: যদি কিছু কাজ না করে তবে ক্লু পেতে 200 OK ছাড়া অন্য কোনো ত্রুটিপূর্ণ রেসপন্স বা স্ট্যাটাস কোড পর্যালোচনা করুন। সাধারণ ত্রুটিগুলোর মধ্যে 400 Bad Request, 401 Unauthorized, বা 500 Internal Server Error অন্তর্ভুক্ত থাকতে পারে।

রিকোয়েস্ট এবং রেসপন্স লগ করুন

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

নমুনা ডেটা দিয়ে পরীক্ষা করুন

• টেস্ট ইভেন্ট/ট্যাগ পাঠান: Amplitude থেকে Pushwoosh-এ টেস্ট ইভেন্ট এবং ট্যাগ তৈরি করে পাঠান। এই টেস্ট এন্ট্রিগুলো Pushwoosh-এ সঠিকভাবে প্রদর্শিত হচ্ছে এবং প্রত্যাশিত আচরণ ট্রিগার করছে কিনা তা যাচাই করুন।
• ব্যবহারকারীর কার্যকলাপ সিমুলেট করুন: Amplitude-এ এমন কার্যকলাপ সম্পাদন করুন যা Pushwoosh-এ নির্দিষ্ট ইভেন্ট বা আপডেট ট্রিগার করবে। এই কার্যকলাপগুলো Pushwoosh-এ প্রত্যাশিত পরিবর্তন আনছে কিনা তা পরীক্ষা করুন।

মনিটরিং টুল ব্যবহার করুন

• ইন্টিগ্রেশন মনিটরিং: মনিটরিং টুল বা পরিষেবা ব্যবহার করুন যা ইন্টিগ্রেশনের স্বাস্থ্য এবং কর্মক্ষমতা ট্র্যাক করতে পারে। এই টুলগুলো আপনাকে রিয়েল-টাইমে সমস্যা বা ব্যর্থতা সম্পর্কে সতর্ক করতে পারে।
• অ্যানালিটিক্স এবং রিপোর্টিং: ডেটা ফ্লো এবং ইন্টিগ্রেশন পারফরম্যান্স পর্যালোচনা করতে Amplitude এবং Pushwoosh উভয়ের অ্যানালিটিক্স বৈশিষ্ট্য ব্যবহার করুন।

ইন্টিগ্রেশন ডকুমেন্টেশন পর্যালোচনা করুন

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

সাপোর্টের সাথে যোগাযোগ করুন

যদি আপনি ক্রমাগত সমস্যা বা অসঙ্গতির সম্মুখীন হন, তাহলে সহায়তার জন্য Amplitude বা Pushwoosh-এর সাপোর্ট টিমের সাথে যোগাযোগ করুন। দ্রুত সমাধানের জন্য তাদের ইন্টিগ্রেশন সেটআপের বিবরণ এবং যেকোনো ত্রুটি লগ সরবরাহ করুন।

ট্রাবলশুটিং

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

• Pushwoosh-এ ইভেন্ট দেখা যাচ্ছে না: নিশ্চিত করুন যে ইভেন্টটি সঠিকভাবে ম্যাপ করা হয়েছে, এবং Pushwoosh অ্যাপ্লিকেশন কোড এবং API টোকেন সঠিকভাবে কনফিগার করা হয়েছে কিনা তা যাচাই করুন।

• ট্যাগ সিঙ্ক হচ্ছে না: নিশ্চিত করুন যে ট্যাগগুলো সঠিকভাবে ফরম্যাট করা হয়েছে এবং অনুরোধে সমস্ত প্রয়োজনীয় প্রমাণীকরণের বিবরণ অন্তর্ভুক্ত রয়েছে।

সেগমেন্ট সমস্যা

• সেগমেন্ট তৈরি হচ্ছে না: সেগমেন্ট তৈরির অনুরোধটি সঠিকভাবে ফরম্যাট করা হয়েছে এবং Pushwoosh API টোকেনটি বৈধ কিনা তা পরীক্ষা করুন।

• ব্যবহারকারী যোগ/অপসারণ করা হচ্ছে না: ব্যবহারকারী আইডিগুলো সঠিকভাবে নির্দিষ্ট করা হয়েছে এবং সেগমেন্ট আইডিটি বৈধ কিনা তা যাচাই করুন। অনুরোধের পেলোড সঠিকভাবে ফরম্যাট করা হয়েছে কিনা তা নিশ্চিত করুন।

রেসপন্স সমস্যা

• কোনো রেসপন্স বডি নেই: যদি আপনি একটি 200 OK রেসপন্স পান কিন্তু কোনো রেসপন্স বডি না পান, তাহলে অনুরোধটি সঠিকভাবে ফরম্যাট করা হয়েছিল এবং ডেটা সঠিকভাবে পাঠানো হয়েছিল কিনা তা যাচাই করুন।

সাধারণ জিজ্ঞাসা

যদি আমি একটি 400 Bad Request ত্রুটি পাই তাহলে আমার কী করা উচিত?

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

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

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

আমি কি Pushwoosh-এ পাঠানো ইভেন্ট বা ট্যাগগুলো কাস্টমাইজ করতে পারি?

হ্যাঁ, আপনি Amplitude কনফিগারেশনের মধ্যে ইভেন্ট এবং ট্যাগ কাস্টমাইজ করতে পারেন। নিশ্চিত করুন যে ডেটা প্রত্যাশিত Pushwoosh ফরম্যাট মেনে চলে।

Amplitude এবং Pushwoosh-এর মধ্যে ডেটা কত ঘন ঘন সিঙ্ক হয়?

Amplitude থেকে করা অনুরোধের উপর ভিত্তি করে ডেটা রিয়েল-টাইম বা প্রায়-রিয়েল-টাইমে সিঙ্ক হয়। আপনার কনফিগারেশনটি কাঙ্ক্ষিত আপডেট ফ্রিকোয়েন্সি সমর্থন করে কিনা তা নিশ্চিত করুন।

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

Amplitude এবং Pushwoosh-এর অফিসিয়াল ডকুমেন্টেশন দেখুন। আরও সহায়তার জন্য, নিজ নিজ সাপোর্ট টিমের সাথে যোগাযোগ করুন।