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

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

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

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

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

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

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

পূর্বশর্ত

• সক্রিয় Pushwoosh অ্যাকাউন্ট
• সক্রিয় Singular অ্যাকাউন্ট
• আপনার অ্যাপে Singular SDK ইন্টিগ্রেটেড
• আপনার Pushwoosh অ্যাকাউন্ট থেকে অ্যাপ্লিকেশন কোড এবং API অ্যাক্সেস টোকেন

ন্যূনতম Singular SDK সংস্করণ

• অ্যান্ড্রয়েড: Singular Android SDK 12.11.0 বা নতুন (পুরানো সংস্করণগুলি পুশ পেলোড অ্যাট্রিবিউশন সমর্থন করে না)
• iOS: Singular iOS SDK 12.0.5 বা নতুন

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

• সোর্স (Pushwoosh → Singular): অ্যাট্রিবিউশন ডেটা ডিভাইসে পুশ পেলোড থেকে Singular ট্র্যাকিং লিঙ্কের মাধ্যমে Singular-এ পাস করা হয়।
• গন্তব্য (Singular → Pushwoosh): Singular পোস্টব্যাকের মাধ্যমে Pushwoosh-এ অ্যাট্রিবিউশন ডেটা পাঠায়। Pushwoosh এটি সেগমেন্টেশন এবং অ্যানালিটিক্সের জন্য ট্যাগ এবং ইভেন্ট হিসাবে সংরক্ষণ করে।

এটি কিভাবে কাজ করে

পুশ অ্যাট্রিবিউশন (Pushwoosh → Singular)

1. Pushwoosh একটি ডিপ লিঙ্ক হিসাবে Singular ট্র্যাকিং লিঙ্ক সহ একটি পুশ ডেলিভার করে।
2. ব্যবহারকারী নোটিফিকেশনে ট্যাপ করে।
3. অ্যাপটি লিঙ্কটি Singular SDK-তে পাস করে।
4. Singular আপনার পুশ ক্যাম্পেইনে অ্যাট্রিবিউটেড হিসাবে ওপেনটি রেকর্ড করে।

পোস্টব্যাক (Singular → Pushwoosh)

1. একজন ব্যবহারকারী অ্যাপটি ইনস্টল করে, একটি ট্র্যাক করা লিঙ্ক থেকে পুনরায় এনগেজ করে, বা একটি ইন-অ্যাপ ইভেন্ট ট্রিগার করে যা Singular অ্যাট্রিবিউট করে।
2. Singular অ্যাট্রিবিউশন ডেটা সহ Pushwoosh-এ একটি পোস্টব্যাক পাঠায়।
3. Pushwoosh ব্যবহারকারীর প্রোফাইলে ডেটা ট্যাগ এবং ইভেন্ট হিসাবে সংরক্ষণ করে।
4. আপনি Pushwoosh-এ সেগমেন্টেশন, অ্যানালিটিক্স এবং ক্যাম্পেইনের জন্য এই ডেটা ব্যবহার করেন।

আপনার অ্যাপ্লিকেশনের জন্য লিঙ্ক কনফিগার করুন

Singular-এ একটি পার্টনার লিঙ্ক তৈরি করে Pushwoosh এবং Singular ইন্টিগ্রেশন শুরু করুন। আপনি পোস্টব্যাক, পুশ অ্যাট্রিবিউশন বা উভয়ই ব্যবহার করুন না কেন, এই ধাপটি প্রয়োজন।

1. আপনার Singular অ্যাকাউন্টে, Attribution Setup → Manage Links-এ যান।

2. Link Type → Partner চয়ন করুন এবং Source Name হিসাবে Pushwoosh নির্বাচন করুন। একটি Tracking Link Name লিখুন যাতে আপনি Singular অ্যানালিটিক্সে এই লিঙ্কটি সনাক্ত করতে পারেন। এটি রিপোর্টে Tracker Name হিসাবে প্রদর্শিত হয়।

