رفتن به محتوا
مستنداتجست‌وجو در مستنداتفارسیبازگشت به سایتورود به کنسول

مخاطبان و مقصدها

مخاطب، تعریف ذخیره‌شدهٔ یک گروه از افراد در یک وب‌سایت است — چه کسی چه کاری کرده، چند بار، به چه ترتیبی و چه کسانی کنار گذاشته شوند. ادپیکس فهرست اعضا را نگه می‌دارد و خودش به‌روز می‌کند؛ پس اندازه‌ای که می‌بینید همان اندازه‌ای است که ارسال می‌شود، و به مقصد فقط اعضای شناسایی‌شده می‌رسند.

مخاطب چیست#

مخاطب یک گروه نام‌دار از افراد در یک وب‌سایت است که با قاعده توصیف می‌شود، نه با فهرست: «به سبد خرید اضافه کرده و ظرف ۳ روز خرید نکرده»، «در ۹۰ روز گذشته بیش از ۲۰ خرید کرده»، «بازدیدکنندگان موبایلی که از جست‌وجوی پولی آمده‌اند». ادپیکس این قاعده‌ها را به فهرست اعضا تبدیل می‌کند، آن را به‌روز نگه می‌دارد و در سه جا به کارتان می‌آید:

  • گزارش‌ها — مخاطب را روی هر گزارش یا روی «بی‌درنگ» به‌عنوان مقایسه اضافه کنید. مقایسه‌ها را ببینید.
  • هم‌پوشانی — ببینید دو یا سه مخاطب چقدر با هم اشتراک دارند. هم‌پوشانی مخاطبان را ببینید.
  • مقصدها — اعضای شناسایی‌شده را به CRM یا هر وب‌هوکی بفرستید.

این صفحه‌ها در نوار کناری زیر گروه «فعال‌سازی» هستند و از /audiences شروع می‌شوند.

ویژگی پریمیوم

مخاطبان روی پلن رایگان باز نیست. هر کسی که گزارش‌های وب‌سایت را می‌بیند می‌تواند مخاطبان را باز کند؛ ساختن، ویرایش، به‌روزرسانی، حذف و ارسال به اختیار ویرایش مخاطبان (نقش بازاریاب و بالاتر) نیاز دارد. شرط یا تفکیکی که روی یک شناسه باشد — فهرست CRM، یا ایمیل، تلفن یا نامی که با فراخوان identify فرستاده شده — اختیار «شناسه‌ها» را هم لازم دارد و کسی که آن را ندارد این مقدارها را به‌صورت ••• می‌بیند.

فهرست مخاطبان#

فهرست مخاطبان با اندازه، روند ۲۸ روزه و مقصدها.
فهرست مخاطبان با اندازه، روند ۲۸ روزه و مقصدها.

/audiences همهٔ مخاطبان وب‌سایت را به ترتیب نام فهرست می‌کند. هر سطر این‌ها را نشان می‌دهد:

ستون معنی
مخاطب نام، خلاصهٔ یک‌خطی قاعده‌ها و نشان‌هایی مثل «توالی» یا «استثنا»
کاربران افرادی که همین حالا عضو هستند
روند و تغییر نمودار کوچک ۲۸ روزه و تغییر نسبت به روز اول همان بازه
مقصدها جاهایی که مخاطب به آن‌ها ارسال می‌شود
ایجاد زمان و سازنده

سرصفحه نشان می‌دهد وب‌سایت چند مخاطب از سقف ۱۰۰ دارد و چند نفر دست‌کم در یکی از مخاطبان هستند، در مقایسه با همهٔ کاربران در بازهٔ انتخابی. زبانه‌ها بر اساس نوع جدا می‌کنند: «همه»، «همگام‌شده» (متصل به مقصد)، «توالی‌ها» و «پیش‌بینی‌شده» که برچسب «به‌زودی» دارد — مخاطبان پیش‌بینی‌شده هنوز در دسترس نیستند.

