تبلیغات بومی تبلیغاتی هستند که متناسب با محتوای اطراف و طراحی بصری قالب بندی شده اند و احتمال مشاهده و کلیک کاربران را افزایش می دهند. موجودی تبلیغات بومی در برنامه های تلفن همراه و همچنین وب سایت های دسکتاپ و تلفن همراه در دسترس است. برای اطلاعات بیشتر در مورد تبلیغات بومی، به نمای کلی تبلیغات بومی مراجعه کنید.
تبلیغات بومی هم برای خریداران مجاز و هم برای مناقصه باز پشتیبانی می شود.
گردش کار برای تبلیغات بومی در اینجا آمده است:
- یک تماس برای یک آگهی بومی با Google برقرار می شود. فراخوان یک یا هر دو الگوی تبلیغات بومی زیر را مشخص می‌کند که هر کدام فیلدهای بومی ترجیحی را مشخص می‌کنند.
- Google یک درخواست پیشنهاد قیمت RTB حاوی لیستی از فیلدهای درخواستی را برای خریداران ارسال می کند.
- خریداران علاقه مند با فیلدهای درخواستی پاسخ دهند.
- Google حراجی را برای انتخاب پیشنهاد برنده برگزار می‌کند و دارایی‌های خلاقانه عرضه‌شده خریدار را برای ناشر ارسال می‌کند.
- ناشر دارایی‌ها را در یک آگهی بومی جمع‌آوری می‌کند و آنها را متناسب با طراحی سایت می‌سازد.
فرمت های پیام
گوگل از مشخصات OpenRTB در JSON و Protobuf پشتیبانی می کند.
برای تبلیغات بومی OpenRTB Protobuf، فیلدهای زیر با مشخصات متفاوت است:
| JSON | نوع JSON | پروتوبوف | نوع پروتوباف |
|---|---|---|---|
BidRequest.imp[].native.request | string | BidRequest.imp[].native.request_native | NativeRequest |
BidResponse.seatbid[].bid[].adm | string | BidResponse.seatbid[].bid[].adm_native | NativeResponse |
فیلدهای OpenRTB Protobuf به جای رشته، پیام های Protobuf هستند.
اگر از پیاده‌سازی OpenRTB Protobuf استفاده می‌کنید، نقطه پایانی شما درخواست‌های پیشنهادی حاوی BidRequest.imp.native.request_native به جای BidRequest.imp.native.request دریافت می‌کند. علاوه بر این، نقطه پایانی شما باید پاسخ‌های پیشنهادی را برگرداند که BidResponse.seatbid.bid.adm_native به جای BidResponse.seatbid.bid.adm پر شده است، در غیر این صورت از حراج فیلتر می‌شود.
اگر از یک SDK خریدار برای ارائه تبلیغات بومی استفاده می‌کنید، هنگام ارسال خلاقیت‌ها برای بازبینی ، باید یک type تصویر را در declared_ad اضافه کنید.
قالب های تبلیغاتی بومی
الگوهای تبلیغات بومی اجزای یک آگهی بومی را توصیف می‌کنند و محتوا و ساختار NativeRequest OpenRTB یا NativeAdTemplate پروتکل منسوخ شده Google RTB را در درخواست پیشنهاد تعیین می‌کنند. Google از دو الگوی رایج تبلیغات بومی برای تبلیغات بومی غیر ویدیویی و ویدیویی پشتیبانی می کند:
- الگوی تبلیغ نصب برنامه - نصب برنامه تلفن همراه را ترویج و هدایت کنید.
- قالب تبلیغات محتوا - ترکیب کلی بیشتر متن و تصاویر برای تبلیغات مارک یا وب.
- الگوی تبلیغ نصب برنامه ویدیویی
- قالب تبلیغ محتوای ویدیویی
الگوهای دیگری وجود دارند و ممکن است مجموعه‌ای از الزامات متفاوت برای فیلدها، ابعاد و اندازه‌ها داشته باشند.
قالب تبلیغ نصب اپلیکیشن
فیلدهای مورد نیاز و توصیه شده
جداول زیر فیلدهایی با برچسب الزامی یا توصیه شده را نشان می دهد. قوانین زیر اعمال می شود:
- فیلدهایی که با علامت الزامی مشخص شده اند توسط داوطلب الزامی است.
- فیلدهایی که علامت‌گذاری شده به عنوان «توصیه می‌شود» مورد نیاز داوطلب نیستند و ناشر ممکن است در صورت ارائه آنها را نمایش دهد یا ندهد (به عنوان مثال، رتبه‌بندی ستاره).
- Call to Action (CTA) همیشه به‌عنوان توصیه‌شده علامت‌گذاری می‌شود، زیرا اگر پیشنهاد دهنده ارسال نشود، یک پیش‌فرض تعیین می‌شود، اما در صورت ارسال همیشه نمایش داده می‌شود.
جدول زیر فیلدهای یک الگوی تبلیغات نصب برنامه را فهرست می کند. برنامه های موبایل از این فیلدها برای ایجاد تبلیغات نصب برنامه بومی استفاده می کنند.
| میدان | توضیحات | مورد نیاز یا توصیه شده؟ | همیشه نمایش داده می شود؟ | اندازه تصویر توصیه شده/حداکثر تعداد کاراکترها | مثال |
|---|---|---|---|---|---|
| تیتر | عنوان برنامه | مورد نیاز | بله | 25 کاراکتر | سیل - آن! |
| تصویر | اسکرین شات از برنامه یا تصویر مرتبط دیگری | مورد نیاز | خیر | 1200 پیکسل در 627 پیکسل یا 600 پیکسل در 600 پیکسل بسته به نسبت تصویر مورد نیاز ناشر. | <عکسی از بازی Flood-It!> |
| بدن | متن اصلی برنامه | مورد نیاز | خیر | 90 کاراکتر | فریبنده ساده + وسوسه انگیز به چالش کشیدن = لذت بخش اعتیاد آور! |
| نماد برنامه | نماد برنامه | مورد نیاز | خیر | 128 x 128 پیکسل | <سیل آن را! نماد برنامه > |
| فراخوان به اقدام | اقدام کاربر ترجیحی | توصیه می شود | بله | 15 کاراکتر | نصب کنید |
| امتیاز ستاره | تعداد ستاره ها (0 - 5) نشان دهنده رتبه برنامه در فروشگاه برنامه | توصیه می شود | خیر | 0 - 5 | 4.5 |
| قیمت | هزینه برنامه | توصیه می شود | خیر | 15 کاراکتر | رایگان |
نکاتی درباره طول متن
اگر خریدار دارایی متنی (مثلاً متن اصلی) را طولانی‌تر از حداکثر تعداد نویسه‌های پیشنهادی ارسال کند، ممکن است Google یا ناشر آن متن را کوتاه و بی‌اطلاع کند. توجه داشته باشید که محدودیت های برش در زبان های چینی، ژاپنی و کره ای نصف اندازه است. به عنوان مثال، محدودیت عنوان برای انگلیسی 90 و برای چینی 45 است.
نکاتی در مورد اندازه تصویر
ناشران مجازند:
- تصویر اصلی را به صورت متقارن تا 20% در یک بعد (ارتفاع یا عرض) برش دهید.
- مقیاس تصویر را بدون تغییر نسبت ابعاد آن تغییر دهید.
- تصاویری که نسبت‌های ابعادی آنها به طور قابل‌توجهی متفاوت از نسبت‌هایی هستند که در ارتفاع و عرض آنها ذکر شده است، ممکن است فیلتر شوند.
قالب تبلیغات محتوایی
جدول زیر فیلدهای یک قالب تبلیغات محتوا را فهرست می کند. ناشران از این فیلدها برای ایجاد تبلیغات محتوای بومی استفاده می کنند.
| میدان | توضیحات | مورد نیاز یا توصیه شده؟ | همیشه نمایش داده می شود؟ | اندازه تصویر توصیه شده/حداکثر تعداد کاراکترها * | مثال |
|---|---|---|---|---|---|
| تیتر | سربرگ آگهی | مورد نیاز | بله | 25 کاراکتر | پایین ترین نرخ وام مسکن |
| تصویر | تصویر اصلی آگهی | مورد نیاز | خیر | 1200 پیکسل در 627 پیکسل یا 600 پیکسل در 600 پیکسل بسته به نسبت تصویر مورد نیاز ناشر. | <تصویر اصلی آگهی> |
| بدن | محتوای آگهی | مورد نیاز | خیر | 90 کاراکتر | خانه شیرین شما خانه بروکلین - ارزان تر و زودتر از آنچه فکر می کنید! |
| لوگو | لوگوی تبلیغ کننده یا تصویر کوچک مرتبط دیگری | توصیه می شود | خیر | 128 x 128 پیکسل | <آرم NY Mortgage Inc.> |
| فراخوان به اقدام | اقدام برگزیده کاربر | توصیه می شود | خیر | 15 کاراکتر | یک نقل قول دریافت کنید |
| تبلیغ کننده | متنی که تبلیغ کننده یا برند را مشخص می کند | مورد نیاز | خیر | 25 کاراکتر | NY Mortgage Inc. |
الگوی تبلیغ نصب برنامه ویدیویی
| میدان | توضیحات | مورد نیاز یا توصیه شده؟ | همیشه نمایش داده می شود؟ | اندازه تصویر توصیه شده/حداکثر تعداد کاراکترها * | مثال |
|---|---|---|---|---|---|
| ویدئو | پاسخ ویدیویی VAST حاوی تمام دارایی‌های لازم برای پخش یک آگهی ویدیویی. | مورد نیاز | خیر | - | یک URL به VAST XML حاوی Flood-It! تبلیغ ویدیویی |
| تیتر | عنوان برنامه | مورد نیاز | بله | 25 کاراکتر | سیل - آن! |
| تصویر | تصویر (تصویر کوچک) قبل از کلیک روی تبلیغ ویدیویی یا در حین بارگیری در پخش کننده نشان داده می شود. | مورد نیاز | خیر | باید با نسبت تصویر مطابقت داشته باشد (به عنوان مثال: 1280x720 برای ویدیوی 16x9، 4x3 برای ویدیوی 640x480). | اسکرین شات از بازی Flood-It! یا از ویدیو |
| بدن | متن اصلی برنامه | مورد نیاز | خیر | 90 کاراکتر | فریبنده ساده + وسوسه انگیز به چالش کشیدن = لذت بخش اعتیاد آور! |
| نماد برنامه | نماد برنامه | مورد نیاز | خیر | 128 x 128 پیکسل | سیل آن را! نماد برنامه |
| فراخوان به اقدام | اقدام کاربر ترجیحی | مورد نیاز | بله | 15 کاراکتر | نصب کنید |
| امتیاز ستاره | تعداد ستاره ها (0 - 5) نشان دهنده رتبه برنامه در فروشگاه برنامه | توصیه می شود | خیر | 0 - 5 | 4.5 |
| قیمت | هزینه برنامه | توصیه می شود | خیر | 15 کاراکتر | رایگان |
محدودیت ها
ویدیو : همه ویدیوها باید به شکل یک URL VAST یا یک برچسب VAST باشند. یک فایل ویدئویی خام مانند WebM، MP4 و غیره قابل تعیین نیست .
طول متن : اگر خریدار دارایی متنی مانند
bodyدر پاسخ مشخص کند، ممکن است توسط Google یا ناشر کوتاه شده و بیضی شود. توجه داشته باشید که محدودیت های برش در زبان های چینی، ژاپنی و کره ای نصف اندازه است. به عنوان مثال، محدودیت عنوان در زبان انگلیسی 90 و برای چینی 45 است.اندازه تصویر : ناشران مجازند:
- تصویر اصلی را به صورت متقارن تا 20% در یک بعد (ارتفاع یا عرض) برش دهید.
- مقیاس تصویر را بدون تغییر نسبت ابعاد آن تغییر دهید.
نمونه تبلیغ نصب برنامه
قالب تبلیغ محتوای ویدیویی
| میدان | توضیحات | مورد نیاز یا توصیه شده؟ | همیشه نمایش داده می شود؟ | اندازه تصویر توصیه شده/حداکثر تعداد کاراکترها * | مثال |
|---|---|---|---|---|---|
| ویدئو | پاسخ ویدیویی VAST حاوی تمام دارایی‌های لازم برای پخش یک آگهی ویدیویی. | مورد نیاز | بله | - | یک URL به VAST XML حاوی Flood-It! تبلیغ ویدیویی |
| تیتر | سربرگ آگهی | مورد نیاز | بله | 25 کاراکتر | پایین ترین نرخ وام مسکن |
| تصویر | تصویر (تصویر کوچک) قبل از کلیک روی تبلیغ ویدیویی یا در حین بارگیری در پخش کننده نشان داده می شود. | مورد نیاز | خیر | باید با نسبت تصویر مطابقت داشته باشد (به عنوان مثال: 1280x720 برای ویدیوی 16x9، 4x3 برای ویدیوی 640x480). | اسکرین شات از ویدیو |
| بدن | محتوای آگهی | مورد نیاز | خیر | 90 کاراکتر | خانه شیرین شما خانه بروکلین - ارزان تر و زودتر از آنچه فکر می کنید! |
| لوگو | لوگوی تبلیغ کننده یا تصویر کوچک مرتبط دیگری | توصیه می شود | خیر | 128 x 128 پیکسل | لوگوی NY Mortgage Inc |
| فراخوان به اقدام | اقدام برگزیده کاربر | مورد نیاز | خیر | 15 کاراکتر | یک نقل قول دریافت کنید |
| تبلیغ کننده | متنی که تبلیغ کننده یا برند را مشخص می کند | مورد نیاز | خیر | 25 کاراکتر | NY Mortgage Inc. |
فیلدهای متا
فیلدهای متا زیر توسط همه الگوهای تبلیغاتی پشتیبانی شده به اشتراک گذاشته شده است:
| پروتکل RTB گوگل | معادل OpenRTB | توضیحات |
|---|---|---|
NativeAd.click_link_url | Link.url | آدرس اینترنتی که با کلیک کاربر روی تبلیغ توسط مرورگر فراخوانی می شود. می تواند اولین مرحله از یک زنجیره تغییر مسیر باشد که در نهایت به صفحه فرود منتهی می شود. برای تبلیغات بومی، توصیه می کنیم از click_link_url به عنوان فیلد برای تعیین مقصدی که کاربر در نهایت به آنجا می رود، استفاده کنید. استفاده از این فیلد در مورد صفحات فرود پویا الزامی است. |
Ad.click_through_url | Bid.adomain | اگر مناقصه‌دهنده قصد مناقصه را دارد، باید تنظیم شود. این مجموعه نشانی‌های اینترنتی مقصد برای قطعه است، از جمله نشانی‌های اینترنتی که کاربر در صورت کلیک بر روی تبلیغ نمایش‌داده شده به آنها می‌رود و هر نشانی اینترنتی که در آگهی ارائه‌شده قابل مشاهده است. تماس‌های میانی به سرور را که به صفحه فرود نهایی مرتبط نیستند، وارد نکنید. یک BidResponse که یک تکه یا تبلیغ ویدیویی را برمی‌گرداند اما اعلام می‌کند که برای تبلیغات غیر بومی، برای ردیابی کلیک یا هر عملکرد تبلیغاتی دیگری استفاده نمی شود. فقط به عنوان یک نشانی اینترنتی مقصد استفاده می شود. برای تبلیغات بومی، اگر |
NativeAd.click_tracking_urls | Link.clicktrackers | اختیاری. نشانی‌های اینترنتی اضافی که به تبلیغ‌کنندگان اجازه می‌دهد کلیک‌های کاربران روی آگهی را ردیابی کنند. |
Ad.ad_choices_destination_url | BidExt.ad_choices_destination_url | پیوند به یک صفحه ترجیحی یا انصراف از تبلیغات. در صورت وجود، یک نماد AdChoices استاندارد به خلاقیت اصلی اضافه شده و به این URL پیوند داده می شود. این برای تبلیغات بومی پشتیبانی می‌شود اما بخشی از پیام اصلی در پاسخ پیشنهاد قیمت نیست. |
Ad.impression_tracking_url | NativeResponse.imptrackers | نمایش بومی باید با impression_tracking_url در پروتوی پیشنهادی بلادرنگ خریداران مجاز یا Imptrackerهای بومی در OpenRTB ردیابی شود. |
فیلدهای مورد نیاز و توصیه شده پروتکل RTB Google
required_fields و recommended_fields توسط ناشر مشخص شده است. ما نشان می‌دهیم که چگونه این فیلدهای بیتی را ترجمه کنیم تا مشخص کنیم آیا یک فیلد مورد نیاز است یا توصیه می‌شود.
یک فیلد بیت از هر بیت از یک مقدار باینری برای ذخیره یک عبارت درست یا نادرست استفاده می کند، که معادل ارسال سیگنال های بولی بسیاری مانند is_logo_required یا is_header_required است، اما همه با هم بسته بندی شده اند.
مثال
برای این مثال از مقدار 1085 required_fields استفاده خواهیم کرد.
ابتدا مقدار باینری معادل 10000111101 را پیدا کنید
هنگامی که مقدار باینری را به دست آوردید، می توانید بیت ها را بررسی کنید تا ببینید آیا یک فیلد مورد نیاز است (1) یا لازم نیست (0).
جدول زیر فیلدها را به جای آنها در مقدار باینری ترسیم می کند. باینری را از راست به چپ بخوانید، با 1 بیت مربوط به سمت راست ترین مکان در مقدار باینری.
| میدان | قرار دادن مقدار باینری (راست به چپ) |
|---|---|
HEADLINE | 1 |
BODY | 2 |
CALL_TO_ACTION | 4 |
ADVERTISER | 8 |
IMAGE | 16 |
LOGO | 32 |
APP_ICON | 64 |
STAR_RATING | 128 |
PRICE | 256 |
STORE | 512 |
VIDEO | 1024 |
با نگاهی به مثال باینری مقدار 10000111101 ، 1 بیت (راست ترین) 1 است که نشان دهنده مقدار مورد نیاز است. طبق جدول، 1 بیت مربوط به HEADLINE است.
2 بیت (مقدار دوم از سمت راست) 0 است که به معنای نیازی نیست . 2 بیت مربوط به BODY است.
در اینجا تمام فیلدهای مورد نیاز تفسیر شده در مثال ما آمده است:
| ارزش | توضیحات | مورد نیاز؟ |
|---|---|---|
1 | VIDEO | بله |
0 | STORE | خیر |
0 | PRICE | خیر |
0 | STAR_RATING | خیر |
0 | APP_ICON | خیر |
1 | LOGO | بله |
1 | IMAGE | بله |
1 | ADVERTISER | بله |
1 | CALL_TO_ACTION | بله |
0 | BODY | خیر |
1 | HEADLINE | بله |
نمایش قالب آگهی بومی در درخواست مناقصه
هنگام دریافت یک درخواست پیشنهادی حاوی موجودی بومی، بسته به پروتکل مورد استفاده، الگوی تبلیغات بومی را به اشکال مختلف در بر خواهد داشت. توصیه می کنیم از OpenRTB استفاده کنید زیرا پروتکل Google منسوخ شده است.
در OpenRTB، الگوی تبلیغات بومی با پیام NativeRequest توضیح داده می شود. در پروتکل Google RTB، با NativeAdTemplate توضیح داده شده است. این پیام‌ها جزئیات زیر را درباره موجودی آگهی‌های بومی ارائه می‌کنند:
- زمینه هایی که مورد نیاز یا توصیه می شوند.
- ابعاد تصاویر، لوگوها و نمادهای برنامه.
- مشخصات سبکی که تبلیغ در آن ارائه می شود.
شناسه دارایی OpenRTB
OpenRTB آرایه‌ای از دارایی‌ها را در درخواست پیشنهاد ارسال می‌کند که ساختار آگهی بومی را که باید در پاسخ برگردانید، توصیف می‌کند. هر دارایی در درخواست دارای شناسه ای خواهد بود که باید برای دارایی مربوطه در پاسخ مشخص شود. برای مثالی از اینکه چگونه این شناسه‌ها بین درخواست و پاسخ مطابقت دارند، نمونه درخواست پیشنهاد قیمت بومی و نمونه پاسخ پیشنهاد قیمت بومی را ببینید.
ارائه یک آگهی بومی در پاسخ مناقصه
هنگام مناقصه برای موجودی بومی، خریدار باید فیلدهای الزامی را که در درخواست مناقصه مشخص شده است پر کند. در OpenRTB، هنگام استفاده از Protobuf یا BidResponse.seatbid.bid.adm برای JSON، می توانید این کار را با BidResponse.seatbid.bid.adm_native انجام دهید. برای پروتکل منسوخ شده Google، این کار با فیلد BidResponse.ad.native_ad انجام می شود.
نمونه درخواست های پیشنهادی
درخواست های پیشنهادی غیر ویدئویی
مثال را به من نشان بده
درخواست سریالid: "l6210s8bS8Uc726V81B821" imp { id: "1" tagid: "3019814809" bidfloor: 0.06 bidfloorcur: "USD" secure: true native { ver: "1.2" request_native { ver: "1.2" assets { id: 1 required: true title { len: 25 } } assets { id: 2 required: true data { type: DESC len: 90 } } assets { id: 3 data { type: CTATEXT len: 15 } } assets { id: 4 required: true img { type: MAIN wmin: 1200 hmin: 627 } } assets { id: 5 img { type: LOGO wmin: 100 hmin: 100 } } eventtrackers { event: IMPRESSION methods: IMG } privacy: true [com.google.doubleclick.native_ext] { style_id: 497439 style_height: 1 style_width: 1 style_layout_type: FLUID } } } exp: 3600 metric { type: "click_through_rate" value: 0.0006697923527099192 vendor: "EXCHANGE" } metric { type: "viewability" value: 0.05 vendor: "EXCHANGE" } [com.google.doubleclick.imp] { billing_id: 50577321529 dfp_ad_unit_code: "/3711494/google/test" ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED buyer_generated_request_data { data: "Test Data" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } open_bidding { is_open_bidding: true } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_OVERRIDDEN } auction_environment: SERVER_SIDE_AUCTION ae: SERVER_SIDE_AUCTION } } site { page: "https://www.google.com" publisher { id: "pub-1111111111111111" [com.google.doubleclick.publisher] { country: "FR" } } content { livestream: false language: "fr" } [com.google.doubleclick.site] { amp: DIALECT_HTML page_visibility: VISIBILITY_STATE_VISIBLE inventorypartnerdomain: "" ntype: NAVIGATION_TYPE_NAVIGATE } } device { ua: "OMITTED" geo { lat: 0.0 lon: 0.0 country: "FRA" region: "FR-C" zip: "63120" type: IP utcoffset: 120 accuracy: 6948 [com.google.doubleclick.geo] { geo_criteria_id: 9112278 } } ipv6: "2a01:cb14:8183::" os: "Windows" devicetype: PERSONAL_COMPUTER lmt: false pxratio: 1.0 sua { browsers { brand: "Chromium" version: "130" version: "0" } browsers { brand: "Microsoft Edge" version: "130" version: "0" } platform { brand: "Windows" version: "15" version: "0" } mobile: false architecture: "x86" bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } } user { [com.google.doubleclick.user] { consented_providers_settings { consented_providers: 1712 consented_providers: 2316 additional_consent: "OMITTED" } consent: "OMITTED" eids { source: "OMITTED" uids { id: "12JD92JD8078S8J29SDOAKC0EF230337" } } } } at: FIRST_PRICE tmax: 350 cur: "USD" regs { gpp: "OMITTED" [com.google.doubleclick.regs] { gdpr: true } } source { schain { complete: true nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: true } ver: "1.0" } [com.google.doubleclick.source] { schain { complete: 1 nodes { asi: "testssp.com" sid: "pub-1111111111111111" hp: 1 } ver: "1.0" } } } [com.google.doubleclick.bid_request] { google_query_id: "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v" fcap_scope: FREQUENCY_CAPPING_SCOPE_NONE }
مثال را به من نشان بده
{ "id": "l6210s8bS8Uc726V81B821", "imp": [ { "id": "1", "tagid": "3019814809", "bidfloor": 0.06, "bidfloorcur": "USD", "secure": 1, "native": { "ver": "1.2", "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"data\":{\"type\":2,\"len\":90}},{\"id\":3,\"data\":{\"type\":12,\"len\":15}},{\"id\":4,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}},{\"id\":5,\"img\":{\"type\":2,\"wmin\":100,\"hmin\":100}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_id\":497439,\"style_height\":1,\"style_width\":1,\"style_layout_type\":1}}" }, "exp": 3600, "metric": [ { "type": "click_through_rate", "value": 0.0006697923527099192, "vendor": "EXCHANGE" }, { "type": "viewability", "value": 0.05, "vendor": "EXCHANGE" } ], "ext": { "billing_id": [ "50577321529" ], "dfp_ad_unit_code": "/3711494/google/test", "ampad": 3, "buyer_generated_request_data": [ { "data": "Test Data" } ], "excluded_creatives": [ { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" }, { "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID" } ], "open_bidding": { "is_open_bidding": 1 }, "creative_enforcement_settings": { "policy_enforcement": 1, "publisher_blocks_enforcement": 2 }, "auction_environment": 0, "ae": 0 } } ], "site": { "page": "https://www.google.com", "publisher": { "id": "pub-1111111111111111", "ext": { "country": "FR" } }, "content": { "livestream": 0, "language": "fr" }, "ext": { "amp": 0, "page_visibility": 1, "inventorypartnerdomain": "OMITTED", "ntype": 1 } }, "device": { "ua": "OMITTED", "geo": { "lat": 0.0, "lon": 0.0, "country": "FRA", "region": "FR-C", "zip": "63120", "type": 2, "utcoffset": 120, "accuracy": 6948, "ext": { "geo_criteria_id": 9112278 } }, "ipv6": "2a01:cb14:8183::", "os": "Windows", "devicetype": 2, "lmt": 0, "pxratio": 1.0, "sua": { "browsers": [ { "brand": "Chromium", "version": [ "130", "0" ] }, { "brand": "Microsoft Edge", "version": [ "130", "0" ] } ], "platform": { "brand": "Windows", "version": [ "15", "0" ] }, "mobile": 0, "architecture": "x86", "bitness": "64", "source": 2 } }, "user": { "ext": { "consented_providers_settings": { "consented_providers": [ "1712", "2316" ], "additional_consent": "OMITTED" }, "consent": "OMITTED", "eids": [ { "source": "OMITTED", "uids": [ { "id": "12JD92JD8078S8J29SDOAKC0EF230337" } ] } ] } }, "at": 1, "tmax": 350, "cur": [ "USD" ], "regs": { "gpp": "OMITTED", "ext": { "gdpr": 1 } }, "source": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" }, "ext": { "schain": { "complete": 1, "nodes": [ { "asi": "testssp.com", "sid": "pub-1111111111111111", "hp": 1 } ], "ver": "1.0" } } }, "ext": { "google_query_id": "ANy-zyo598-4J62UYQ5J70Wm78t166uKD8322K98ik4X5496cn305Sp16t94Mhegp514jh1v", "fcap_scope": 1 } }
مثال را به من نشان بده
درخواست سریالid: "\213\371#\236Mh\214uJ\356\225qW88=7|\2448\315Wx" ip: "\300\250" user_agent: "OMITTED" url: "https://www.google.com" detected_language: "it" adslot { id: 1 excluded_attribute: 14 excluded_attribute: 32 allowed_vendor_type: 42 allowed_vendor_type: 144 excluded_sensitive_category: 36 excluded_sensitive_category: 19 matching_ad_data { billing_id: 74792558829 billing_id: 11204117851 minimum_cpm_micros: 390000 } matching_ad_data { billing_id: 44428418146 billing_id: 91112044263 minimum_cpm_micros: 110000 } slot_visibility: BELOW_THE_FOLD excluded_product_category: 10366 excluded_product_category: 11504 ad_block_key: 8767661977 publisher_settings_list_id: 7807286827624818876 publisher_settings_list_id: 8186380472781289268 allowed_restricted_category: 32 allowed_restricted_category: 33 excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } excluded_creatives { buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID" } iframing_state: UNKNOWN_IFRAME_STATE viewability: 6 allowed_restricted_category_for_deals: 32 allowed_restricted_category_for_deals: 33 click_through_rate: 0.0010397299 allowed_ad_types: ALLOWED_AD_TYPE_NATIVE is_amp_page: DIALECT_HTML amp_ad_requirement_type: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED secure_signals { data: "Test Data: bw44G12BFZ" source: "OMITTED" } consented_providers_settings { tcf_consent_string: "OMITTED" additional_consent_string: "OMITTED" } regs_gdpr: true native_ad_template { required_fields: 17 recommended_fields: 0 headline_max_safe_length: 90 body_max_safe_length: 90 call_to_action_max_safe_length: 15 advertiser_max_safe_length: 25 image_width: 1200 image_height: 627 style_id: 749853 style_layout_type: FLUID style_height: 1 style_width: 1 } creative_enforcement_settings { policy_enforcement: POLICY_ENFORCEMENT_PLATFORM_POLICY publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES } auction_environment: SERVER_SIDE_AUCTION impression_expiration_seconds: 3600 supported_auction_environment: SERVER_SIDE_AUCTION } is_test: false timezone_offset: 120 geo_criteria_id: 1008463 bid_response_feedback { request_id: "\314\354d\177=@0\271\226a^\250\302u\037\301" creative_status_code: 1 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 220000 feedback_type: BID_FEEDBACK } bid_response_feedback { request_id: "\2354\335\340\347!\341~\265\n\206\327\300\005\370G" creative_status_code: 80 event_notification_token: "token" buyer_creative_id: "test_creative_id_744913" minimum_bid_to_win: 3450000 feedback_type: BID_FEEDBACK } publisher_type: PUBLISHER_OWNED_AND_OPERATED device { device_type: PERSONAL_COMPUTER platform: "Windows" screen_pixel_ratio_millis: 1000 limit_ad_tracking: false } publisher_country: "IT" publisher_id: "pub-1111111111111111" response_deadline_ms: 350 google_query_id: "ANy-zJXQF6-ob5v09r508m39543114QNHDY20RX67Ajs996K62nkEpcMuvWam950XP9486e6" auction_type: FIRST_PRICE geo { lat: 0.0 lon: 0.0 country: "ITA" region: "IT-MI" city: "Milan" utcoffset: 120 accuracy: 6821 } user_agent_data { platform { brand: "Windows" version: "10" version: "0" } mobile: false architecture: "x86" browsers { brand: "Chromium" version: "128" version: "0" } browsers { brand: "Not;A=Brand" version: "24" version: "0" } bitness: "64" source: CLIENT_HINTS_HIGH_ENTROPY } page_visibility: VISIBILITY_STATE_VISIBLE supply_chain { complete: true nodes { advertising_system_identifier: "testdomain.com" seller_identifier: "pub-1111111111111111" handles_payment: true } version: "1.0" } frequency_capping_scope: FREQUENCY_CAPPING_SCOPE_NONE privacy_treatments { allow_user_data_collection: true } inventory_partner_domain: "OMITTED"
درخواست های پیشنهادی ویدیویی
{ id: "\\\123/f\000\t\456&\n\789\1234\"\001a\123", ip: "\0338\355", google_user_id: "CAESEJ1ur2l94_8ruuu", cookie_version: 1, cookie_age_seconds: 5184000, hosted_match_data: "W9ABDAAAAGR67nl0", user_agent: "Mozilla/5.0 (Linux; Android 5.1; CP8298_I00) Mobile Safari/537.36", publisher_country: "IN", geo_criteria_id: 1007796, timezone_offset: 330, publisher_id: "pub-2230723027927371", seller_network_id: 989, url: "https://m.example.com", detected_language: [en], google_query_id: "ANy-zJEgdus4l0MishbSmH0eOcXUA1Fbo4_tKROsbR37q", auction_type: "SECOND_PRICE", device: { device_type: "HIGHEND_PHONE", platform: "android", brand: "coolpad", model: "cp8298_i00", os_version: { major: 5, minor: 1 }, carrier_id: 70210, screen_width: 360, screen_height: 640, screen_pixel_ratio_millis: 2000 }, mobile: { is_app: false, is_mobile_web_optimized: true, DEPRECATED_platform: "android", DEPRECATED_mobile_device_type: "HIGHEND_PHONE", DEPRECATED_brand: "coolpad", DEPRECATED_model: "cp8298_i00", DEPRECATED_os_version: { os_version_major: 5, os_version_minor: 1 }, DEPRECATED_screen_width: 360, DEPRECATED_screen_height: 640, DEPRECATED_carrier_id: 70210, DEPRECATED_device_pixel_ratio_millis: 2000 }, publisher_type: "ADX_PUBLISHER_OWNED_AND_OPERATED", adslot: [{ id: 1, ad_block_key: 2882274820, width: [300,250], height: [250,250], excluded_attribute: [114,22,34,25,27,13,14,15,16,17,18,19,20,25,27,22], allowed_vendor_type: [42,144,575,698,704,743,776,785,793,797,808,828,832,885], excluded_sensitive_category: [36,27,19,4,23,30,10,3,31,5,8,37,18], excluded_product_category: [10031,11669,13423,13525,13566,13589,13612,13740], excluded_creatives: [{ buyer_creative_id: "1234567.1234567890-ssl" }], matching_ad_data: [{ billing_id: [6629616415,51386650457], minimum_cpm_micros: 1380000, direct_deal: [{ direct_deal_id: 410401, fixed_cpm_micros: 1360000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true },{ direct_deal_id: 240644, fixed_cpm_micros: 1500000, deal_type: "PREFERRED_DEAL", publisher_blocks_overridden: true }] },{ billing_id: [1234567890], minimum_cpm_micros: 1380000 }], publisher_settings_list_id: [12109930661871909476,11138951146123409010], slot_visibility: "BELOW_THE_FOLD", viewability: 30, click_through_rate: 0.0010072842, iframing_state: "UNKNOWN_IFRAME_STATE", native_ad_template: [{ required_fields: 1065, recommended_fields: 4, headline_max_safe_length: 25, body_max_safe_length: 90, call_to_action_max_safe_length: 15, advertiser_max_safe_length: 25, logo_width: 100, logo_height: 100, style_id: 199892, style_height: 250, style_width: 300 }], sticky_settings: { }, renderer: "GOOGLE", is_amp_page: "DIALECT_HTML", amp_ad_requirement_type: "AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED", allowed_ad_types: [ALLOWED_AD_TYPE_BANNER,ALLOWED_AD_TYPE_NATIVE], session_depth: 1, internal_data: { } }], response_deadline_ms: 122, is_test: false }
نمونه پاسخ های پیشنهادی
پاسخ‌های پیشنهادی غیر ویدئویی
مثال را به من نشان بده
پاسخ سریالیid: "22i22S9494PQl819H7Ld5K" seatbid { bid { id: "2GTnPXOn76gg1C6574T" impid: "1" price: 0.24 adid: "test_creative_id_713312" adomain: "google.com" crid: "test_creative_id_713312" exp: 300 language: "xx" adm_native { ver: "1.2" assets { id: 1 title { text: "Luxury Mars Cruises" } } assets { id: 2 data { value: "Visit the planet in a luxury spaceship." } } assets { id: 3 data { value: "Book today" } } assets { id: 4 img { url: "https://native.test.com/image?id=123456" w: 1200 h: 627 } } assets { id: 5 img { url: "https://native.test.com/logo?id=123456" w: 1200 h: 1200 } } link { url: "https://www.google.com" clicktrackers: "https://native.test.com/click?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } eventtrackers { event: IMPRESSION method: IMG url: "https://test.com/event?id=123456" } privacy: "https://adssettings.google.com/whythisad?source=display&reasons=OMITTED" } [com.google.doubleclick.bid] { event_notification_token { payload: "token" } billing_id: 50577321529 third_party_buyer_token: "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" } } seat: "5249:9218:332606" } cur: "USD"
مثال را به من نشان بده
{ "id": "22i22S9494PQl819H7Ld5K", "seatbid": [ { "bid": [ { "id": "2GTnPXOn76gg1C6574T", "impid": "1", "price": 0.24, "adid": "test_creative_id_713312", "adomain": [ "google.com" ], "crid": "test_creative_id_713312", "exp": 300, "language": "xx", "ext": { "event_notification_token": { "payload": "token" }, "billing_id": "50577321529", "third_party_buyer_token": "4G79rr82Ah8r51859j2XT2RBR1BW2808IQrAa2nRjf63oo5w71y8q929t794MO75n4642HmE5HQ2B1jj9a03w6BFxc4D0mVReL1NgZ42aj7l308820m77pg004705U32AC81b7nkghu7" }, "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}},{\"id\":2,\"data\":{\"value\":\"Visit the planet in a luxury spaceship.\"}},{\"id\":3,\"data\":{\"value\":\"Book today\"}},{\"id\":4,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":1200,\"h\":627}},{\"id\":5,\"img\":{\"url\":\"https://native.test.com/logo?id=123456\",\"w\":1200,\"h\":1200}}],\"link\":{\"url\":\"https://www.google.com\",\"clicktrackers\":[\"https://native.test.com/click?id=123456\"]},\"eventtrackers\":[{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"},{\"event\":1,\"method\":1,\"url\":\"https://test.com/event?id=123456\"}],\"privacy\":\"https://adssettings.google.com/whythisad?source=display&reasons=OMITTED\"}" } ], "seat": "5249:9218:332606" } ], "cur": "USD" }
مثال را به من نشان بده
پاسخ سریالیad { adslot { id: 1 max_cpm_micros: 110734 min_cpm_micros: 0 billing_id: 74792558829 deal_id: 0 } click_through_url: "google.com" attribute: 47 attribute: 8 buyer_creative_id: "test_creative_id_907643" advertiser_name: "Google" native_ad { headline: "Luxury Mars Cruises" body: "Visit the planet in a luxury spaceship." call_to_action: "Book today" advertiser: "Galactic Luxury Cruises" image { url: "https://native.test.com/image?id=123456" width: 800 height: 800 } logo { url: "https://native.test.com/logo?id=123456" width: 200 height: 200 } price: "\342\202\254 225" click_link_url: "https://www.google.com" } impression_tracking_url: "https://test.com/imp?id=123456" impression_tracking_url: "https://test.com/imp?id=123456" ad_choices_destination_url: "https://test.com/preferences" event_notification_token: "token" dsa_transparency { buyer_render: true } } processing_time_ms: 27
پاسخ های پیشنهادی ویدیویی
bid_response { ad { ... click_through_url: "https://www.exampleDomain.com" impression_tracking_url: "https://my_impression_tracking_url.com/" ad_choices_destination_url: "https://my_ad_choices_destination_url.com/" ... native_ad { headline: "Lowest mortgage rates" video_url: "https://pubads.g.doubleclick.net/gampad/ads?sz=640x480&iu=/124319096/external/single_ad_samples&ciu_szs=300x250&impl=s&gdfp_req=1&env=vp&output=vast" call_to_action: "Get a quote" advertiser: "NY Mortgage Inc." image { url: "https://www.example.net/mypromoimage.png" width: 1200 height: 700 } logo { url: "https://www.example.net/mylogo.png" width: 200 height: 200 } click_link_url: "https://r1.example.com/r/u1dhfh3cow00/b1_googleadx/830/41972/ ?_b_ctrl=1" click_tracking_urls: "https://my_click_tracking_url.com/" } } }