فایلهای داده ساختاریافته (SDF) فایلهای CSV با فرمت خاص هستند. آنها امکان بازیابی، ایجاد و ویرایش انبوه منابع را در Display & Video 360 فراهم میکنند. با دانلود، ویرایش و سپس آپلود مجدد SDFها، بهروزرسانیهای عمدهای روی منابع انجام دهید.
رابط کاربری Display & Video 360 از دانلود و آپلود SDF پشتیبانی میکند. رابط برنامهنویسی کاربردی Display & Video 360 از دانلودهای SDF پشتیبانی میکند.
قالبها
یک SDF از یکی از دو قالب پایه، استاندارد و QA ، استفاده میکند:
- شما میتوانید فایلهای با فرمت استاندارد را دانلود و آپلود کنید. دادههای موجود در این فایلها ممکن است از شناسههای عددی برای اطمینان از دقت در هنگام آپلود استفاده کنند. ممکن است برای تفسیر دادهها به اطلاعات مرجع نیاز باشد.
- شما میتوانید فایلهای فرمت QA را دانلود کنید. این فایلها دادههای مشابه فایلهای فرمت استاندارد را ارائه میدهند، اما از مقادیر خواناتر برای انسان استفاده میکنند. برای مثال، برخی از ستونها ممکن است از نامهای نمایشی به جای شناسهها استفاده کنند. ستونهای مختص این فرمت از پسوند "Qa" استفاده میکنند.
انواع فایل
SDF از هفت نوع منبع پشتیبانی میکند. هر نوع منبع، نوع فایل و ساختار ستونی خاص خود را دارد. انواع منابع پشتیبانی شده عبارتند از:
- کمپین
- سفارش درج
- مورد خط
- گروه تبلیغاتی
- آگهی
- منبع موجودی
- محصول رسانهای
فقط انواع فایلهای Line Item و Ad Group از فرمت QA پشتیبانی میکنند.
نسخههای جدید SDF مرتباً منتشر میشوند و نسخههای قبلی منسوخ میشوند . نسخههای جدید، ساختار ستون نوع فایل را بهروزرسانی میکنند. در صورت لزوم، نسخه جدید SDF در زمان راهاندازی شامل یک راهنمای مهاجرت خواهد بود.
خطاهای دانلود
دانلودهای SDF میتوانند منجر به دو نوع خطا شوند: خطاهای ایجاد فایل و منابع از دست رفته .
خطاهای تولید فایل
تولید SDF میتواند به دلیل خطا خاتمه یابد. اگر تولید هنگام استفاده از Display & Video 360 API با شکست مواجه شود، وظیفه پایان یافته فیلد error خود را با شیء Status تنظیم میکند. شیء Status حاوی پیامی خواهد بود که علت خطا را شرح میدهد.
برای اطلاعات بیشتر در مورد این خطاها، به صفحه راهنمای خطاها و هشدارهای ما مراجعه کنید.
خطاهای نادیده گرفته شده
SDFها از همه زیرنوعهای منابع پشتیبانی نمیکنند. اگر منبعی نتواند در SDF گنجانده شود، یک فایل "Skipped" (مثال: SDF-LineItems-Skipped.csv ) در دانلود گنجانده خواهد شد. این فایل دارای ساختار دو ستونی است. ستون اول منبع نادیده گرفته شده را مشخص میکند. ستون دوم نحوه حذف آنها را توضیح میدهد.
آپلود فایل
با استفاده از رابط کاربری Display & Video 360، فایلهای SDF را آپلود کنید تا منابع جدید ایجاد یا منابع موجود بهروزرسانی شوند.
برای به حداقل رساندن خطاها هنگام بهروزرسانی یا ایجاد منابع با SDFها، این مراحل را دنبال کنید:
- SDF ها را با استفاده از رابط کاربری یا رابط کاربری Display & Video 360 دانلود کنید.
- ورودیهای فایل موجود را تغییر دهید تا بهروزرسانیهایی در منابع موجود ایجاد شود.
- برای ایجاد منابع جدید، ورودیهای فایل را اضافه کنید.
- هر ورودی که جدید یا بهروزرسانی نشده است را حذف کنید. این کار حجم فایل را کاهش میدهد و احتمال بهروزرسانیهای ناخواسته را از بین میبرد.
- فایل را در رابط کاربری Display & Video 360 بارگذاری کنید.
پس از آپلود و پردازش SDF، یک فایل SDF-ResultFile.zip برای دانلود در دسترس است. این فایل ZIP میتواند شامل دو فایل زیر باشد:
-
SDF-{ResourceType}-Updated-ResultFile.csvکه منابع با موفقیت بهروزرسانی یا ایجاد شده را فهرست میکند. -
SDF-{ResourceType}-Failed-ResultFile.csvکه عملیات ناموفق و پیامهای خطای مربوطه را فهرست میکند.
فایل ZIP میتواند شامل یک یا هر دو فایل باشد.