براکت‌ها و شخصی‌سازی پیام

یک پیام گروهی بنویسید و بخش‌هایی از آن، مانند نام یا امتیاز، را برای هر مخاطب تغییر دهید. این بخش‌ها هنگام ارسال با اطلاعات ذخیره‌شده در پروفایل همان مخاطب پر می‌شوند.

براکت چیست و چه کاربردی دارد؟

براکت یک ویژگی کلید-مقدار مخصوص شخصی‌سازی است که روی پروفایل هر مشترک ذخیره می‌شود؛ مانند name، product_name یا new_price. هنگام ارسال گروهی یک قالب مشترک می‌فرستید، اما پوشفا پیش از ساخت داده‌های پیام متن را جداگانه برای هر گیرنده می‌سازد. برای نمونه قالب «{name} عزیز، قیمت {product_name} به {new_price} تومان رسید» برای هر پروفایل با مقادیر خودش ارسال می‌شود.

براکت با شناسه سفارشی (Custom Alias) فرق دارد: براکت برای محتوای شخصی پیام است؛ شناسه سفارشی (Custom Alias) در اصل شناسه برچسب‌دار مخاطب و ابزار هدف‌گیری است. با این حال می‌توانید با پیشوند custom_alias مقدار یک شناسه سفارشی (Custom Alias) را نیز داخل متن بخوانید.

قالب‌های قابل استفاده

جایگزینی در title و body انجام می‌شود و محدودیت نهایی طول عنوان و متن پس از جایگزینی نیز اعمال خواهد شد.

قالب	منبع مقدار	رفتار در نبود مقدار
{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"
}

ارسال گروهی با گزارش ارسال گروهی لایت ارسال با Alias ارسال با شناسه سفارشی (Custom Alias)

مدیریت براکت از طریق وب‌سرویس

اگر براکت‌ها را از بک‌اند یا CRM ثبت و به‌روزرسانی می‌کنید، مرجع مسیرهای وب‌سرویس، پارامترها و نمونه درخواست‌ها در بخش وب‌سرویس‌های براکت قرار دارد.

مشاهده وب‌سرویس‌های براکت