از همین‌جا می‌توانید «گزارش هم‌پوشانی» را باز کنید، فهرست را به CSV ببرید یا «مخاطب جدید» را بزنید.

شروع یک مخاطب جدید#

«مخاطب جدید» صفحهٔ /audiences/new را با چهار راه باز می‌کند:

  • سفارشی — سازندهٔ خالی.
  • پیشنهادی — مخاطبان آماده که روی دادهٔ خود شما در ۲۸ روز گذشته اندازه‌گیری شده‌اند، هر کدام با اندازهٔ تقریبی. اگر پیشنهادی به رویدادی نیاز داشته باشد که وب‌سایت شما در ۲۸ روز گذشته ثبت نکرده، نام همان رویداد را می‌گوید و اندازه‌ای نشان نمی‌دهد.
  • الگوها — همان مجموعه، که در سازنده باز می‌شود تا پیش از ذخیره تغییرش دهید.
  • توصیفش کنید (بتا) — مخاطب را با زبان ساده بنویسید و شرط‌ها را تحویل بگیرید. اگر برای وب‌سایت کلید هوش مصنوعی تنظیم نشده باشد در دسترس نیست.

پیشنهادها عبارت‌اند از: رهاکنندگان سبد خرید، خریداران، خریداران تکراری، خریدارانی که ۷ یا ۱۴ روز فعالیتی نداشته‌اند، جست‌وجوکنندگان سایت، کاربران تازهٔ ۷ روز گذشته، کاربران درگیر بدون تبدیل، و بازدیدکنندگان جست‌وجوی پولی.

ساختن قاعده‌ها#

سازنده در /audiences/build (و «ویرایش تعریف» روی مخاطب موجود) دو نیمه دارد: چه کسانی شامل شوند و چه کسانی استثنا.

گروه‌های شمول#

هر گروه شمول تا ده شرط دارد و مشخص می‌کند همهٔ آن‌ها برقرار باشند یا هر یک. با «یا» گروه‌های بیشتری اضافه کنید: هر کس یکی از گروه‌های شمول را برآورده کند عضو است. هر گروه یک دامنه هم دارد:

دامنه گروه وقتی برقرار است که…
کاربر شرط‌ها روی کل کارهای آن فرد در بازه، در همهٔ نشست‌ها، برقرار باشند
نشست یک نشست به‌تنهایی شرط‌ها را برآورده کند
رویداد یک رویداد واحد همهٔ شرط‌ها را داشته باشد (فقط شرط‌های رویداد و بُعد)

انواع شرط#

نوع مثال نکته
رویداد purchase را در ۳۰ روز گذشته دست‌کم ۲ بار انجام داده شمارش با ≥ > = ≤ <؛ = 0 یعنی «انجام نداده»؛ تا سه فیلتر پارامتر روی همان رویداد، مثل value ≥ 20
بُعد دستهٔ دستگاه یکی از موبایل و تبلت است کانال، منبع، رسانه و کمپین (اولین بازدید و نشست)، کشور، استان، شهر، دستگاه، مرورگر، سیستم‌عامل، مسیر صفحه، عنوان صفحه، نام میزبان، نام رویداد، اپراتور شبکه، نوع شبکه، زبان، یا یک پارامتر سفارشی رویداد
توالی به سبد اضافه کرده، سپس ظرف ۳ روز خرید نکرده ۲ تا ۶ گام به ترتیب در ۱ تا ۹۰ روز؛ فقط گام آخر می‌تواند «انجام نداده» باشد
ویژگی CRM پلن جزو free نیست فقط افراد شناسایی‌شده؛ سازنده نشان می‌دهد چند پروفایل این ویژگی را دارند
مخاطب عضو «خریداران» است عضویت یا عدم عضویت در مخاطب دیگری از همین وب‌سایت