3. Link Settings and Redirects-এ, এই লিঙ্কটি কোন অ্যাপের জন্য এবং ব্যবহারকারীরা এটিতে ট্যাপ করলে কোথায় যাবে তা নির্ধারণ করুন। আরও জানুন।

4. Attribution Settings-এ, লিঙ্কের জন্য অ্যাট্রিবিউশন পদ্ধতি এবং উইন্ডো কনফিগার করুন। আরও জানুন।

5. Generate-এ ক্লিক করুন।

6. Link Summary-তে, জেনারেট করা লিঙ্কগুলি পর্যালোচনা করুন। আপনি যদি পুশ অ্যাট্রিবিউশন সেট আপ করছেন, তাহলে Click-through tracking link কপি করুন। আপনি এটি Pushwoosh-এ ব্যবহার করবেন।

Pushwoosh-এ পুশ অ্যাট্রিবিউশন সেট আপ করুন

আপনার পুশ নোটিফিকেশনে Singular ট্র্যাকিং লিঙ্ক যোগ করুন।

আপনার Link Summary থেকে Click-through tracking link টি একটি পুশ প্রিসেটে On-click actions → Deep link in application-এ পেস্ট করুন।

পোস্টব্যাক কনফিগার করুন

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

উদাহরণস্বরূপ, যদি Singular রেকর্ড করে যে একজন ব্যবহারকারী একটি নির্দিষ্ট বিজ্ঞাপন ক্যাম্পেইন থেকে অ্যাপটি ইনস্টল করেছে, Pushwoosh এটি একটি ট্যাগ বা ইভেন্ট হিসাবে পেতে পারে। তারপরে আপনি সেই ক্যাম্পেইন থেকে ব্যবহারকারীদের একটি সেগমেন্ট তৈরি করতে পারেন এবং তাদের Pushwoosh-এ একটি টার্গেটেড পুশ পাঠাতে পারেন।

1. Singular-এ, Partner Configuration-এ যান।
2. একটি নতুন কনফিগারেশন তৈরি করুন বা একটি বিদ্যমান সম্পাদনা করুন।

3. আপনার Pushwoosh Application Code এবং API Access Token লিখুন।

আপনার ক্রেডেনশিয়াল কোথায় পাবেন

• Application Code (XXXXX-XXXXX): Pushwoosh কন্ট্রোল প্যানেলে আপনার অ্যাপ্লিকেশন নামের নীচে দেখানো হয়েছে।
• API Access Token: Settings → API Access-এ যান এবং টোকেনটি কপি করুন। বিস্তারিত জানতে API Access Token দেখুন।

4. Attribution Postbacks-এ, Singular কোন ইভেন্টগুলি Pushwoosh-এ পাঠাবে তা নির্বাচন করুন:

• Install: Singular-এ অ্যাট্রিবিউটেড নতুন অ্যাপ ইনস্টল। Pushwoosh এই ডেটা ব্যবহার করে ব্যবহারকারীরা কোথা থেকে এসেছে তা রেকর্ড করতে।

• Re-engagement: একটি ট্র্যাক করা লিঙ্কে অ্যাট্রিবিউটেড অ্যাপ ওপেন। আপনি যদি সেগমেন্টেশনের জন্য Pushwoosh-এ রি-এনগেজমেন্ট সোর্স ডেটা চান তবে এটি সক্ষম করুন।

  Singular হেল্প সেন্টারে কিভাবে পার্টনার সেটিংস এবং পোস্টব্যাক কনফিগার করবেন তা জানুন।

5. Attribution Windows Settings-এ, Installs-এর অধীনে, একজন ব্যবহারকারী আপনার ট্র্যাকিং লিঙ্কে ক্লিক করার বা একটি বিজ্ঞাপন দেখার পরে Singular কতক্ষণ অপেক্ষা করতে পারে তা চয়ন করুন, এর আগে এটি Pushwoosh-এ ইনস্টল ক্রেডিট করা বন্ধ করে দেবে। আরও জানুন।

