مخاطبان و مقصدها
مخاطب، تعریف یک گروه از کاربران شناساییشده است؛ مقصد، سیستمی است که آن گروه به آن تحویل میشود. عضویت ذخیره نمیشود — هر بار از نو روی دادهها حساب میشود — و فعالسازی یک خروجی تکباره است، نه همگامسازی پیوسته.
دو نیمه یک کار#
«فعالسازی» در ادپیکس دو تکه دارد و در دو جای متفاوت ساخته میشوند:
- مخاطب — تعریف گروه. در نوار کناری زیر گروه «فعال سازی»، صفحه «مخاطبان» در مسیر
/audiences. - مقصد — سیستمی که گروه به آن میرود. در «مدیریت» ← «یکپارچه سازی ها و ماژولهای CRM» ساخته میشود، نه در این صفحه.
بدون دستکم یک مقصد فعال، دکمه «فعال سازی» با پیام «هیچ مقصدی پیکربندی نشده است.» متوقف میشود. اول مقصد را بسازید.
مخاطبان روی پلن رایگان باز نیست. اگر دارایی فعال شما روی پلن رایگان باشد، منو با نشان «ویژگی پریمیوم» میآید و صفحه بهجای ابزار ساخت، کارت «ارتقای پلن» را نشان میدهد. جدا از پلن، این آیتم فقط برای کسی در نوار کناری دیده میشود که اختیار ویرایش مخاطبان را داشته باشد.
ساخت یک مخاطب#
کارت بالای صفحه، «ساخت مخاطب (DSL سگمنت بندی مشترک)»، همان زبان شرطنویسی سگمنتها را به کار میبرد.
فیلد یک کادر متنی خالی است، نه فهرست کشویی — باید نام دقیق فیلد را بنویسید. اینها فیلدهای پایهاند:
| گروه | فیلدها |
|---|---|
| اولین تماس | ft_channel، ft_source، ft_medium، ft_campaign، ft_term، ft_content |
| آخرین تماس | lt_channel، lt_source، lt_medium، lt_campaign |
| رویداد | event_name، event_type، page_path، page_title، referrer_url |
| جغرافیا | geo_country، geo_region، geo_city |
| فناوری | ua_browser، ua_os، ua_device_class |
هر بعد سفارشی که در دارایی تعریف کرده باشید هم با همان نام کار میکند. عملگرها همانهایی هستند که در فهرست میبینید: «برابر است با»، «برابر نیست با»، «شامل است»، «شامل نیست»، «شروع میشود با»، «پایان مییابد با»، «با عبارت باقاعده مطابقت دارد»، «بزرگ تر از» و «کوچک تر از». دو تای آخر مقدار را عدد میخوانند؛ متن غیرعددی صفر حساب میشود.
اگر نام فیلد را اشتباه بنویسید — ft_chanel بهجای ft_channel — نه خطایی میبینید و نه اخطاری. آن شرط از تعریف حذف میشود. اگر تنها شرط شما همان بوده باشد، مخاطب به هر کاربر شناساییشده در دارایی تبدیل میشود و فعالسازی، کل پایگاه کاربران شما را به CRM میفرستد. پیش از هر فعالسازی «اندازه» را بزنید و عدد را باور کنید.
عضویت دقیقا چطور حساب میشود#
هیچ فهرست عضویتی ذخیره نمیشود. هر بار که «اندازه» یا «فعال سازی» را بزنید، شرطها همان لحظه روی دادههای دارایی اجرا میشوند. چهار نکته که رفتار را تعیین میکنند:
- فقط کاربران شناساییشده. شمارش روی شناسه کاربر سراسری است، پس بازدیدکنندهای که هنوز به کاربر واقعی وصل نشده هرگز عضو نمیشود. چطور این وصل شدن اتفاق میافتد در ادپیکس چطور بازدیدکننده را میشناسد آمده است.
- پنجره ثابت ۳۰ روزه. اندازه و فعالسازی همیشه ۳۰ روز گذشته را میبینند و انتخابگر تاریخ بالای صفحه را نمیخوانند. کسی که ۴۰ روز پیش خرید کرده و از آن زمان برنگشته، عضو نیست.
- شرطها روی یک رویداد جمع میشوند. با «همه»، همه شرطها باید روی یک رویداد واحد برقرار باشند، نه روی کارنامه کلی کاربر. «کانال برابر
Paid Searchو صفحه برابر/pricing» یعنی کاربر رویدادی دارد که هر دو را داشته باشد؛ یعنی «از تبلیغات آمد و بعدا صفحه قیمت را دید» نیست. برای چنین منطقی از «هر یک» استفاده کنید یا دو مخاطب جدا بسازید. - عدد «اندازه» ثبت میشود. ستون «اندازه» در جدول آخرین مقداری است که حساب شده — نه مقدار زنده. تا دوباره «اندازه» را نزنید عوض نمیشود.
مقصدها#
مقصد در سطح سازمان ساخته میشود و سه شکل دارد:
| نوع | چه چیزی دریافت میکند |
|---|---|
| وبهوک عمومی | یک POST با بدنه JSON به آدرس شما |
| WHMCS — افزونه همراه | همان بدنه، به گیرنده افزونه روی نصب WHMCS شما |
| WHMCS — API مدیریتی | فراخوانی API خود WHMCS برای نوشتن روی فیلدهای سفارشی مشتری |
فهرست انتخاب هنگام فعالسازی فقط مقصدهای فعال را نشان میدهد و مقصد باید متعلق به همان سازمان دارایی باشد؛ در غیر این صورت درخواست با 403 رد میشود. متد، هدرهای سفارشی و امضای HMAC روی مقصد هم پشتیبانی میشوند، ولی فرم «افزودن مقصد» در کنسول فقط آدرس و رمز مشترک را میگیرد — بقیه از راه API تنظیم میشود. جزئیات در وبهوکها و امضای HMAC.
فعالسازی و آنچه تحویل میشود#
«فعال سازی» را در سطر مخاطب بزنید، مقصد را انتخاب کنید و تایید کنید. ادپیکس اعضا را حساب میکند، برای هر عضو شناسههای CRMاش را از پرونده هویت برمیدارد و یک تحویل جدا در صف میگذارد. پیام موفقیت میگوید چند عضو در صف نشستهاند و ستون «آخرین فعال سازی» بهروز میشود.
هر تحویل یک بدنه به این شکل دارد:
بدنه فقط همین است: عضویت. اتریبیوشن، مقدار سفارش و اولین و آخرین تماس در بدنه رویدادهای کسبوکار میآیند، نه اینجا.
هر فعالسازی حداکثر پنج هزار عضو را برمیدارد. اگر مخاطب بزرگتر باشد، مابقی بیصدا جا میمانند و پیام موفقیت هم عدد بزرگتری نشان نمیدهد. برای گروههای بزرگتر، مخاطب را با شرطهای ریزتر به چند تکه بشکنید.
فعالسازی، خروجی تکباره است، نه همگامسازی. کسی که از مخاطب خارج شده هیچ پیامی نمیگیرد؛ کسی که بار قبل فرستاده شده در فعالسازی بعدی دوباره فرستاده میشود، با کلید یکتاسازی تازه. گیرنده باید بر اساس global_user_id بیاثر باشد.
تضمینهای تحویل#
مسیر تحویل، صندوق خروج تراکنشی است — همان مسیری که رویدادهای کسبوکار از آن به CRM میروند. یعنی خاموشی موقت گیرنده باعث از دست رفتن داده نمیشود:
| موضوع | رفتار |
|---|---|
| نوشتن در صف | تراکنشی؛ فعالسازی وقتی موفق است که ردیفها در صف نشسته باشند |
| چرخه تحویل | هر دو ثانیه، تا پنجاه ردیف آماده در هر دور |
| موفقیت | هر پاسخ با کد کمتر از 300 |
| شکست | تا دوازده تلاش، با عقبنشینی نمایی تا سقف یک ساعت |
| پس از تلاش آخر | ردیف به صف نامه مرده میرود و دیگر هیچوقت فرستاده نمیشود |
| ردیف بلاتکلیف | تحویلی که بیش از بیست دقیقه در حال ارسال مانده باشد دوباره قابل تلاش میشود |
تحویل حداقل یک بار است. صف تضمین میکند یک تحویل بیش از یک بار در صف نمینشیند، ولی تضمین نمیکند بیش از یک بار فرستاده نشود — اگر گیرنده 200 بدهد و ارتباط پیش از رسیدن پاسخ قطع شود، همان ردیف دوباره میرود. مهلت هر درخواست پانزده ثانیه است.
هر تحویل موفق با کد وضعیت و زمان پاسخش ثبت میشود، پس اگر گیرنده چیزی را ندیده باشد میشود ثابت کرد ادپیکس آن را فرستاده است.
حذف یک مقصد، تحویلهای در انتظار همان مقصد را هم حذف میکند. اگر گیرنده چند ساعت از دسترس خارج بوده و شما مقصد را حذف و دوباره بسازید، آن ردیفها برنمیگردند. برای قطع موقت، بهجای حذف، کلید وضعیت مقصد را خاموش کنید.
پاک کردن مخاطب#
«حذف» در سطر مخاطب فقط تعریف را حذف میکند. آنچه قبلا تحویل داده شده در CRM شما میماند و ادپیکس هیچ پیام «حذفم کن» نمیفرستد. پاک کردن گروه در سمت گیرنده کار خودتان است.
پرسشهای پرتکرار#
فعالسازی یک همگامسازی پیوسته است؟
نه. هر بار که «فعال سازی» را میزنید، اعضای همان لحظه دوباره حساب میشوند و برای هر عضو یک تحویل تازه در صف مینشیند. کسی که از مخاطب خارج شده باشد پیام «حذف» نمیگیرد و کسی که قبلا فرستاده شده دوباره فرستاده میشود. گیرنده باید بر اساس شناسه کاربر سراسری بیاثر باشد.
چرا اندازه مخاطب با بازه تاریخ بالای صفحه نمیخواند؟
چون اندازه و فعالسازی، بازه انتخابی شما را نمیخوانند و همیشه روی ۳۰ روز گذشته حساب میشوند. انتخابگر تاریخ بالای صفحه روی این عدد اثری ندارد.
چرا مخاطب من همه کاربران را برمیگرداند؟
به احتمال زیاد نام فیلد را اشتباه نوشتهاید. شرطی که فیلدش شناخته نشود بیسروصدا کنار گذاشته میشود و اگر همه شرطها کنار بروند، مخاطب به «هر کاربر شناساییشده» تبدیل میشود. پیش از فعالسازی همیشه یک بار «اندازه» را بزنید.
بازدیدکننده ناشناس هم میتواند عضو باشد؟
نه. عضویت بر اساس شناسه کاربر سراسری حساب میشود، پس فقط کسانی عضو میشوند که به یک کاربر واقعی وصل شدهاند — با ورود، ایمیل، شماره تلفن یا شناسه مشتری CRM.
ممنون — بازخورد شما به بهتر شدن مستندات کمک میکند.