تطبیق بُعد و پارامتر دقیق است: «یکی از این‌ها است»، «هیچ‌کدام از این‌ها نیست»، «شامل است»، «شروع می‌شود با» و مقایسهٔ عددی «بزرگ‌تر / کوچک‌تر از». تطبیق با عبارت باقاعده وجود ندارد. نام بُعدی که سرور نشناسد با خطایی رد می‌شود که همان شرط را نام می‌برد — یک اشتباه تایپی هیچ‌وقت مخاطب را به «همه» تبدیل نمی‌کند.

گروه‌های استثنا#

گروه استثنا کسانی را که با آن جور باشند بیرون می‌گذارد. استثنای موقت روی بازهٔ عضویت سنجیده می‌شود، پس کسی که دیگر با آن جور نباشد برمی‌گردد. استثنای دائمی کل تاریخچه را می‌بیند: یک بار جور شد، دیگر هرگز عضو نمی‌شود — مثلا «تا حالا مرجوعی داشته».

مدت عضویت#

«مدت عضویت» (۱ تا ۵۴۰ روز، پیش‌فرض ۹۰) بازهٔ نگاه به گذشته است: فرد باید دست‌کم یک رویداد در این بازه داشته باشد، و برای هر شرطی که بازهٔ خودش را تعیین نکند بازهٔ پیش‌فرض همین است.

برآورد زنده#

همین‌طور که ویرایش می‌کنید، پنل کناری حدود نیم ثانیه پس از هر تغییر مخاطب را دوباره حساب می‌کند:

  • کاربران و سهم آن از همهٔ کاربران وب‌سایت.
  • ستون‌های هفتگی — اعضا نخستین بار چه هفته‌ای فعال بوده‌اند، در ۱۴ هفته.
  • هم‌پوشانی با ده مخاطب بزرگ ذخیره‌شدهٔ شما، و یادداشتی وقتی مخاطب تازه با یکی از آن‌ها برابر است، داخل آن است یا آن را در بر می‌گیرد.
  • ارسال به — مقصدهایی که مخاطب پس از ذخیره به آن‌ها داده می‌دهد. گوگل ادز و متا با برچسب «به‌زودی» آمده‌اند.

برآورد همان پرس‌وجوی مخاطب ذخیره‌شده را اجرا می‌کند، پس عددی که ذخیره می‌کنید همان است که دیدید.

«ذخیرهٔ مخاطب» را بزنید. ادپیکس عضویت را بلافاصله حساب می‌کند؛ اگر بیش از ۳۰ ثانیه طول بکشد، مخاطب «در حال محاسبه» نشان داده می‌شود و کار در پس‌زمینه تمام می‌شود. بعد از آن طبق زمان‌بندی خودش (پیش‌فرض هر ۱۵ دقیقه) به‌روز می‌شود.

صفحهٔ مخاطب#

با باز کردن یک مخاطب، /audiences/<id> می‌آید:

  • شاخص‌های اصلی در بازهٔ انتخابی: کاربران و دستگاه‌ها، کسانی که وارد و خارج شده‌اند (هر فرد یک بار شمرده می‌شود، با هر چند دستگاه)، سهم اعضای فعال در بازه که در همان بازه تبدیل داشته‌اند (کنار همین نرخ برای همهٔ کاربران) و درآمدی که آن تبدیل‌ها آورده‌اند.
  • روند اندازه — یک نقطه برای هر روز، با نشانه‌ای هر جا که تعریف ویرایش شده.
  • ترکیب — تقسیم اعضا بر اساس یک بُعد (دستگاه، کشور، کانال …) با شاخصی نسبت به همهٔ کاربران: 150 یعنی احتمال داشتن آن مقدار در اعضا یک‌ونیم برابر بقیه است.
  • تعریف — قاعده‌ها به‌صورت برچسب‌های خوانا، همراه با تاریخچهٔ ویرایش.

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

کاربران و دستگاه‌ها

