পয়েন্ট রেফারেন্স

প্রতিটি পয়েন্ট একটি point_data অবজেক্ট বহন করে যার মধ্যে ঠিক একটি নেস্টেড কী থাকে, যা পয়েন্টের point_type-এর সাথে মেলে (দেখুন পয়েন্ট-টাইপ → কী ম্যাপিং)। এই পৃষ্ঠাটি প্রতিটি কী-এর অধীনে স্ট্রাকচার নথিভুক্ত করে।

নোট

এন্ট্রি, টাইমিং, স্প্লিটিং, অ্যাকশন এবং কনভার্সন পয়েন্টগুলি নীচে সম্পূর্ণভাবে নথিভুক্ত করা হয়েছে।

মেসেজিং পয়েন্টগুলির জন্য (send_*, inapp), এই পৃষ্ঠাটি শুধুমাত্র স্ট্রাকচারাল ক্ষেত্রগুলি কভার করে: কোন প্রিসেট বা বিষয়বস্তু রেফারেন্স করতে হবে এবং কোন চ্যানেল সেটিংস পাস করতে হবে। মেসেজের বিষয়বস্তু নিজেই প্রিসেটে সংজ্ঞায়িত করা হয়েছে এবং প্রিসেট এপিআই এবং প্রতি-চ্যানেল ডক্সে নথিভুক্ত করা হয়েছে। কিছু ক্ষেত্র নেস্টেড অবজেক্টগুলিকে রেফারেন্স করে যা কাস্টমার জার্নি বিল্ডারের নিয়ন্ত্রণগুলিকে প্রতিফলিত করে।

এন্ট্রি পয়েন্ট

একটি জার্নির জন্য কমপক্ষে একটি এন্ট্রি পয়েন্ট প্রয়োজন। সমস্ত এন্ট্রি পয়েন্টের একটি একক default আউটপুট থাকে।

start_by_segment

যে ব্যবহারকারীরা একটি সেগমেন্টের সাথে মেলে তাদের প্রবেশ করায়। POINT_TYPE_START_BY_SEGMENT।

ক্ষেত্র	টাইপ	বর্ণনা
application_code	string	অ্যাপ্লিকেশন কোড।
filter_code	string	সেগমেন্ট/ফিল্টার কোড যা অডিয়েন্সকে সংজ্ঞায়িত করে।
repeat	SegmentRepeat	ঐচ্ছিক পুনরাবৃত্ত-এন্ট্রি সময়সূচী (দেখুন SegmentRepeat)।
start_at	timestamp	এই সময়ের আগে প্রক্রিয়া করবেন না (ISO 8601)।
is_deactivated	bool	এই এন্ট্রি পয়েন্টটি বন্ধ আছে কিনা।

message_bus (ইভেন্ট এন্ট্রি)

ব্যবহারকারীরা যখন একটি ইভেন্ট ট্রিগার করে তখন প্রবেশ করে। POINT_TYPE_EVENT।

ক্ষেত্র	টাইপ	বর্ণনা
event_name	string	শোনার জন্য ইভেন্টের নাম।
application_code	string	অ্যাপ্লিকেশন কোড।
event_conditions	PointEventCondition[]	ইভেন্টের অ্যাট্রিবিউটের সাথে মেলানো শর্তাবলী।
active_period	Period	সময় উইন্ডো যার সময় ট্রিগার সক্রিয় থাকে।
multi_entry	MultiEntry	একজন ব্যবহারকারী কীভাবে একাধিকবার প্রবেশ করতে পারে (দেখুন MultiEntry)।
attribute_entry	AttributeEntry	ইভেন্ট ট্রিগার করা ব্যবহারকারীর পরিবর্তে একটি ইভেন্ট অ্যাট্রিবিউটে থাকা ব্যবহারকারী আইডি নথিভুক্ত করুন (দেখুন AttributeEntry)।
allow_reenter	bool	ব্যবহারকারীরা জার্নিতে পুনরায় প্রবেশ করতে পারবে কিনা।

AttributeEntry

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