6. Re-engagements-এর অধীনে, একটি ক্লিক বা বিজ্ঞাপন দেখার পরে Singular কতক্ষণ অপেক্ষা করতে পারে তা চয়ন করুন, এর আগে এটি Pushwoosh-এ ওপেন ক্রেডিট করা বন্ধ করে দেবে। ব্যবহারকারীকে কতক্ষণ নিষ্ক্রিয় থাকতে হবে তা সেট করতে Override app level inactivity window for this partner সক্ষম করুন, এর আগে সেই ওপেনটি একটি রি-এনগেজমেন্ট হিসাবে গণ্য হবে। আরও জানুন।

7. In app Events Postback ট্যাবটি খুলুন এবং Pushwoosh-এর যে ইভেন্টগুলি গ্রহণ করা উচিত তা যোগ করুন (উদাহরণস্বরূপ সেশনের জন্য __SESSION__*)। যেকোনো সোর্স থেকে ব্যবহারকারীদের অন্তর্ভুক্ত করতে Send All সক্ষম করুন।

8. কনফিগারেশনটি সেভ করুন।

Pushwoosh কী গ্রহণ করে

আপনি সেভ করার পরে, কনফিগার করা ইভেন্টগুলি ঘটলে Singular পোস্টব্যাক পাঠায়। Pushwoosh প্রতিটি পোস্টব্যাককে ডিভাইসের ট্যাগ এবং ব্যবহারকারীর প্রোফাইলে একটি ইভেন্ট-এ প্রসেস করে।

ট্যাগ

Pushwoosh ম্যাচ করা ডিভাইসে এই ট্যাগগুলি লেখে বা আপডেট করে:

ট্যাগ	সোর্স
OS Version	ডিভাইস OS সংস্করণ
Application Version	অ্যাপ সংস্করণ
Device Model	ডিভাইস মডেল
Country	অ্যাট্রিবিউশন দেশ
City	অ্যাট্রিবিউশন শহর

ইভেন্ট

Pushwoosh ব্যবহারকারীর প্রোফাইলে একটি ইভেন্ট রেকর্ড করে। ইভেন্টের নাম পোস্টব্যাকের ধরণের উপর নির্ভর করে:

• ইন-অ্যাপ ইভেন্ট: আপনি যে Singular ইভেন্টের নাম কনফিগার করেছেন (উদাহরণস্বরূপ, একটি সেশন ইভেন্ট)।
• ইনস্টল বা অ্যাট্রিবিউশন পোস্টব্যাক: যদি পোস্টব্যাকে কোনো ইভেন্টের নাম না থাকে, Pushwoosh Singular Attribution Event রেকর্ড করে। আপনি যখন নতুন অ্যাট্রিবিউটেড ব্যবহারকারীদের সেগমেন্ট তৈরি করেন তখন এই ইভেন্টের নামটি ব্যবহার করুন।

ক্যাম্পেইন এবং রাজস্ব ডেটা ইভেন্টের সাথে ইভেন্ট অ্যাট্রিবিউট হিসাবে ভ্রমণ করে। আপনি Pushwoosh-এ সেগুলিকে সেগমেন্ট এবং ফিল্টার করতে পারেন:

অ্যাট্রিবিউট	বিবরণ
Campaign name / Campaign ID	অ্যাট্রিবিউটেড ক্যাম্পেইন
Subcampaign name / Subcampaign ID	অ্যাট্রিবিউটেড সাব-ক্যাম্পেইন
Creative name / Creative ID	অ্যাট্রিবিউটেড ক্রিয়েটিভ
Amount / Revenue / Currency	ইভেন্টের আর্থিক মূল্য, যদি থাকে
Country / City	ইভেন্টের সাথে রিপোর্ট করা অবস্থান

ডিভাইস ম্যাচিং