«کاربران» آدم‌ها را می‌شمارد: فعالیت یک فرد واردشده از چند دستگاه یک بار حساب می‌شود. «دستگاه‌ها» مرورگرها و اپ‌های متمایز را می‌شمارد، یعنی همان چیزی که گزارش‌های استاندارد «کاربر» می‌نامند. به همین دلیل مخاطبی با ۱۲۰ کاربر می‌تواند ۱۴۰ دستگاه داشته باشد، و مقایسهٔ مخاطب روی یک گزارش، دستگاه‌ها را می‌شمارد.

مقصدها#

مقصد سیستمی است که اعضا به آن فرستاده می‌شوند. در «مدیریت» ← «یکپارچه‌سازی‌ها» ساخته می‌شود، نه در این صفحه، و سه شکل دارد:

نوع چه چیزی دریافت می‌کند
وب‌هوک عمومی یک POST با بدنهٔ JSON به آدرس شما
WHMCS — افزونهٔ همراه همان بدنه، به گیرندهٔ افزونه روی نصب WHMCS شما
WHMCS — API مدیریتی فراخوانی API خود WHMCS برای نوشتن روی فیلدهای سفارشی مشتری

مخاطب می‌تواند از هر مقصد فعال سازمان خودش استفاده کند که به وب‌سایت دیگری بسته نشده باشد؛ بقیه رد می‌شوند. متد، هدرهای سفارشی و امضای HMAC در وب‌هوک‌ها و امضای HMAC آمده‌اند.

ارسال اعضا#

دو راه برای فرستادن اعضا هست:

  • اتصال مقصد («ارسال به»). نخستین به‌روزرسانی پس از اتصال همهٔ اعضای فعلی را می‌فرستد؛ پس از آن هر به‌روزرسانی کسانی را می‌فرستد که از آخرین همگام‌سازی موفق عضو شده‌اند. کسی که پس از عضویت شناسایی شود با فعال‌سازی به مقصد می‌رسد.
  • فعال‌سازی — همین حالا همهٔ اعضای فعلی را به یک مقصد بفرستید.

در هر دو حالت فقط اعضای شناسایی‌شده از ادپیکس بیرون می‌روند — کسانی که به یک ورود، ایمیل، شماره تلفن یا شناسهٔ مشتری CRM وصل‌اند. بازدیدکنندگان ناشناس و کسانی که ادپیکس فقط از روی دستگاه شناخته، هرگز فرستاده نمی‌شوند. همهٔ اعضای شناسایی‌شده در صف می‌نشینند، برای هر نفر یک تحویل؛ سقفی ندارد و هیچ‌کس جا نمی‌ماند.

هر تحویل این بدنه را دارد:

{
  "type": "audience_member",
  "audience_id": "0192f3a1-…",
  "audience_name": "خریداران",
  "global_user_id": "0192f3b0-…",
  "external_ids": {
    "external_id": "0192f3b0-…",
    "crm_client_id": "4821",
    "whmcs_clientid": "4821",
    "email": "ali@example.com"
  }
}

external_ids فقط کلیدهایی را دارد که ادپیکس واقعا برای آن فرد دارد. بدنه فقط عضویت است — اتریبیوشن و مبلغ سفارش در بدنهٔ رویدادهای کسب‌وکار می‌آیند.

برای کسانی که از مخاطب خارج می‌شوند پیام حذف فرستاده نمی‌شود؛ پاک کردنشان در سمت گیرنده با خودتان است. گیرنده باید بر اساس global_user_id بی‌اثر (idempotent) باشد.

تضمین‌های تحویل#

تحویل از صندوق خروج تراکنشی می‌گذرد — همان مسیری که رویدادهای کسب‌وکار به CRM می‌روند — پس خاموشی کوتاه گیرنده باعث از دست رفتن داده نمی‌شود:

