هدفگیری دستگاه
سیستمعامل، موبایل، تبلت و پیشنمایش فیلترها.
فیلتر چندانتخابی سیستمعامل و دستگاه
در مرحله بودجه و زمان ساخت کمپین، سیستمعامل، نوع دستگاه و محیط نمایش را انتخاب کنید. از جزئیات کمپین، دکمه «فیلتر دستگاه» امکان ویرایش و آزمایش یک دستگاه نمونه را میدهد. تغییر برای درخواستهای بعدی اعمال میشود؛ تعهدهای رزروشده قبلی و اسناد مالی عوض نمیشوند.
| گروه | گزینههای API |
|---|---|
| سیستمعامل | android, ios, windows, macos, linux, other, unknown |
| نوع دستگاه | mobile, tablet, desktop, unknown |
| محیط نمایش | app, site |
گزینههای یک گروه با «یا» و گروهها با «و» ترکیب میشوند. آرایه خالی یا حذف گروه به معنی همه گزینههای سازگار آن گروه است. مثلاً اندروید یا iOS، فقط تبلت، داخل اپ. فرمتهای جایزهای و app_open اجازه هدفگیری دسکتاپ، وب یا سیستمعامل خارج از Android/iOS را ندارند.
// POST /api/campaigns or PATCH /api/campaigns/CMP_ID/targeting?org=ORG_ID
{
"targeting": {
"platforms":["android","ios"],
"formFactors":["tablet"],
"inventoryTypes":["app"]
}
}در ساخت کمپین، targeting میتواند کنار سایر فیلدها بیاید. در ویرایش endpoint مجزا، targeting باید صریحاً وجود داشته باشد؛ برای بازکردن همه محدودیتها targeting:{} بفرستید. فیلد قدیمی device برای کلاینت قبلی باقی است؛ وقتی targeting جدید ارسال میشود، جای آن را میگیرد.
پیشنمایش قوانین؛ بدون رزرو یا هزینه
POST /api/campaigns/CMP_ID/targeting/preview?org=ORG_ID
X-Didnex-CSRF: VALUE_FROM_API_ME
Content-Type: application/json
{"platform":"ios","formFactor":"tablet","inventoryType":"app",
"targeting":{"platforms":["android","ios"],"formFactors":["tablet"],"inventoryTypes":["app"]}}
// {allowed:true, context, reason:'targeting_match', reservationCreated:false, notice}
// Omit targeting to check stored rules.این بررسی فقط تطابق دستگاه را نشان میدهد؛ بودجه، موجودی، زمان، وضعیت تأیید، کشور و سیاست جایگاه همچنان شرط تحویل واقعیاند. فقط سازمان مالک با مجوز ویرایش میتواند قوانین را عوض کند. فیلتر در SQL و پیش از انتخاب نامزد و رزرو موجودی اجرا میشود.
تشخیص دستگاه و سازگاری SDK
وب از Client Hints کمجزئیات و User-Agent استفاده میکند؛ بدنه درخواست نمیتواند device یا formFactor دلخواه را برای وب تحمیل کند. SDK وب برای iPadOS در حالت User-Agent مک، یک راهنمای لمسی محدود میفرستد. نوع دستگاه تشخیصدادهنشده unknown میماند.
در اپ، SDK سیستمعامل و کلاس کلی دستگاه را از محیط اجرا گزارش میکند؛ اتصال مستقیم به سرور ناشر نیاز ندارد و روش سروری اختیاری است. دستگاه ناشناخته unknown میماند. نام مدل، IMEI و شناسه تبلیغاتی برای این فیلتر لازم نیست. کد نصب و Manifest در راهنمای اختصاصی هر SDK قرار دارد تا نمونههای قدیمی در مستندات هدفگیری تکرار نشوند.
راهنمای Flutter · راهنمای Android · همه پلتفرمها و راهنمای اتصال جایگاه
این طبقهبندی برای هدفگیری است و اثبات سختافزار یا ابزار ضدتقلب قطعی نیست؛ داده کلاینت قابل جعل است. محیط app/site از رسانه ثبتشده تعیین میشود. دادههای جدید در ad_requests و پاسخ deviceContext ثبت میشوند. گزارشها byPlatform، byFormFactor و byInventory دارند؛ داده قدیمی که این جزئیات را نداشته unknown میماند.
راهنمای آفلاین حساب و دستگاه