داده‌های ساختاریافته - v11 - آگهی

برای توضیح قالب، نمای کلی را ببینید.

فیلدالزامینوعقابل‌نوشتنشرح
شناسه آگهیفقط هنگام ویرایش کردن «آگهی‌های» موجود لازم استعدد صحیحنهمقدار شناسه عددی آگهی گروه آگهی. اگر خالی بگذارید، «آگهی» جدیدی ایجاد می‌شود و شناسه یکتایی به آن اختصاص داده می‌شود.
شناسه گروه آگهیبلهعدد صحیحنهمقدار شناسه عددی گروه آگهی اصلی. می‌توانید شناسه سفارشی (برای نمونه، «ext[custom ad group ID]») را برای «گروه آگهی» که هم‌زمان با این «آگهی» می‌سازید مشخص کنید.
نام گروه آگهینهرشتهنهنام گروه آگهی
نامبلهرشتهبلهنام ورودی.
وضعیتبلهرشتهبلهتنظیم وضعیت برای ورودی.
  • فعال
  • موقتاً متوقف شد
  • حذف شد
نوع آگهیبرای YouTube و «آگهی‌های تولید تقاضا» الزامی استرشتهبلهقالب آگهی آگهی.

ویدیو در جاری‌سازی و ویدیو در فید انواع آگهی ویدیویی YouTube هستند که براساس «قیمت به‌ازای بازدید» فروخته می‌شوند. آگهی‌های سپر آگهی‌های ویدیویی YouTube با مدت ۶ ثانیه یا کمتر هستند که براساس «هزارظهوربها» فروخته می‌شوند. آگهی‌های ویدیویی ردنشدنی آگهی‌های درون جاری‌سازی YouTube بین ۶ تا ۱۵ ثانیه هستند که براساس واحد محصولات تجاری (CPM) فروخته می‌شوند. صدای YouTube آگهی‌های صوتی YouTube است. آگهی‌های ویدیویی واکنش‌گرا انواع آگهی YouTube هستند که به‌عنوان قالب‌های متعدد ارائه می‌شوند. اگر ویدیو به‌اندازه کافی کوتاه باشد، آگهی‌های دسترسی کارآمد به‌عنوان آگهی سپر YouTube و درغیراین‌صورت به‌عنوان آگهی در جاری‌سازی YouTube ارائه خواهد شد. آگهی‌های ویدیویی «تولید تقاضا» در قالب‌های مختلفی ارائه می‌شود، ازجمله، اما نه محدود به YouTube. آگهی‌های تصویری «تولید تقاضا» تصاویر را نشان می‌دهند. آگهی‌های گردونه‌ای «تولید تقاضا» کارت‌ها را نشان می‌دهند. آگهی‌های محصول «تولید تقاضا» محصولات را نشان می‌دهد.

یکی از مقادیر زیر را انتخاب کنید:
  • در جاری‌سازی
  • ویدیوی درون‌فیدی
  • آگهی خطی کوتاه
  • غیرقابل رد کردن
  • صدای YouTube
  • واکنش‌گرا
  • دسترسی کارآمد
  • محصول «تولید تقاضا»
  • ویدیو «تولید تقاضا»
  • تصویر «تولید تقاضا»
  • گردونه‌ای «تولید تقاضا»
شناسه ویدیوبرای YouTube و «آگهی‌های ویدیویی تولید تقاضا» الزامی استرشتهبله

شناسه‌های ویدیوهای YouTube که توسط آگهی استفاده شده است.

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

  • «روشن» گواهی می‌دهد که ویدیو بااستفاده از هوش مصنوعی ساخته یا ویرایش شده است
  • «خاموش» گواهی می‌دهد که ویدیو بااستفاده از هوش مصنوعی ساخته یا ویرایش نشده است
  • خالی گذاشتن این مقدار باعث ارائه گواهی نمی‌شود. اگر قبلاً گواهی برای این شناسه ویدیو YouTube تحت این تبلیغ‌کننده ارائه شده باشد، مقدار گواهی موجود به‌طور خودکار اعمال خواهد شد.

اگر مقدار «روشن» یا «خاموش» برای شناسه ویدیو YouTube ارائه شود، این گواهی به همه استفاده‌های موجود از آن شناسه ویدیو YouTube تحت این تبلیغ‌کننده اعمال خواهد شد. درباره این موضوع در برچسب‌گذاری هوش مصنوعی در آگهی‌ها بااستفاده از SDF بیشتر بخوانید.

