पॉइंट संदर्भ

प्रत्येक पॉइंट में एक 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

स्टार्ट बाय एपीआई कॉल द्वारा फ़ीड किया गया एंट्री पॉइंट। POINT_TYPE_START_BY_API।

फ़ील्ड	प्रकार	विवरण
application_code	string	एप्लिकेशन कोड।
attributes	string[]	कस्टम एट्रिब्यूट्स के नाम जो स्टार्ट बाय एपीआई अनुरोध के 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	एक टैग या इवेंट से एक मान के सापेक्ष प्रतीक्षा करें।

split_branches: true के साथ एक dynamic_time एक 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	अनुरोध बॉडी टेम्पलेट। लिक्विड टेम्पलेटिंग का समर्थन करता है।
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 को अनसेट छोड़ना यूज़र के लिए जर्नी को उसी तरह समाप्त करता है जैसे एक स्पष्ट टर्मिनेटर करता है - दोनों मामलों को एक ही तरह से गिना जाता है, Exits के रूप में, न कि त्रुटियों के रूप में।

मैसेजिंग पॉइंट्स

सभी मैसेजिंग पॉइंट्स एक चैनल के माध्यम से भेजते हैं और एक सामान्य लिफाफा साझा करते हैं। प्रत्येक का एक ही 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 पर, type: "MPM" (मल्टी-प्रोडक्ट मैसेज) के साथ एक personalise.placeholders[] प्रविष्टि में 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 एक)। समान मान वाले इवेंट एक सत्र साझा करते हैं। यूज़र की सभी प्रविष्टियों को एक साथ स्कोप करने के लिए खाली छोड़ दें।

संबंधित

जर्नी ऑब्जेक्ट

बनाएं और अपडेट करें

प्रीसेट्स एपीआई