براکتها و شخصیسازی پیام
راهنمای استفاده از ویژگیهای کلید-مقدار پروفایل برای ساخت عنوان و متن اختصاصی هر مشترک در ارسالهای گروهی.
براکت چیست و چه کاربردی دارد؟
براکت یک ویژگی کلید-مقدار مخصوص شخصیسازی است که روی پروفایل هر مشترک ذخیره میشود؛ مانند name، product_name یا new_price. هنگام ارسال گروهی یک قالب مشترک میفرستید، اما پوشفا پیش از ساخت payload متن را جداگانه برای هر گیرنده میسازد. برای نمونه قالب «{name} عزیز، قیمت {product_name} به {new_price} تومان رسید» برای هر پروفایل با مقادیر خودش ارسال میشود.
قالبهای قابل استفاده
| قالب | منبع مقدار | رفتار در نبود مقدار |
|---|---|---|
| {name} | براکت name | یک کاراکتر فاصله |
| {name:کاربر} | براکت name | مقدار پیشفرض «کاربر» |
| {custom_alias:product_name} | Custom Alias با label برابر product_name | یک کاراکتر فاصله |
| {custom_alias:product_name:محصول} | Custom Alias با label برابر product_name | مقدار پیشفرض «محصول» |
ثبت براکت از Web SDK
متدهای براکت مانند Custom Alias کار میکنند و افزودن دوباره یک key مقدار قبلی همان key را جایگزین میکند. دسترسی JavaScript با تنظیمات ثبت، حذف و دریافت Alias سرویس کنترل میشود.
await window.Pushfa.addBracket('name', 'سارا');
await window.Pushfa.addBrackets({
product_name: 'کفش ورزشی',
new_price: '۱٬۲۹۰٬۰۰۰'
});
const brackets = window.Pushfa.getBrackets();
await window.Pushfa.removeBracket('new_price');
await window.Pushfa.removeBrackets(['product_name', 'new_price']);فعالکردن براکت هنگام ارسال
برای حفظ سازگاری پیامهای قدیمی، پردازش براکت اختیاری است. در ارسال گروهی معمولی یا لایت، ارسال با Alias، Custom Alias و Subscriber ID مقدار use_brackets را true کنید. اگر این فیلد ارسال نشود یا false باشد، آکولادها عیناً در متن باقی میمانند.
{
"topic": "all",
"title": "{name:کاربر} عزیز",
"body": "قیمت {product_name:محصول} به {new_price:نامشخص} تومان رسید.",
"use_brackets": true,
"sendTime": "current"
}مدیریت براکت از طریق وبسرویس
اگر براکتها را از بکاند یا CRM ثبت و بهروزرسانی میکنید، مرجع endpointها، پارامترها و نمونه درخواستها در بخش وبسرویسهای براکت قرار دارد.