قالب فهرست = (شناسه ویدیو YouTube؛ وضعیت گواهی محتوای مصنوعی)؛ (شناسه ویدیو YouTube؛ وضعیت گواهی محتوای مصنوعی)؛ و غیره)

برای مثال: «(abdefg; ON);(hijlk; OFF);(mnopq;)»

نمایش نشانی وببله برای «درون جاری‌سازی» و «بامپر»رشتهبلهنشانی وب نمایش‌داده‌شده آگهی
نشانی وب صفحه مقصدبرای آگهی‌های «درج‌شده در جاری‌سازی»، «کوته‌آگهی»، و «تولید تقاضا» الزامی استرشتهبلهنشانی وب صفحه مقصد آگهی
ردیابی DCM - شناسه جای آگهیفقط هنگام به‌روزرسانی «آگهی ردیابی DCM» الزامی استعدد صحیحبلهمقدار شناسه عددی جای آگهی DCM برای آگهی ردیابی مربوطه.
برای برداشتن «آگهی ردیابی DCM»، سه ستون «ردیابی DCM - شناسه جای آگهی»، «ردیابی DCM - شناسه آگهی»، و «ردیابی DCM - شناسه خلاقانه» را خالی بگذارید.
ردیابی DCM - شناسه آگهیفقط هنگام به‌روزرسانی «آگهی ردیابی DCM» الزامی استعدد صحیحبلهمقدار شناسه عددی «آگهی DCM» برای آگهی ردیابی مربوطه.برای برداشتن «آگهی ردیابی DCM»، سه ستون «ردیابی DCM - شناسه جای آگهی»، «ردیابی DCM - شناسه آگهی»، و «ردیابی DCM - شناسه خلاق» را خالی بگذارید.
ردگیری DCM - شناسه طرح‌آگهیفقط هنگام به‌روزرسانی «آگهی ردیابی DCM» الزامی استعدد صحیحبلهمقدار شناسه عددی عنصر خلاق برای آگهی ردیابی مربوطه.برای برداشتن «آگهی ردیابی DCM»، سه ستون «ردیابی DCM - شناسه جای آگهی»، «ردیابی DCM - شناسه آگهی»، و «ردیابی DCM - شناسه عنصر خلاق» را خالی بگذارید.
نشانی وب ردیاب کلیکنهرشتهبلهنشانی وب ردیاب کلیک آگهی
پارامترهای نشانی وب ردیاب کلیکنهرشته، فهرست فهرست‌هابلهپارامترهای سفارشی نشانی وب ردیاب کلیک. قالب = (نام۱؛ مقدار۱؛)؛ (نام۲؛ مقدار۲؛)؛ و غیره
دعوت به اقداموقتی «عنوان» خالی نباشد یا «نوع آگهی» «ویدیو تولید تقاضا»، «تصویر تولید تقاضا»، «گردونه تولید تقاضا» باشد، الزامی استرشتهبلهبرچسب دکمه «دعوت به اقدام» (۱ خط با حداکثر ۱۰ نویسه).
Headlineبرای «آگهی‌های تولید تقاضا» الزامی استرشتهبلهعنوان رونهاد «دعوت به اقدام» (۱ خط با حداکثر ۱۵ نویسه).
مسیر نشانی وب نمایش‌داده‌شده ۱نهرشتهبلهمسیر نشانی وب نمایش‌داده‌شده ۱
مسیر نشانی وب نمایش‌داده‌شده ۲نهرشتهبلهمسیر نشانی وب نمایش‌داده‌شده ۲
ریزعکس ویدیو درون‌فیدیبله برای «ویدیو درون‌فیدی»رشتهبلهریزعکس ویدیویی که برای آگهی‌های اکتشافی ویدیویی استفاده می‌شود
  • 0
  • 1
  • 2
  • 3
عنوان ویدیو درون‌فیدیبرای آگهی‌های ویدیویی درون فید و «تولید تقاضا» الزامی استرشتهبلهنوشتار عنوان برای آگهی واکنش‌گرا یا آگهی اکتشافی، یا عنوان بلند برای آگهی‌های «تولید تقاضا».
شرح ۱برای آگهی‌های ویدیویی درون فید و «تولید تقاضا» الزامی استرشتهبلهنوشتار شرح ۱ آگهی اکتشافی یا شرح آگهی واکنش‌گرا
شرح ۲برای «ویدیو درون‌فیدی» الزامی استرشتهبلهنوشتار شرح ۲ آگهی اکتشافی
صفحه مقصد ویدیو درون‌فیدیبله برای «ویدیو درون‌فیدی»رشتهبلهصفحه مقصد آگهی اکتشافی
نشانی وب صفحه مقصد تلفن همراهنهرشتهبلهنشانی وب صفحه مقصد آگهی برای دستگاه‌های همراه
نام کسب‌وکاراگر در سطح تبلیغ‌کننده تنظیم نشده باشد، برای «آگهی‌های تولید تقاضا» الزامی استرشتهبلهنام کسب‌وکاری که تبلیغ می‌شود. اگر تنظیم نشده باشد و مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد، مقدار پیش‌فرض اعمال خواهد شد.

