آخرین به روز رسانی: 2023-10-18
این راهنما شما را در فرآیند مهاجرت به فایل‌های داده ساختاریافته (SDF) نسخه ۷ از نسخه قبلی و تغییرات مورد نیاز و پیشنهادی که می‌توانید برای بهینه‌سازی بهتر یکپارچه‌سازی خود انجام دهید، راهنمایی می‌کند.
برای فهرست جامع تفاوت‌های نسخه ۶ و ۷ به یادداشت‌های انتشار مراجعه کنید.
نسخه فایل های داده ساخت یافته خود را مهاجرت کنید
برای مهاجرت به فایل‌های داده ساختاریافته نسخه ۷ از نسخه قبلی، باید نسخه جدید را مشخص کنید، فضاهای شناسه را برای زیرمجموعه‌ای از ستون‌های موجود به‌روزرسانی کنید، و یکپارچگی با ستون‌های جدید اضافه کنید.
نسخه فایل های داده ساختاریافته را به روز کنید
برای به‌روزرسانی به نسخه جدید فایل‌های داده ساختاریافته، باید نسخه‌ای را که به منابع شریک و آگهی‌دهنده والدین خود اختصاص می‌دهید و وظایف بارگیری فردی خود در Display & Video 360 API به‌روزرسانی کنید.
تنظیمات منبع والد را به روز کنید
نسخه پیش‌فرض Structured Data Files در سطح منبع شریک و تبلیغ‌کننده تنظیم شده است. این نسخه به عنوان پیش‌فرض هنگام دانلود فایل‌های داده ساختاریافته از طریق رابط یا API استفاده می‌شود.
در رابط تنظیم کنید
- در سطح شریک
- به شریک مورد نظر بروید. به صفحه جزئیات اولیه در منوی تنظیمات شریک در ناوبری سمت چپ بروید. پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 7 به روز کنید.
- در سطح تبلیغ کننده
- به تبلیغ کننده مورد نظر بروید. به صفحه جزئیات اولیه در منوی تنظیمات آگهی‌دهنده در ناوبری سمت چپ بروید. پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 7 به روز کنید. اگر نسخه پیش‌فرض در سطح شریک تنظیم شده باشد، ممکن است این تنظیم قابل ویرایش نباشد.
در API تنظیم کنید
- در سطح تبلیغ کننده
- یک درخواست
advertisers.patchبرای به روز رسانیdataAccessConfig.sdfConfig.sdfConfig.versionبهSDF_VERSION_7و در صورت نیازdataAccessConfig.sdfConfig.overridePartnerSdfConfigرا بهTrueارائه دهید.
درخواست‌های sdfdownloadtasks.create را در API به‌روزرسانی کنید
هنگام ایجاد یک درخواست sdfdownloadtasks.create با استفاده از Display & Video 360 API، قسمت version بدنه درخواست را روی SDF_VERSION_7 تنظیم کنید.
شناسه ها را در ستون های مورد نیاز به روز کنید
در نسخه 7، فضاهای شناسه استفاده شده توسط زیرمجموعه‌ای از ستون‌ها برای جدا کردن فایل‌های داده ساختاریافته از محصول منسوخ شده Entity Read Files و تراز کردن بیشتر با ابزارهای پشتیبانی‌شده، مانند Display & Video 360 API به‌روزرسانی شده‌اند.
این بخش هر ستون را با استفاده از شناسه های متفاوت از v6 و دستورالعمل هایی در مورد نحوه بازیابی اطلاعات مرجع در مقادیر جدید فهرست می کند.
سفارش درج
| v7 دستورالعمل های مهاجرت برای ستون ها | |
|---|---|
هدف گذاری برنامه - حذف شود هدف گذاری برنامه - شامل | این ستون‌ها برای استفاده از شناسه‌های برنامه با فرمت « پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple. |
هدف گذاری مرورگر - حذف شود هدف گذاری مرورگر - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری حامل - حذف شود هدف گذاری حامل - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری کانال - حذف شود هدف گذاری کانال - شامل | این ستون برای استفاده از مقدار منابع |
هدف گذاری دستگاه - حذف شود هدف گذاری دستگاه - شامل | این ستون برای استفاده از مقادیر
با استفاده از سرویس |
| کانال DAR را اندازه گیری کنید | این ستون برای استفاده از مقدار منابع |
هدف گذاری سایت - حذف شود هدف گذاری سایت - شامل | این ستون برای شناسایی سایت ها از طریق رشته های URL به روز شده است. |
مورد خط
| v7 دستورالعمل های مهاجرت برای ستون ها | |
|---|---|
هدف گذاری برنامه - حذف شود هدف گذاری برنامه - شامل | این ستون‌ها برای استفاده از شناسه‌های برنامه با فرمت « پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple. |
| ضریب های پیشنهادی | این ستون برای استفاده از شناسه‌های معیار جدید برای انواع ردیف‌های برنامه و سایت به‌روزرسانی شده است. نوع ردیف برنامه به‌روزرسانی شده است تا از مقادیر رشته پیوسته پلتفرم برنامه و شناسه پلتفرم برنامه، که با دو نقطه از هم جدا شده‌اند، برای شناسه‌های معیار استفاده کند. پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple. نوع ردیف سایت برای استفاده از رشته های URL به عنوان شناسه معیار به روز شده است. |
هدف گذاری مرورگر - حذف شود هدف گذاری مرورگر - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری حامل - حذف شود هدف گذاری حامل - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری کانال - حذف شود هدف گذاری کانال - شامل | این ستون برای استفاده از مقدار منابع |
هدف گذاری دستگاه - حذف شود هدف گذاری دستگاه - شامل | این ستون برای استفاده از مقادیر
با استفاده از سرویس |
هدف گذاری سایت - حذف شود هدف گذاری سایت - شامل | این ستون برای شناسایی سایت ها از طریق رشته های URL به روز شده است. |
محصول رسانه ای
| v7 دستورالعمل های مهاجرت برای ستون ها | |
|---|---|
هدف گذاری کانال - حذف شود هدف گذاری کانال - شامل | این ستون برای استفاده از مقدار منابع |
| هدف گذاری دستگاه - شامل | این ستون برای استفاده از مقادیر
با استفاده از سرویس |
اضافه کردن یکپارچه سازی با ستون های اضافه شده از نسخه 6
در صورت مهاجرت از v6 به v7، باید ستون های زیر را به فایل های مربوطه اضافه کنید:
| نوع فایل | ستون |
|---|---|
| مورد خط | تعداد فرکانس هدف TrueView |
| مورد خط | پنجره زمان فرکانس هدف TrueView |
| گروه تبلیغات YouTube | هدف گذاری بهینه |
اگر از نسخه قبلی فایل‌های داده ساختاریافته مهاجرت می‌کنید، برای اطلاعات در مورد ستون‌های اضافی اضافه شده بین نسخه فعلی و SDF نسخه ۶، به یادداشت‌های انتشار فایل‌های داده ساختاریافته مراجعه کنید.
تغییرات اضافی
در نسخه 7، ما همچنین برخی تغییرات سطحی را ایجاد کرده ایم که به شما کمک می کند ادغام خود را ساده کنید و از استفاده از Entity Read Files منسوخ شده برای مرجع دور شوید.
فهرست جدید برای چند ستون مرتب می شود
SDF v7 ترتیب ثابتی از ستون های لیست خاص را پس از تولید فایل تضمین می کند. این منجر به رفتار منسجم تر و بررسی آسان تر می شود. این سفارش هنگام آپلود فایل اجرا نمی شود، اما پس از آن هنگام تولید فایل به روز شده اعمال می شود.
یادداشت‌های انتشار v7 را برای فهرست کاملی از ستون‌هایی که اکنون به ترتیب عددی یا حروف الفبای صعودی ایجاد می‌شوند، مرور کنید.
توصیه های مرجع شناسه جدید
ما تعاریف تعدادی از ستون‌ها را به‌روزرسانی کرده‌ایم تا ارجاع به فایل‌های خوانده شده موجودیت منسوخ را حذف کنیم و در عوض روش‌های دیگر جستجوی شناسه را توصیه کنیم.
مقادیر بازگردانده شده توسط ستون‌های زیر هیچ تفاوتی با SDF v6 ندارند، اما پیشنهاد می‌کنیم ادغام خود را برای بازیابی شناسه‌ها با استفاده از روش توصیه‌شده جدید، که در توضیحات ستون v7 آنها یافت می‌شود، به‌روزرسانی کنید.
| انواع فایل ها و ستون های آنها | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| پویش |
| |||||||||||||||||||||
| سفارش درج |
| |||||||||||||||||||||
| مورد خط |
| |||||||||||||||||||||
| محصول رسانه ای |
| |||||||||||||||||||||
| گروه تبلیغات YouTube |
| |||||||||||||||||||||
آخرین به روز رسانی: 2023-10-18
این راهنما شما را در فرآیند مهاجرت به فایل‌های داده ساخت‌یافته (SDF) نسخه ۷ از نسخه قبلی و تغییرات مورد نیاز و پیشنهادی که می‌توانید برای بهینه‌سازی بهتر یکپارچه‌سازی خود انجام دهید، راهنمایی می‌کند.
برای فهرست جامع تفاوت‌های نسخه ۶ و ۷ به یادداشت‌های انتشار مراجعه کنید.
نسخه فایل های داده ساخت یافته خود را مهاجرت کنید
مهاجرت به فایل‌های داده ساختاریافته نسخه ۷ از نسخه قبلی، مستلزم آن است که نسخه جدید را مشخص کنید، فضاهای شناسه را برای زیرمجموعه‌ای از ستون‌های موجود به‌روزرسانی کنید، و یکپارچگی با ستون‌های جدید اضافه کنید.
نسخه فایل های داده ساختاریافته را به روز کنید
برای به‌روزرسانی به نسخه جدید فایل‌های داده ساختاریافته، باید نسخه‌ای را که به منابع شریک و آگهی‌دهنده والدین خود اختصاص می‌دهید و وظایف بارگیری فردی خود در Display & Video 360 API به‌روزرسانی کنید.
تنظیمات منبع والد را به روز کنید
نسخه پیش‌فرض Structured Data Files در سطح منبع شریک و تبلیغ‌کننده تنظیم شده است. این نسخه به عنوان پیش‌فرض هنگام دانلود فایل‌های داده ساختاریافته از طریق رابط یا API استفاده می‌شود.
در رابط تنظیم کنید
- در سطح شریک
- به شریک مورد نظر بروید. به صفحه جزئیات اولیه در منوی تنظیمات شریک در ناوبری سمت چپ بروید. پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 7 به روز کنید.
- در سطح تبلیغ کننده
- به تبلیغ کننده مورد نظر بروید. به صفحه جزئیات اولیه در منوی تنظیمات آگهی‌دهنده در ناوبری سمت چپ بروید. پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 7 به روز کنید. اگر نسخه پیش‌فرض در سطح شریک تنظیم شده باشد، ممکن است این تنظیم قابل ویرایش نباشد.
در API تنظیم کنید
- در سطح تبلیغ کننده
- یک درخواست
advertisers.patchبرای به روز رسانیdataAccessConfig.sdfConfig.sdfConfig.versionبهSDF_VERSION_7و در صورت نیازdataAccessConfig.sdfConfig.overridePartnerSdfConfigرا بهTrueارائه دهید.
درخواست‌های sdfdownloadtasks.create را در API به‌روزرسانی کنید
هنگام ایجاد یک درخواست sdfdownloadtasks.create با استفاده از Display & Video 360 API، قسمت version بدنه درخواست را روی SDF_VERSION_7 تنظیم کنید.
شناسه ها را در ستون های مورد نیاز به روز کنید
در نسخه 7، فضاهای شناسه استفاده شده توسط زیرمجموعه‌ای از ستون‌ها برای جدا کردن فایل‌های داده ساختاریافته از محصول منسوخ شده Entity Read Files و تراز کردن بیشتر با ابزارهای پشتیبانی‌شده، مانند Display & Video 360 API به‌روزرسانی شده‌اند.
این بخش هر ستون را با استفاده از شناسه های متفاوت از v6 و دستورالعمل هایی در مورد نحوه بازیابی اطلاعات مرجع در مقادیر جدید فهرست می کند.
سفارش درج
| v7 دستورالعمل های مهاجرت برای ستون ها | |
|---|---|
هدف گذاری برنامه - حذف شود هدف گذاری برنامه - شامل | این ستون‌ها برای استفاده از شناسه‌های برنامه با فرمت « پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple. |
هدف گذاری مرورگر - حذف شود هدف گذاری مرورگر - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری حامل - حذف شود هدف گذاری حامل - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری کانال - حذف شود هدف گذاری کانال - شامل | این ستون برای استفاده از مقدار منابع |
هدف گذاری دستگاه - حذف شود هدف گذاری دستگاه - شامل | این ستون برای استفاده از مقادیر
با استفاده از سرویس |
| کانال DAR را اندازه گیری کنید | این ستون برای استفاده از مقدار منابع |
هدف گذاری سایت - حذف شود هدف گذاری سایت - شامل | این ستون برای شناسایی سایت ها از طریق رشته های URL به روز شده است. |
مورد خط
| v7 دستورالعمل های مهاجرت برای ستون ها | |
|---|---|
هدف گذاری برنامه - حذف شود هدف گذاری برنامه - شامل | این ستون‌ها برای استفاده از شناسه‌های برنامه با فرمت « پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple. |
| ضریب های پیشنهادی | این ستون برای استفاده از شناسه‌های معیار جدید برای انواع ردیف‌های برنامه و سایت به‌روزرسانی شده است. نوع ردیف برنامه برای استفاده از مقادیر رشته پیوسته پلتفرم برنامه و شناسه پلتفرم برنامه که با دو نقطه از هم جدا شده اند، برای شناسه های معیار به روز شده است. پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple. نوع ردیف سایت برای استفاده از رشته های URL به عنوان شناسه معیار به روز شده است. |
هدف گذاری مرورگر - حذف شود هدف گذاری مرورگر - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری حامل - حذف شود هدف گذاری حامل - شامل | این ستون برای استفاده از مقادیر با استفاده از سرویس |
هدف گذاری کانال - حذف شود هدف گذاری کانال - شامل | این ستون برای استفاده از مقدار منابع |
هدف گذاری دستگاه - حذف شود هدف گذاری دستگاه - شامل | این ستون برای استفاده از مقادیر
با استفاده از سرویس |
هدف گذاری سایت - حذف شود هدف گذاری سایت - شامل | این ستون برای شناسایی سایت ها از طریق رشته های URL به روز شده است. |
محصول رسانه ای
| v7 دستورالعمل های مهاجرت برای ستون ها | |
|---|---|
هدف گذاری کانال - حذف شود هدف گذاری کانال - شامل | این ستون برای استفاده از مقدار منابع |
| هدف گذاری دستگاه - شامل | این ستون برای استفاده از مقادیر
با استفاده از سرویس |
اضافه کردن یکپارچه سازی با ستون های اضافه شده از نسخه 6
اگر از v6 به v7 مهاجرت می کنید، باید ستون های زیر را به فایل های مربوطه اضافه کنید:
| نوع فایل | ستون |
|---|---|
| مورد خط | تعداد فرکانس هدف TrueView |
| مورد خط | پنجره زمان فرکانس هدف TrueView |
| گروه تبلیغات YouTube | هدف گذاری بهینه |
اگر از نسخه قبلی فایل‌های داده ساختاریافته مهاجرت می‌کنید، برای اطلاعات در مورد ستون‌های اضافی اضافه شده بین نسخه فعلی و SDF نسخه ۶، به یادداشت‌های انتشار فایل‌های داده ساختاریافته مراجعه کنید.
تغییرات اضافی
در نسخه 7، ما همچنین برخی تغییرات سطحی را ایجاد کرده ایم که به شما کمک می کند ادغام خود را ساده کنید و از استفاده از Entity Read Files منسوخ شده برای مرجع دور شوید.
فهرست جدید برای چند ستون مرتب می شود
SDF v7 ترتیب ثابتی از ستون های لیست خاص را پس از تولید فایل تضمین می کند. این منجر به رفتار منسجم تر و بررسی آسان تر می شود. این سفارش هنگام آپلود فایل اجرا نمی شود، اما پس از آن هنگام تولید فایل به روز شده اعمال می شود.
یادداشت‌های انتشار v7 را برای فهرست کاملی از ستون‌هایی که اکنون به ترتیب عددی یا حروف الفبای صعودی ایجاد می‌شوند، مرور کنید.
توصیه های مرجع شناسه جدید
ما تعاریف تعدادی از ستون‌ها را به‌روزرسانی کرده‌ایم تا ارجاع به فایل‌های خوانده شده موجودیت منسوخ را حذف کنیم و در عوض روش‌های دیگر جستجوی شناسه را توصیه کنیم.
مقادیر بازگردانده شده توسط ستون‌های زیر هیچ تفاوتی با SDF v6 ندارند، اما پیشنهاد می‌کنیم ادغام خود را برای بازیابی شناسه‌ها با استفاده از روش توصیه‌شده جدید، که در توضیحات ستون v7 آنها یافت می‌شود، به‌روزرسانی کنید.
| انواع فایل ها و ستون های آنها | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| پویش |
| |||||||||||||||||||||
| سفارش درج |
| |||||||||||||||||||||
| مورد خط |
| |||||||||||||||||||||
| محصول رسانه ای |
| |||||||||||||||||||||
| گروه تبلیغات YouTube |
| |||||||||||||||||||||