مهاجرت به فایل های داده ساختاریافته v8، مهاجرت به فایل های داده ساختاریافته v8، مهاجرت به فایل های داده ساخت یافته v8

آخرین به روز رسانی: 2024-11-12

این راهنما شما را در فرآیند مهاجرت از استفاده از فایل‌های داده ساختاریافته نسخه ۷.۱ به نسخه ۸ راهنمایی می‌کند و تغییرات بین دو نسخه را که ممکن است بر یکپارچه‌سازی شما تأثیر بگذارد، توضیح می‌دهد.

برای فهرست جامع تفاوت‌های نسخه 7.1 و 8، به یادداشت‌های انتشار مراجعه کنید.

نسخه فایل های داده ساخت یافته خود را مهاجرت کنید

برای انتقال به فایل‌های داده ساختاریافته (SDF) نسخه ۸ از نسخه قبلی:

  1. منابع و اقدامات تولید SDF خود را برای استفاده از v8 به روز کنید.
  2. منطق منبع آگهی را به روز کنید تا پس از ایجاد یک نوع آن را شناسایی کنید.
  3. منطق جدیدی را برای خواندن، ایجاد و به‌روزرسانی منابع تقاضای نسل اضافه کنید.

نسخه فایل های داده ساختاریافته را به روز کنید

برای استفاده از نسخه جدید فایل‌های داده ساختاریافته، نسخه اختصاص داده شده را در منابع شریک و آگهی‌دهنده خود به‌روزرسانی کنید و هنگام ایجاد تکالیف دانلود در Display & Video 360 API از نسخه جدید استفاده کنید.

تنظیمات منبع والد را به روز کنید

نسخه پیش‌فرض Structured Data Files در سطح منبع شریک و تبلیغ‌کننده تنظیم شده است. این نسخه به عنوان پیش‌فرض هنگام دانلود فایل‌های داده ساختاریافته از طریق رابط یا API استفاده می‌شود.

در رابط تنظیم کنید

در سطح شریک

  1. به شریک مورد نظر بروید.
  2. منوی تنظیمات شریک را در ناوبری سمت چپ باز کنید و به صفحه جزئیات اصلی بروید.
  3. پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 8 به روز کنید.

در سطح تبلیغ کننده

  1. به تبلیغ کننده مورد نظر بروید.
  2. منوی تنظیمات آگهی‌دهنده را در پیمایش سمت چپ باز کنید و به صفحه جزئیات اصلی بروید.
  3. پیکربندی نسخه SDF را در بخش فایل های داده ساخت یافته به نسخه 8 به روز کنید. اگر نسخه پیش‌فرض در سطح شریک تنظیم شده باشد، ممکن است این تنظیم قابل ویرایش نباشد.
در API تنظیم کنید
در سطح شریک
نمی‌توانید نسخه پیش‌فرض SDF را در سطح Partner در API تنظیم کنید.
در سطح تبلیغ کننده
یک درخواست advertisers.patch برای به روز رسانی dataAccessConfig.sdfConfig.sdfConfig.version به SDF_VERSION_8 و در صورت نیاز، dataAccessConfig.sdfConfig.overridePartnerSdfConfig را به True انجام دهید.

درخواست‌های sdfdownloadtasks.create در API به‌روزرسانی کنید

هنگام ایجاد یک درخواست sdfdownloadtasks.create با استفاده از Display & Video 360 API، قسمت version بدنه درخواست را روی SDF_VERSION_8 تنظیم کنید.

نوع را در منابع آگهی مشخص کنید

v8 یک ستون Ad Type به فایل‌های Ad اضافه می‌کند، که نوع آگهی نشان‌داده‌شده توسط هر ردیف را نشان می‌دهد. این ستون جدید مورد نیاز است و برای منابع موجود هنگام دانلود فایل‌های تبلیغ v8 پر می‌شود.

هنگام به روز رسانی تبلیغات موجود، مقدار این ستون نباید تغییر کند.

هنگام ایجاد تبلیغات جدید، باید این ستون را با یکی از مقادیر ذکر شده در توضیحات ستون پر کنید.

منطق منابع تقاضای نسل را به روز کنید

v8 از ایجاد، بازیابی و به‌روزرسانی کمپین‌های تقاضای نسل با استفاده از موارد خط ، گروه آگهی و فایل‌های آگهی پشتیبانی می‌کند. منابع تقاضای Gen از منطق متفاوتی برای تأیید مهر زمانی استفاده می‌کنند، به جمعیت ستون‌های اضافی نیاز دارند و با محدودیت‌های جدید در سه نوع فایل محدود می‌شوند.

تأیید مهر زمان

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

برای موارد خط تقاضای نسل، ستون Timestamp و تأیید همراه آن متفاوت عمل می کند. برای ورودی های مورد خط تقاضای Gen، ستون با زمان فعلی در زمان دانلود پر می شود. هنگام آپلود، Display & Video 360 بررسی می‌کند که آیا بیش از 24 ساعت از مهر زمانی داده شده گذشته است یا خیر. اگر بیش از 24 ساعت گذشته باشد، ورودی فایل اصلی قدیمی در نظر گرفته می شود و به روز رسانی انجام نمی شود. اگر این اتفاق افتاد، فایل را دوباره دانلود کنید و به‌روزرسانی‌های خود را بر اساس نسخه جدیدتر انجام دهید. این روش تأیید جدید مانع از بازنویسی تغییرات ایجاد شده در 24 ساعت گذشته نمی شود. برای جلوگیری از رونویسی تصادفی، فقط موارد خط تقاضای نسل تقاضا را که می‌خواهید به‌روزرسانی کنید در فایل‌هایی که آپلود می‌کنید بگنجانید.

ستون های مورد نیاز

انواع فایل‌های زیر دارای ستون‌هایی هستند که اکنون برای منابع خاص تقاضای Gen، علاوه بر ستون‌هایی که برای همه موجودیت‌های آن نوع فایل مورد نیاز هستند، مورد نیاز هستند.

مورد خط
ستون های مورد نیاز برای مقادیر ستون Type آیتم خط زیر
تقاضای ژنرال
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
ستون های مورد نیاز برای مقادیر ستون Ad Type زیر
تقاضای ژنرال چرخ فلک
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
تصویر نسل تقاضا
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
محصول نسل تقاضا
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
ویدیوی نسل تقاضا
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

محدودیت های به روز شده

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

این محدودیت‌ها متعدد و مختص ستون‌های مورد نظر هستند، بنابراین این راهنما فهرست کاملی از محدودیت‌ها ارائه نمی‌کند. توصیه می‌کنیم قبل از ایجاد یا به‌روزرسانی منابع تقاضای نسل با استفاده از آپلود SDF، مستندات مرجع v8 را برای انواع موارد خط ، گروه آگهی ، و انواع فایل آگهی بخوانید.