ক্ষেত্র	টাইপ	বর্ণনা
enabled	bool	ইভেন্ট ট্রিগার করা ব্যবহারকারীর পরিবর্তে একটি ইভেন্ট অ্যাট্রিবিউটে নামযুক্ত ব্যবহারকারীদের নথিভুক্ত করতে হবে কিনা।
attribute_name	string	ইভেন্ট অ্যাট্রিবিউটের নাম যা নথিভুক্ত করার জন্য ব্যবহারকারী আইডি (বা ব্যবহারকারী আইডিগুলির তালিকা) ধারণ করে।

start_by_api

Start by API কল দ্বারা চালিত এন্ট্রি পয়েন্ট। POINT_TYPE_START_BY_API।

ক্ষেত্র	টাইপ	বর্ণনা
application_code	string	অ্যাপ্লিকেশন কোড।
attributes	string[]	কাস্টম অ্যাট্রিবিউটগুলির নাম যা একটি Start by API অনুরোধের attribute_values-এ পাস করা যেতে পারে।
is_deactivated	bool	এই এন্ট্রি পয়েন্টটি বন্ধ আছে কিনা।

টাইমিং পয়েন্ট

delay (wait)

প্রতিটি ব্যবহারকারীকে একটি নির্দিষ্ট বা গণনাকৃত ব্যবধানের জন্য বিরতি দেয়। POINT_TYPE_WAIT। point_data.delay অবজেক্টটি নিম্নলিখিত ব্যবধান কীগুলির মধ্যে ঠিক একটি সেট করে:

ব্যবধান কী	টাইপ	বর্ণনা
sec	uint64	একটি নির্দিষ্ট সংখ্যক সেকেন্ড অপেক্ষা করুন।
exact_time	ExactTime	দিনের একটি সময় পর্যন্ত অপেক্ষা করুন (hour, minute)।
exact_date_time	ExactDateTime	একটি নির্দিষ্ট তারিখ এবং সময় পর্যন্ত অপেক্ষা করুন।
exact_week_days_time	ExactWeekDaysTime	নির্দিষ্ট সপ্তাহের দিনে নির্দিষ্ট সময় পর্যন্ত অপেক্ষা করুন (দিন 0=সোমবার … 6=রবিবার → ExactTime-এর ম্যাপ)।
dynamic_time	DynamicTime	একটি ট্যাগ বা ইভেন্টের মান সাপেক্ষে অপেক্ষা করুন।

একটি dynamic_time যার split_branches: true আছে, একটি output1 শাখা যোগ করে (দেখুন আউটপুট কী)।

DynamicTime

ক্ষেত্র	টাইপ	বর্ণনা
from	enum DynamicTimeFrom	বেস টাইম একটি ট্যাগ বা একটি ইভেন্ট থেকে আসে কিনা।
direction	enum DynamicTimeDirection	বেস টাইমের আগে বা পরে অফসেট।
duration	uint64	অফসেটের আকার।
unit	enum DynamicTimeUnit	duration-এর একক (মিনিট, ঘন্টা, দিন, …)।
split_branches	bool	যখন তাদের গণনাকৃত সময় ভিন্ন হয় তখন ব্যবহারকারীদের পৃথক শাখায় বিভক্ত করুন।
tag_name	string	বেস টাইম ধারণকারী ট্যাগ (যখন from একটি ট্যাগ হয়)।
event_name / event_attribute / point_id	string	বেস টাইমের ইভেন্ট উৎস (যখন from একটি ইভেন্ট হয়)।

wait_event

ব্যবহারকারীরা একটি ইভেন্ট (বা একটি টাইমআউট) ট্রিগার না করা পর্যন্ত অপেক্ষা করে। POINT_TYPE_WAIT_EVENT। default আউটপুটটি হল নট-ট্রিগারড পাথ। ট্রিগারড পাথটি হল output1 অথবা, একটি স্ক্রিপ্টের সাথে, প্রতি শর্তের জন্য একটি শাখা।