از ۱۲ اکتبر ۲۰۲۶، اگر این ستون در سطح تبلیغ‌کننده تنظیم نشده باشد، برای همه «آگهی‌های واکنش‌گرا در YouTube» الزامی خواهد بود.
پسوند نشانی وب صفحه مقصدنهرشتهبلهپسوند نشانی وب صفحه مقصد
شناسه‌های دارایی نشان‌وارهاگر در سطح تبلیغ‌کننده تنظیم نشده باشد، برای «آگهی‌های تولید تقاضا» الزامی استرشته، فهرستبلهفهرست شناسه‌های دارایی برای نشان‌واره‌ها. این فهرست به‌ترتیب صعودی عددی تولید می‌شود. اگر تنظیم نشده باشد و مقدار پیش‌فرضی در سطح تبلیغ‌کننده تنظیم شده باشد، مقدار پیش‌فرض اعمال خواهد شد.

از ۱۲ اکتبر ۲۰۲۶، اگر این ستون در سطح تبلیغ‌کننده تنظیم نشده باشد، برای همه «آگهی‌های واکنش‌گرا در YouTube» الزامی خواهد بود.
شناسه‌های دارایی تصویر بازاریابیوقتی «نوع آگهی» «تصویر تولید تقاضا» باشد الزامی استرشته، فهرستبلهفهرست شناسه‌های دارایی برای تصاویر بازاریابی. این فهرست به‌ترتیب صعودی تولید می‌شود.
کارت‌های «تولید تقاضا»وقتی «نوع آگهی» «گردونه‌ای تولید تقاضا» باشد لازم استرشته، فهرست فهرست‌هابلهاین کار فهرستی از کارت‌ها را در قالب زیر تعریف می‌کند:

(نشانی وب نهایی؛ تلفن همراه مقصد؛ نشانی وب؛ عنوان؛ نوشتار دعوت به اقدام؛ شناسه دارایی تصویر بازاریابی؛ شناسه‌های دارایی بازاریابی اضافی…).

برای مثال: (google.com؛ mobile.google.com؛ عنوان؛ اینجا کلیک کنید؛ ۱۰۲۰۰؛ ۲۰۲۰۰؛ ۳۰۲۰۰).

هر دارایی بازاریابی باید نسبت ابعادی یکتا داشته باشد. اگر یک کارت زیر یک «آگهی» تصویر بازاریابی مربعی داشته باشد، همه کارت‌های زیر آن «آگهی» باید تصویر بازاریابی مربعی داشته باشند (این امر برای نسبت‌های ابعادی دیگر نیز صدق می‌کند).

شناسه‌های دارایی برنمای همراهنهرشته، فهرستبلهفهرست شناسه‌های دارایی برای برنمای همراه. این فهرست به‌ترتیب صعودی عددی تولید می‌شود. این ویژگی برای «عملکرد ویدیو»، «ویدیو تولید تقاضا»، «درون جاری‌سازی»، «آگهی خطی کوتاه»، و «آگهی ردنشدنی» پشتیبانی می‌شود. قالب فهرست = 100; 200;
شناسه‌های دارایی تصویر آگهی وقفهنهرشته، فهرستبله

فهرست شناسه‌های دارایی برای تصاویر آگهی موقتاً متوقف‌شده.

برای مثال: (۱۰۰؛۲۰۰؛۳۰۰؛)

پشتیبانی از «فایل داده ساختاری» برای موردهای سطری «معامله فوری» و گروه‌های آگهی و آگهی‌های آن‌ها در مرحله بتا است و فقط برای شرکای فهرست مجاز دردسترس است. آگهی‌های زیر ردیف‌های مورد معامله فوری در فایل‌های بارگیری‌شده گنجانده نخواهند شد و باید ازطریق گردش کار ایجاد معامله فوری YouTube در رابط Display & Video 360 بارگذاری شوند.

شناسه عنصر خلاقانه ولینهعدد صحیحنهمقدار شناسه عددی عنصر خلاقانه Display & Video 360 والد.