آپلود فایل داده ساختاریافته جزئی (SDF)

آپلود فایل داده ساختاریافته جزئی (SDF) به کاربران Display & Video 360 اجازه می‌دهد تا زیرمجموعه‌ای از پیکربندی‌های منابع را برای آیتم‌های خطی موجود به صورت عمده با استفاده از فایل‌های داده ساختاریافته به‌روزرسانی کنند، با ستون‌های کمتر از آنچه که معمولاً توسط فرمت فایل آیتم خطی مورد نیاز است.

با نیاز به ستون‌های کمتر، Partial SDF Upload مزایای زیر را ارائه می‌دهد:

  • به شما امکان می‌دهد تعداد بیشتری از منابع را در یک فایل آپلود شده قرار دهید.
  • مدیریت دستی SDFها را آسان‌تر می‌کند.
  • دیگر نیازی نیست که یک SDF آپلود شده از یک فایل قبلاً دانلود شده ایجاد شود.
  • زمان بین آپلود اولیه فایل و انتشار به‌روزرسانی‌ها را کاهش می‌دهد.

SDF جزئی فقط برای SDF های آیتم خطی پشتیبانی می‌شود.

نحوه استفاده از آپلود جزئی SDF

برای ساخت و آپلود یک SDF جزئی، این مراحل را دنبال کنید:

  1. تصمیم بگیرید که می‌خواهید کدام آیتم‌ها و تنظیمات خط را به‌روزرسانی کنید.

    • با استفاده از ستون Line Item Id ردیف‌ها را شناسایی کنید. این ستون در هر SDF جزئی (Partial SDF) ضروری است و باید در هر ورودی فایل پر شود.
    • ستون‌هایی را که می‌خواهید به‌روزرسانی کنید از بخش گروه‌های ستون موجود انتخاب کنید.

      • برای به‌روزرسانی هر ستون در یک گروه ستون، تمام ستون‌های آن گروه باید در فایل موجود باشند.
      • یک فایل می‌تواند شامل چندین گروه ستون باشد.
      • فایل‌هایی که گروه‌های ستون ناقصی دارند یا ستون‌هایی که به‌طور خاص توسط Partial SDF Upload پشتیبانی نمی‌شوند، منجر به خطا می‌شوند.
  2. فایل را به یکی از روش‌های زیر بسازید:

    • از یک SDF موجود استفاده کنید.

      • یک SDF مربوط به آیتم‌های خطی که شامل آیتم‌های خطی مربوطه است را دانلود کنید، همانطور که هنگام مدیریت و آپلود یک SDF استاندارد انجام می‌دهید.
      • یک SDF اولیه حاوی تمام موارد خط انتخاب شده را دانلود کنید.
      • تمام ستون‌هایی که در گروه‌های ستونی Partial SDF مربوطه نیستند را حذف کنید.
      • تمام ورودی‌های آیتم‌های خطی را که نمی‌خواهید به‌روزرسانی کنید، حذف کنید.
    • یک فایل CSV جدید بسازید.

      • یک فایل CSV بسازید و فقط سرصفحه‌های مربوط به ستون‌های گروه‌های ستونی Partial SDF مربوطه را در آن قرار دهید.
      • برای هر شناسه‌ی آیتم خطی که به‌روزرسانی خواهد شد، یک ورودی به فایل اضافه کنید.
  3. SDF جزئی جدید را پر کنید.

    • اگر از فایل دانلود شده استفاده می‌کنید، مقادیر موجود را برای هر ورودی سطر به‌روزرسانی کنید. مقادیری که قرار نیست به‌روزرسانی شوند، نیازی به تغییر ندارند. SDF جزئی از ستون Timestamp پشتیبانی نمی‌کند. هرگونه تغییری که بین دانلود فایل و آپلود SDF جزئی در یک سطر ایجاد شود، در صورت وجود ستون مربوطه، بازنویسی خواهد شد.
    • اگر از یک فایل CSV جدید استفاده می‌کنید، تمام ستون‌های موجود برای هر ورودی سطر را پر کنید. می‌توانید مقدار یک ستون را عمداً خالی بگذارید، اما پس از آپلود، آن مقدار خالی به عنوان مقدار جدید برای تنظیمات آن سطر ذخیره می‌شود.
  4. فایل را با استفاده از فرآیند استاندارد آپلود SDF، در رابط کاربری Display & Video 360 آپلود کنید. برای شناسایی آن به عنوان یک Partial SDF، نیازی به تنظیمات اضافی نیست. هنگامی که فایل آپلود شده پردازش می‌شود، فایل‌های نتیجه در صفحه وضعیت انبوه در دسترس خواهند بود که نشان می‌دهد کدام آیتم‌های خط با موفقیت به‌روزرسانی شده‌اند و کدام‌ها به‌روزرسانی نشده‌اند. برخلاف آپلود SDF استاندارد، ایمیل‌هایی با فایل‌های نتیجه پس از آپلود و پردازش Partial SDFها ارسال نمی‌شوند.