ক্ষেত্র	টাইপ	বর্ণনা
events	PointWaitEventInfo[]	অপেক্ষা করার জন্য ইভেন্ট।
conditions_script	string	জটিল মাল্টি-ইভেন্ট লজিকের জন্য ঐচ্ছিক স্ক্রিপ্ট। এর পার্স করা শর্তের নামগুলি আউটপুট কী হয়ে যায়।
multi_entry	MultiEntry	পুনরায় প্রবেশের আচরণ।

স্প্লিটিং এবং ফিল্টারিং পয়েন্ট

boolean_splitter

একটি শর্তের উপর ভিত্তি করে ব্যবহারকারীদের শাখাগুলির নিচে রুট করে। POINT_TYPE_BOOLEAN_SPLITTER।

ক্ষেত্র	টাইপ	বর্ণনা
split_strategy	enum	SPLIT_FILTER (সেগমেন্ট দ্বারা), SPLIT_TAGS (ট্যাগ শর্ত দ্বারা), বা SPLIT_EVENTS (ইভেন্ট শর্ত দ্বারা)।
load_policy	enum	ALL (ব্যবহারকারীর যেকোনো ডিভাইস মিলতে পারে) বা FILTER (শুধুমাত্র বর্তমান ডিভাইস)।
filter_code	string	সেগমেন্ট কোড, যখন split_strategy হয় SPLIT_FILTER।
filter_expressions	FilterExpression[]	ট্যাগ শর্ত, যখন split_strategy হয় SPLIT_TAGS: প্রতি এক্সপ্রেশনের জন্য একটি অতিরিক্ত output শাখা।
event	BooleanSplitterEventInfo	ইভেন্ট শর্ত, যখন split_strategy হয় SPLIT_EVENTS: প্রতি শর্তের জন্য একটি অতিরিক্ত output শাখা।

ab_splitter

ব্যবহারকারীদের এলোমেলোভাবে ওজনযুক্ত ভেরিয়েন্টে বিভক্ত করে। POINT_TYPE_AB_SPLITTER। আউটপুট কীগুলি হল output0, output1, … (split-এ প্রতি এন্ট্রির জন্য একটি, 0 থেকে ইনডেক্স করা। এখানে কোনো default নেই)।

ক্ষেত্র	টাইপ	বর্ণনা
split	uint32[]	প্রতিটি শাখার জন্য শতাংশ। অবশ্যই 100 পর্যন্ত যোগ হতে হবে। ইনডেক্স i আউটপুট কী output{i}-তে ম্যাপ করে।
auto_select_winner	bool	স্বয়ংক্রিয়ভাবে একটি বিজয়ী শাখা বাছাই করতে হবে কিনা।
winner_strategy	enum	ANY_GOAL বা SPECIFIC_GOAL।
goal_uuid	string	বিজয়ী নির্ধারণের জন্য ব্যবহৃত লক্ষ্য (SPECIFIC_GOAL-এর সাথে)।
winner_split	uint32	বিজয়ী শাখার নম্বর (1-ভিত্তিক, 0 = এখনও কোনো বিজয়ী নেই)।

filter

শুধুমাত্র মিলে যাওয়া ব্যবহারকারীদের (default) চালিয়ে যেতে দেয়, বাকিদের output1-এ রাউটিং করে। POINT_TYPE_FILTER।

ক্ষেত্র	টাইপ	বর্ণনা
filter	enum Filter	একটি পূর্বনির্ধারিত চেক: EMAIL_EXISTS, PUSH_TOKEN_EXISTS, SMS_TOKEN_EXISTS, WHATSAPP_TOKEN_EXISTS, LINE_TOKEN_EXISTS, বা CUSTOM।
filter_raw	string	কাস্টম ফিল্টার এক্সপ্রেশন, যখন filter হয় CUSTOM।

অ্যাকশন পয়েন্ট

set_tags

ব্যবহারকারীর উপর ট্যাগ আপডেট করে। POINT_TYPE_SET_TAGS।

ক্ষেত্র	টাইপ	বর্ণনা
application_code	string	অ্যাপ্লিকেশন কোড।
tags	Tag[]	লেখার জন্য ট্যাগ।