موضوع رفتار
نوشتن در صف تراکنشی؛ ارسال وقتی موفق است که ردیف‌ها در صف نشسته باشند
چرخهٔ تحویل هر دو ثانیه، تا پنجاه ردیف آماده در هر دور
موفقیت هر پاسخ با کد کمتر از 300
شکست تا دوازده تلاش، با عقب‌نشینی نمایی تا سقف یک ساعت
پس از تلاش آخر ردیف به صف نامهٔ مرده می‌رود و دیگر هرگز فرستاده نمی‌شود
ردیف بلاتکلیف تحویلی که بیش از بیست دقیقه در حال ارسال مانده باشد دوباره قابل تلاش می‌شود

تحویل دست‌کم یک بار است: هیچ ردیفی دو بار در صف نمی‌نشیند، ولی اگر گیرنده 200 بدهد و ارتباط پیش از رسیدن پاسخ قطع شود، همان ردیف دوباره فرستاده می‌شود. مهلت هر درخواست پانزده ثانیه است.

حذف مقصد، صفش را هم پاک می‌کند

حذف مقصد، تحویل‌های در انتظار آن را هم حذف می‌کند. برای توقف موقت، به‌جای حذف، مقصد را خاموش کنید.

حذف مخاطب#

«حذف» مخاطب و عضویتش را پاک می‌کند و بلافاصله از مقایسه‌ها و هم‌پوشانی کنار می‌رود. آنچه قبلا تحویل شده در CRM شما می‌ماند — ادپیکس پیام حذفی نمی‌فرستد.

پرسش‌های پرتکرار#

چرا برآورد داخل سازنده دقیقا با اندازهٔ مخاطب ذخیره‌شده یکی است؟

چون هر دو یک پرس‌وجو را اجرا می‌کنند. برآورد زنده، پیشنهادها و به‌روزرسانی مخاطب ذخیره‌شده از یک مترجم تعریف استفاده می‌کنند؛ پس برآورد تقریبی از اندازهٔ نهایی نیست — همان اندازه است که پیش از ذخیره حساب شده.

فرق «کاربران» و «دستگاه‌ها» چیست؟

«کاربران» آدم‌ها را می‌شمارد: کسی که وارد حسابش شده و هم با موبایل و هم با لپ‌تاپ آمده یک کاربر است. «دستگاه‌ها» مرورگرها و اپ‌ها را می‌شمارد (شناسه‌های دستگاه متمایز)، یعنی همان چیزی که بیشتر گزارش‌ها «کاربر» می‌نامند. مخاطب هر دو را نشان می‌دهد و عدد اصلی «کاربران» است.

بازدیدکنندهٔ ناشناس هم می‌تواند عضو باشد؟

بله — عضویت روی همهٔ بازدیدکنندگانی که با شرط‌ها جور باشند حساب می‌شود. فقط ارسال به مقصد محدود است: بازدیدکنندهٔ ناشناس هرگز از ادپیکس بیرون نمی‌رود و مقصد فقط اعضای شناسایی‌شده را می‌گیرد (با ورود، ایمیل، شماره تلفن یا شناسهٔ مشتری CRM).

عضویت چقدر تازه است؟

با ذخیرهٔ مخاطب، عضویت همان لحظه حساب می‌شود. بعد از آن ادپیکس طبق زمان‌بندی دوباره حسابش می‌کند — پیش‌فرض هر ۱۵ دقیقه، و حداکثر روزی یک بار — و هر وقت خواستید می‌توانید «به‌روزرسانی» را بزنید.

مخاطبان قدیمی من چه می‌شوند؟

مخاطبانی که با شرط‌های تک‌رویدادی نسخهٔ قبل ساخته شده‌اند هنگام خواندن ارتقا پیدا می‌کنند. شرطی که معادل دقیق ندارد (شامل نیست، پایان می‌یابد با، عبارت باقاعده یا فیلد ناشناس) حدس زده نمی‌شود: مخاطب وضعیت «خطا» می‌گیرد و همان شرط را نام می‌برد تا اصلاحش کنید. هیچ‌وقت بی‌صدا به «همه» تبدیل نمی‌شود.

با API بسازیدبفهمید درآمد از کجا می‌آید.
آیا این صفحه مفید بود؟