Pushwoosh প্রতিটি পোস্টব্যাককে Singular দ্বারা পাঠানো আইডেন্টিফায়ার ব্যবহার করে একটি ডিভাইসের সাথে ম্যাচ করে: iOS-এ IDFV, অথবা Android-এ GAID, AIFA, বা Android ID। পোস্টব্যাকে আপনার অ্যাপ্লিকেশন কোড এবং প্ল্যাটফর্মও অন্তর্ভুক্ত থাকতে হবে। যদি Pushwoosh ডিভাইসটি ম্যাচ করতে না পারে, তাহলে পোস্টব্যাকটি প্রয়োগ করা হয় না।

পোস্টব্যাক যাচাই করুন

Singular একটি কনফিগার করা ইভেন্টের জন্য একটি পোস্টব্যাক পাঠানোর পরে, Pushwoosh এটি পেয়েছে কিনা তা পরীক্ষা করুন:

1. Audience → Events খুলুন এবং ইভেন্টটি প্রদর্শিত হয়েছে কিনা তা নিশ্চিত করুন।
2. User Explorer-এ ব্যবহারকারীর প্রোফাইল খুলুন এবং Events history-এ যান। ইভেন্ট এবং এর অ্যাট্রিবিউটগুলি (উদাহরণস্বরূপ, Campaign name) সেই ব্যবহারকারীর জন্য রেকর্ড করা হয়েছে কিনা তা নিশ্চিত করুন।
3. ইভেন্টগুলি সাধারণত কয়েক মিনিটের মধ্যে প্রদর্শিত হয়।

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

Singular ট্র্যাকিং লিঙ্ক ক্যাপচার করা হচ্ছে না

• যাচাই করুন যে Click-through tracking link টি On-click actions → Deep link in application-এ সেট করা আছে, Custom Data-তে নয়।
• নিশ্চিত করুন যে Singular SDK পুশ নোটিফিকেশন পেলোডগুলি পরিচালনা করার জন্য কনফিগার করা আছে। Android এবং iOS গাইডগুলি দেখুন।

ডিপ লিঙ্ক অ্যাপটি খোলে কিন্তু হোম স্ক্রিনে নেভিগেট করে

• নিশ্চিত করুন যে Singular ট্র্যাকিং লিঙ্কের ভিতরের _dl প্যারামিটারটি সঠিকভাবে URL-এনকোড করা আছে।
• যাচাই করুন যে আপনার অ্যাপের ডিপ লিঙ্ক হ্যান্ডলারটি ব্যবহৃত স্কিমের জন্য সঠিকভাবে নিবন্ধিত আছে (উদাহরণস্বরূপ, myapp://)।
• Android-এ, AndroidManifest.xml-এ আপনার ডিপ লিঙ্ক স্কিমের জন্য সঠিক Activity-তে ইন্টেন্ট ফিল্টার আছে কিনা তা পরীক্ষা করুন।

অ্যাট্রিবিউশন Singular-এ প্রদর্শিত হয় কিন্তু ভুল ক্যাম্পেইন ক্রেডিট করা হয়

• নিশ্চিত করুন যে Singular SDK ইনিশিয়ালাইজেশনের আগে বা সময় পুশ পেলোড প্রসেস করে, যেমন Singular SDK গাইডগুলিতে বর্ণিত আছে।
• নিশ্চিত করুন যে আপনি এই ক্যাম্পেইনের জন্য Link Summary থেকে সঠিক Click-through tracking link ব্যবহার করছেন।

ওয়ার্ম স্টার্ট (অ্যাপটি ইতিমধ্যে খোলা): অ্যাট্রিবিউশন রেকর্ড করা হয়নি

• নিশ্চিত করুন যে আপনার অ্যাপটি যখন ইতিমধ্যে ব্যাকগ্রাউন্ডে চলছে তখন পুশ নোটিফিকেশন ট্যাপগুলি পরিচালনা করে, যেমন Singular SDK গাইডগুলিতে বর্ণিত আছে।
• এটি ওয়ার্ম স্টার্টের জন্য অনুপস্থিত অ্যাট্রিবিউশনের সবচেয়ে সাধারণ কারণ।