Tag

ক্ষেত্র	টাইপ	বর্ণনা
name	string	ট্যাগের নাম।
type	enum TagType	ডেটা টাইপ এবং অপারেশন: TYPE_STRING, TYPE_INTEGER, TYPE_DATE, TYPE_BOOLEAN, TYPE_LIST, TYPE_LIST_APPEND, TYPE_LIST_REMOVE, TYPE_DYNAMIC, …
value	oneof	type-এর সাথে মিলে যাওয়া ঠিক একটি মান কী: str, int, bool, date, price, version, timezone, list, বা dynamic।

web_hook

একটি আউটবাউন্ড HTTP অনুরোধ পাঠায়। POINT_TYPE_WEBHOOK। একক default আউটপুট।

ক্ষেত্র	টাইপ	বর্ণনা
method	string	HTTP মেথড (GET, POST, PUT, …)।
url	string	টার্গেট URL।
request_template	string	অনুরোধের বডি টেমপ্লেট। Liquid টেমপ্লেটিং সমর্থন করে।
headers	map<string, string>	HTTP হেডার।
disabled	bool	শুধুমাত্র পঠনযোগ্য। true যখন Pushwoosh বারবার ত্রুটির পরে ওয়েবহুকটি স্বয়ংক্রিয়ভাবে নিষ্ক্রিয় করে।
reactivate	bool	শুধুমাত্র লেখার জন্য। একটি নিষ্ক্রিয় ওয়েবহুক পুনরায় সক্রিয় করতে true সেট করুন।

audience_sync

ব্যবহারকারীকে একটি মেটা কাস্টম অডিয়েন্স থেকে যোগ বা অপসারণ করে। POINT_TYPE_AUDIENCE_SYNC।

ক্ষেত্র	টাইপ	বর্ণনা
ad_account_id	string	মেটা অ্যাড অ্যাকাউন্ট আইডি।
ad_account_name	string	ad_account_id-এর জন্য প্রদর্শনের নাম, শুধুমাত্র UI-এর জন্য।
audience_id	string	মেটা কাস্টম অডিয়েন্স আইডি।
audience_name	string	audience_id-এর জন্য প্রদর্শনের নাম, শুধুমাত্র UI-এর জন্য।
action	enum AudienceSyncAction	AUDIENCE_SYNC_ACTION_ADD বা AUDIENCE_SYNC_ACTION_REMOVE।

সতর্কতা

আপনি যখন পয়েন্ট তৈরি বা আপডেট করেন তখন এটি পরীক্ষা করা হয় না — শুধুমাত্র যখন জার্নিটি যাচাই করা হয় বা শুরু করা হয়। একটি খারাপ ad_account_id (আর সংযুক্ত নয়) বা audience_id (মেটা দ্বারা ফেরত দেওয়া হয়নি) ত্রুটি ছাড়াই সেভ হয় এবং শুধুমাত্র সেই সময়েই প্রকাশ পায়, প্রতিটি ব্যবহারকারীর সিঙ্কে নীরবে নয়।

কনভার্সন পয়েন্ট

goal_event

একটি কনভার্সন লক্ষ্য ট্র্যাক করে। POINT_TYPE_GOAL_EVENT। এর কোনো আউটপুট নেই।

ক্ষেত্র	টাইপ	বর্ণনা
event_name	string	লক্ষ্য ইভেন্টের নাম।
application_code	string	অ্যাপ্লিকেশন কোড।
event_conditions	PointEventCondition[]	লক্ষ্য ইভেন্টের অ্যাট্রিবিউটের সাথে মেলানো শর্তাবলী।
is_throw_out	bool	লক্ষ্য অর্জিত হয়ে গেলে ব্যবহারকারীকে জার্নি থেকে সরিয়ে দেওয়া হবে কিনা।
is_cancel_event	bool	এটি একটি নেতিবাচক (বাতিলকরণ) লক্ষ্য কিনা।

এক্সিট পয়েন্ট

terminator

