مهاجرت به فایل های داده ساختاریافته نسخه 7

آخرین به روز رسانی: 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 دستورالعمل های مهاجرت برای ستون ها

هدف گذاری برنامه - حذف شود

هدف گذاری برنامه - شامل

این ستون‌ها برای استفاده از شناسه‌های برنامه با فرمت « App Platform:App ID » به‌روزرسانی شده‌اند. مثال‌ها عبارتند از: " APP:com.google.android.gm "، " APP:422689480 "، " ANDROID_TV_APP:com.google.android.youtube.tvunplugged "

پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple.

هدف گذاری مرورگر - حذف شود

هدف گذاری مرورگر - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع TargetingOption API Display & Video 360 تحت نوع هدف گیری TARGETING_TYPE_BROWSER به روز شده است.

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

هدف گذاری حامل - حذف شود

هدف گذاری حامل - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع TargetingOption API Display & Video 360 تحت نوع هدف گیری TARGETING_TYPE_CARRIER_AND_ISP به روز شده است.

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

هدف گذاری کانال - حذف شود

هدف گذاری کانال - شامل

این ستون برای استفاده از مقدار channelId منبع Channel Display & Video 360 API به روز شده است.

منابع Channel را به صورت جداگانه یا در لیست های صفحه بندی شده با استفاده از سرویس های advertisers.channels و partners.channels بازیابی کنید.

هدف گذاری دستگاه - حذف شود

هدف گذاری دستگاه - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع Display & Video 360 API TargetingOption تحت انواع هدف گذاری زیر به روز شده است:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

کانال DAR را اندازه گیری کنید

این ستون برای استفاده از مقدار channelId منبع Channel Display & Video 360 API به روز شده است.

منابع Channel را به صورت جداگانه یا در لیست های صفحه بندی شده با استفاده از سرویس های advertisers.channels و partners.channels بازیابی کنید.

هدف گذاری سایت - حذف شود

هدف گذاری سایت - شامل

این ستون برای شناسایی سایت ها از طریق رشته های URL به روز شده است.

مورد خط

v7 دستورالعمل های مهاجرت برای ستون ها

هدف گذاری برنامه - حذف شود

هدف گذاری برنامه - شامل

این ستون‌ها برای استفاده از شناسه‌های برنامه با فرمت « App Platform:App ID » به‌روزرسانی شده‌اند. مثال‌ها عبارتند از: " APP:com.google.android.gm "، " APP:422689480 "، " ANDROID_TV_APP:com.google.android.youtube.tvunplugged "

پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple.

ضریب های پیشنهادی

این ستون برای استفاده از شناسه‌های معیار جدید برای انواع ردیف‌های برنامه و سایت به‌روزرسانی شده است.

نوع ردیف برنامه به‌روزرسانی شده است تا از مقادیر رشته پیوسته پلتفرم برنامه و شناسه پلتفرم برنامه، که با دو نقطه از هم جدا شده‌اند، برای شناسه‌های معیار استفاده کند. پلتفرم های برنامه با یک مقدار رشته شناسایی می شوند. شناسه‌های برنامه، شناسه‌هایی هستند که توسط پلتفرم مربوطه ارائه می‌شوند، مانند یک شناسه بسته از فروشگاه Play Android یا شناسه برنامه از فروشگاه App Apple.

نوع ردیف سایت برای استفاده از رشته های URL به عنوان شناسه معیار به روز شده است.

هدف گذاری مرورگر - حذف شود

هدف گذاری مرورگر - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع TargetingOption API Display & Video 360 تحت نوع هدف گیری TARGETING_TYPE_BROWSER به روز شده است.

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

هدف گذاری حامل - حذف شود

هدف گذاری حامل - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع TargetingOption API Display & Video 360 تحت نوع هدف گیری TARGETING_TYPE_CARRIER_AND_ISP به روز شده است.

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

هدف گذاری کانال - حذف شود

هدف گذاری کانال - شامل

این ستون برای استفاده از مقدار channelId منبع Channel Display & Video 360 API به روز شده است.

منابع Channel را به صورت جداگانه یا در لیست های صفحه بندی شده با استفاده از سرویس های advertisers.channels و partners.channels بازیابی کنید.

هدف گذاری دستگاه - حذف شود

هدف گذاری دستگاه - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع Display & Video 360 API TargetingOption تحت انواع هدف گذاری زیر به روز شده است:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

هدف گذاری سایت - حذف شود

هدف گذاری سایت - شامل

این ستون برای شناسایی سایت ها از طریق رشته های URL به روز شده است.

محصول رسانه ای

v7 دستورالعمل های مهاجرت برای ستون ها

هدف گذاری کانال - حذف شود

هدف گذاری کانال - شامل

این ستون برای استفاده از مقدار channelId منبع Channel Display & Video 360 API به روز شده است.

منابع Channel را به صورت جداگانه یا در لیست های صفحه بندی شده با استفاده از سرویس های advertisers.channels و partners.channels بازیابی کنید.

هدف گذاری دستگاه - شامل

این ستون برای استفاده از مقادیر targetingOptionId منابع Display & Video 360 API TargetingOption تحت انواع هدف گذاری زیر به روز شده است:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