فایل‌های نمونه

ما سه فایل نمونه ارائه داده‌ایم که می‌توانید برای ساخت Partial SDF خود از آنها استفاده کنید. هر نمونه از ترکیب متفاوتی از گروه‌های ستون استفاده می‌کند. هر کدام شامل یک ردیف هدر است که ستون‌های مربوطه را مشخص می‌کند و سه ردیف که باید قبل از آپلود با داده‌های مورد نظر به‌روزرسانی شوند.

یکی از فایل‌های CSV زیر را به همراه گروه‌های ستون مشخص شده دانلود کنید تا به عنوان الگو استفاده شود:

گروه‌های ستون موجود

گروه‌های ستونی زیر برای SDFهای جزئی موجود است. هر گروه شامل یک یا چند ستون از قالب فایل SDF Line Item است. اگر یک گروه ستون بیش از یک ستون داشته باشد، تمام ستون‌های آن گروه باید در فایل آپلود شده گنجانده شوند.

شناسه خط مورد

ستون‌های شامل:

  • Line Item ID

نام

ستون‌های شامل:

  • Name

وضعیت

ستون‌های شامل:

  • Status

زمینه‌های پرواز

ستون‌های شامل:

  • Start Date
  • End Date

فیلدهای بودجه و سرعت

ستون‌های شامل:

  • Budget Type
  • Budget Amount
  • Pacing
  • Pacing Rate
  • Pacing Amount

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

ستون‌های شامل شده برای همه انواع آیتم‌های خطی:

  • Frequency Enabled
  • Frequency Exposures
  • Frequency Period
  • Frequency Amount

ستون‌های اضافی، در صورت وجود آیتم‌های خط TrueView الزامی هستند:

  • TrueView View Frequency Enabled
  • TrueView View Frequency Exposures
  • TrueView View Frequency Period

فیلدهای مدل درآمد شریک

ستون‌های شامل:

  • Partner Revenue Model
  • Partner Revenue Amount

فیلدهای ردیابی تبدیل

ستون‌های شامل:

  • Conversion Counting Type
  • Conversion Counting Pct
  • Conversion Floodlight Activity Ids
  • Primary Attribution Model Id

فیلدهای اطلاعات گزارش

ستون‌های شامل:

  • Integration Code
  • Details

فیلدهای استراتژی پیشنهاد قیمت

ستون‌های شامل:

  • Bid Strategy Type
  • Bid Strategy Value
  • Bid Strategy Unit
  • Bid Strategy Do Not Exceed
  • Apply Floor Price For Deals
  • Algorithm Id

تکالیف خلاقانه

ستون‌های شامل:

  • Creative Assignments

زمینه‌های هدف‌گذاری منطقه جغرافیایی

ستون‌های شامل:

  • Geography Targeting - Include
  • Geography Targeting - Exclude

هدف‌گیری مجاورتی

ستون‌های شامل:

  • Proximity Targeting

فیلدهای هدف‌گیری کلمات کلیدی

ستون‌های شامل:

  • Keyword Targeting - Include
  • Keyword Targeting - Exclude

ملاحظات

قبل از اقدام به آپلود Partial SDF موارد زیر را انجام دهید، از موارد زیر مطمئن شوید:

  • ستون شناسه کالا برای همه ورودی‌ها موجود و پر شده است.
  • تمام ستون‌های موجود بخشی از یک گروه ستون پشتیبانی‌شده‌ی Partial SDF هستند.
  • تمام ستون‌های موجود در گروه‌های ستونی نمایش داده شده، لحاظ شده‌اند.
  • بین کاماها و مقادیر ستون‌هایی که از هم جدا می‌کنند، هیچ فاصله‌ای وجود ندارد.
  • هر مقدار در یک ورودی فعلی، مقدار مورد نظر برای آن ستون است.
  • اگر می‌خواهید آیتم‌های خطی را از تبلیغ‌کنندگان مختلف به‌روزرسانی کنید، Partial SDF خود را در سطح شریک مشترک آپلود کنید. نمی‌توانید دو آیتم خطی را تحت شرکای مختلف در یک SDF به‌روزرسانی کنید.