ব্যবহারকারীর জন্য জার্নি শেষ করে। POINT_TYPE_EXIT। খালি অবজেক্ট ({}) এবং কোনো আউটপুট নেই।

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

একটি টার্মিনেটর পয়েন্ট ঐচ্ছিক। একটি আউটপুটের info.next_point_uuid আনসেট রাখলে ব্যবহারকারীর জন্য জার্নিটি একইভাবে শেষ হয় যেমন একটি সুস্পষ্ট টার্মিনেটর করে — উভয় ক্ষেত্রেই একই ভাবে গণনা করা হয়, এক্সিট হিসাবে, ত্রুটি হিসাবে নয়।

মেসেজিং পয়েন্ট

সমস্ত মেসেজিং পয়েন্ট একটি চ্যানেলের মাধ্যমে পাঠায় এবং একটি সাধারণ এনভেলপ শেয়ার করে। একটি স্প্লিটার সক্রিয় না থাকলে প্রতিটির একটি একক default আউটপুট থাকে (দেখুন আউটপুট কী)।

সাধারণ ক্ষেত্র:

ক্ষেত্র	টাইপ	বর্ণনা
application_code	string	অ্যাপ্লিকেশন কোড।
preset_code	string	পাঠানোর জন্য প্রিসেট (টেমপ্লেট)। inapp এর পরিবর্তে richmedia_code ব্যবহার করে।
content / title	string	ইনলাইন মেসেজের বিষয়বস্তু, যখন একটি প্রিসেট ব্যবহার করা হয় না (চ্যানেল-নির্ভর)।
campaign_code	string	ট্র্যাকিংয়ের জন্য ক্যাম্পেইন কোড। বাদ দিলে স্বয়ংক্রিয়ভাবে তৈরি হয়।
split_params	BehaviorSplitter	ঐচ্ছিক: একটি ইন্টারঅ্যাকশনের জন্য অপেক্ষা করুন এবং তার উপর ভিত্তি করে শাখা তৈরি করুন।
message_type	enum	মার্কেটিং বনাম ট্রানজ্যাকশনাল মেসেজের ধরন (কন্ট্রোল-গ্রুপ হ্যান্ডলিং নিয়ন্ত্রণ করে)। send_email দ্বারা ব্যবহৃত হয় না, যার নিজস্ব email_type/email_category জোড়া নীচে রয়েছে।

পয়েন্টের ধরন এবং তাদের উল্লেখযোগ্য অতিরিক্ত ক্ষেত্র:

পয়েন্টের ধরন	point_data কী	নোট
POINT_TYPE_SEND_PUSH	send_push	split_params (আচরণ) এবং একটি ডেলিভারি স্প্লিটার তিনটি পর্যন্ত আউটপুট তৈরি করতে পারে। send_by_user_id, wait_optimal_time।
POINT_TYPE_SEND_EMAIL	send_email	liquid_template_params, personalise, email_type, email_category (নীচে দেখুন)। দেখুন ইমেল এপিআই।
POINT_TYPE_SEND_SMS	send_sms	দেখুন এসএমএস।
POINT_TYPE_SEND_WHATSAPP	send_whatsapp	personalise (নীচে দেখুন)। একটি দ্রুত-উত্তর প্রিসেট প্রতি উত্তরের জন্য একটি আউটপুট যোগ করে (কী = উত্তরের মান)। দেখুন হোয়াটসঅ্যাপ।
POINT_TYPE_SEND_TELEGRAM	send_telegram	টেলিগ্রাম চ্যানেল।
POINT_TYPE_SEND_KAKAO	send_kakao	দেখুন কাকাও।
POINT_TYPE_SEND_LINE	send_line	দেখুন লাইন এপিআই।
POINT_TYPE_SEND_DATA	send_data	সাইলেন্ট ডেটা মেসেজ (কোনো UI নেই)।
POINT_TYPE_INAPP	inapp	richmedia_code, expire_in_days, capping ব্যবহার করে।

সতর্কতা