با استفاده از سرویس targetingTypes.targetingOptions منابع TargetingOption را به صورت جداگانه یا در لیست های صفحه بندی شده بازیابی کنید.

اضافه کردن یکپارچه سازی با ستون های اضافه شده از نسخه 6

در صورت مهاجرت از v6 به v7، باید ستون های زیر را به فایل های مربوطه اضافه کنید:

نوع فایل ستون
مورد خط تعداد فرکانس هدف TrueView
مورد خط پنجره زمان فرکانس هدف TrueView
گروه تبلیغات YouTube هدف گذاری بهینه

اگر از نسخه قبلی فایل‌های داده ساختاریافته مهاجرت می‌کنید، به یادداشت‌های انتشار فایل‌های داده ساختاریافته برای اطلاعات در مورد ستون‌های اضافی اضافه شده بین نسخه فعلی و SDF نسخه ۶ مراجعه کنید.

تغییرات اضافی

در نسخه 7، ما همچنین برخی تغییرات سطحی را ایجاد کرده ایم که به شما کمک می کند ادغام خود را ساده کنید و از استفاده از Entity Read Files منسوخ شده برای مرجع دور شوید.

ترتیب فهرست جدید برای زیر مجموعه ای از ستون ها

SDF v7 ترتیب ثابتی از ستون های لیست خاص را پس از تولید فایل تضمین می کند. این منجر به رفتار منسجم تر و بررسی آسان تر می شود. این سفارش هنگام آپلود فایل اجرا نمی شود، اما پس از آن هنگام تولید فایل به روز شده اعمال می شود.

یادداشت‌های انتشار v7 را برای فهرست کاملی از ستون‌هایی که اکنون به ترتیب عددی یا حروف الفبای صعودی ایجاد می‌شوند، مرور کنید.

توصیه های مرجع شناسه جدید

ما تعاریف تعدادی از ستون‌ها را به‌روزرسانی کرده‌ایم تا ارجاع به فایل‌های خوانده شده موجودیت منسوخ را حذف کنیم و در عوض روش‌های دیگر جستجوی شناسه را توصیه کنیم.

مقادیر بازگردانده شده توسط ستون‌های زیر هیچ تفاوتی با SDF v6 ندارند، اما پیشنهاد می‌کنیم ادغام خود را برای بازیابی شناسه‌ها با استفاده از روش توصیه‌شده جدید، که در توضیحات ستون v7 آن‌ها یافت می‌شود، به‌روزرسانی کنید.

انواع فایل ها و ستون های آنها
پویش
هدف گذاری جغرافیایی - استثناء
هدف گذاری جغرافیایی - شامل
هدف گذاری منبع موجودی - استثناء
هدف گذاری منبع موجودی - شامل
هدف گذاری زبان - حذف شود
هدف گذاری زبان - شامل
سفارش درج
Affinity & In Market Targeting - استثناء
Affinity & In Market Targeting - شامل
هدف گذاری مجموعه برنامه - حذف شود
هدف گذاری مجموعه برنامه - شامل
هدف گذاری مخاطب - حذف شود
هدف گذاری مخاطب - شامل
هدف گذاری دسته - استثناء
هدف گذاری دسته - شامل
هدف گذاری ژانر محتوا - حذف شود
هدف ژانر محتوا - شامل
لیست هدف گذاری سفارشی
هدف گذاری جغرافیایی - حذف شود
هدف گذاری جغرافیایی - شامل
هدف گذاری منبع موجودی - استثناء
هدف گذاری منبع موجودی - شامل
فهرست کلیدواژه هدف گذاری - حذف
هدف گذاری زبان - حذف شود
هدف گذاری زبان - شامل
مورد خط
Affinity & In Market Targeting - استثناء
Affinity & In Market Targeting - شامل
هدف گذاری مجموعه برنامه - حذف شود
هدف گذاری مجموعه برنامه - شامل
هدف گذاری مخاطب - حذف شود
هدف گذاری مخاطب - شامل
هدف گذاری دسته - استثناء
هدف گذاری دسته - شامل
هدف گذاری ترکیبی مخاطب
هدف گذاری ژانر محتوا - حذف شود
هدف ژانر محتوا - شامل
شناسه‌های فعالیت Floodlight تبدیل
تکالیف خلاقانه
لیست هدف گذاری سفارشی
هدف گذاری جغرافیایی - حذف شود
هدف گذاری جغرافیایی - شامل
هدف گذاری منبع موجودی - استثناء
هدف گذاری منبع موجودی - شامل
فهرست کلیدواژه هدف گذاری - حذف
هدف گذاری زبان - حذف شود
هدف گذاری زبان - شامل
محصول رسانه ای
هدف گذاری مخاطب - حذف شود
هدف گذاری مخاطب - شامل
هدف گذاری دسته - استثناء
هدف گذاری دسته - شامل
هدف گذاری جغرافیایی - شامل
هدف گذاری زبان - حذف شود
هدف گذاری زبان - شامل
گروه تبلیغات YouTube
Affinity & In Market Targeting - استثناء
Affinity & In Market Targeting - شامل
هدف گذاری مخاطب - حذف شود
هدف گذاری مخاطب - شامل
هدف گذاری دسته - استثناء
هدف گذاری دسته - شامل
لیست هدف گذاری سفارشی