send_email-এ, email_type অবশ্যই বাদ দিতে হবে অথবা ঠিক marketing বা transactional-এ সেট করতে হবে — ছোট হাতের অক্ষরে, অন্য কোনো মান প্রত্যাখ্যান করা হয়। email_category প্রয়োজন যখন email_type হয় marketing, এবং এটি অবশ্যই একটি বিদ্যমান বিভাগের কোড হতে হবে, তার প্রদর্শনের নাম নয়।

send_whatsapp-এ, একটি personalise.placeholders[] এন্ট্রি যার type: "MPM" (মাল্টি-প্রোডাক্ট মেসেজ) আছে, তার actions.actions[].type অবশ্যই action-এ সেট করতে হবে — একমাত্র অ্যাকশন টাইপ যা মেটা একটি MPM টেমপ্লেট বোতামে গ্রহণ করে। অন্য কোনো মান প্রত্যাখ্যান করা হয়।

আপনি যখন পয়েন্ট তৈরি বা আপডেট করেন তখন এর কোনোটিই পরীক্ষা করা হয় না — শুধুমাত্র যখন জার্নিটি যাচাই করা হয় বা শুরু করা হয়। একটি খারাপ মান ত্রুটি ছাড়াই সেভ হয় এবং শুধুমাত্র সেই সময়েই প্রকাশ পায়।

শেয়ার্ড টাইপ

SegmentRepeat

ক্ষেত্র	টাইপ	বর্ণনা
enabled	bool	পুনরাবৃত্ত এন্ট্রি চালু আছে কিনা।
frequency	string	daily, weekly, monthly, বা dates।
every	uint32	প্রতি N পিরিয়ডে পুনরাবৃত্তি করুন।
dates	string[]	নির্দিষ্ট তারিখ, যখন frequency হয় dates।
time	SegmentRepeatTime	দিনের সময় কনফিগারেশন।

টাইম অবজেক্ট

• ExactTime: { "hour": 0–23, "minute": 0–59 }।
• ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }।

BehaviorSplitter

ক্ষেত্র	টাইপ	বর্ণনা
enabled	bool	একটি ইন্টারঅ্যাকশনের জন্য অপেক্ষা করতে হবে এবং তার উপর ভিত্তি করে শাখা তৈরি করতে হবে কিনা।
interval	uint64	ইন্টারঅ্যাকশনের জন্য অপেক্ষা করার সেকেন্ড।

MultiEntry

একজন ব্যবহারকারী একই সময়ে জার্নিতে কতগুলি সক্রিয় সেশন রাখতে পারে তা নিয়ন্ত্রণ করে। কাস্টমার জার্নি বিল্ডারে একজন ব্যবহারকারী একই সময়ে কতগুলি সেশন রাখতে পারে তা নিয়ন্ত্রণ করুন-কে প্রতিফলিত করে। ইভেন্ট এন্ট্রি পয়েন্ট এবং wait_event দ্বারা ব্যবহৃত হয়।

ক্ষেত্র	টাইপ	বর্ণনা
enabled	bool	একজন ব্যবহারকারী একই সময়ে একাধিক সক্রিয় সেশন রাখতে পারে কিনা। false: প্রতি ব্যবহারকারীর জন্য একটি সক্রিয় সেশন। true: প্রতি ব্যবহারকারীর জন্য একাধিক সক্রিয় সেশন।
attribute_name	string	ঐচ্ছিক। ইভেন্ট অ্যাট্রিবিউট যা প্রতিটি সেশনকে স্কোপ করে। যখন সেট করা হয়, একজন ব্যবহারকারী এই অ্যাট্রিবিউটের প্রতিটি স্বতন্ত্র মানের জন্য একটি সক্রিয় সেশন রাখতে পারে (উদাহরণস্বরূপ, প্রতি order_id-এর জন্য একটি)। একই মানের ইভেন্টগুলি একটি সেশন শেয়ার করে। ব্যবহারকারীর সমস্ত এন্ট্রি একসাথে স্কোপ করতে খালি রাখুন।

সম্পর্কিত

জার্নি অবজেক্ট

তৈরি এবং আপডেট করুন

প্রিসেট এপিআই