آگهی‌های بومی

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

آگهی‌های بومی هم برای «خریداران مجاز» و هم برای «مناقصه باز» پشتیبانی می‌شود.

گردش کار آگهی‌های بومی به این صورت است:

  1. درخواستی برای آگهی بومی به Google ارسال می‌شود. فراخوانی یک یا هر دو الگوی آگهی بومی زیر را مشخص می‌کند که هرکدام فیلدهای بومی ترجیحی را مشخص می‌کنند.
  2. Google درخواست پیشنهاد قیمت RTB حاوی فهرستی از فیلدهای درخواستی را برای خریداران ارسال می‌کند.
  3. خریداران علاقه‌مند با فیلدهای درخواست‌شده پاسخ می‌دهند.
  4. Google مزایده‌ای را برای انتخاب پیشنهاد قیمت برنده اجرا می‌کند و دارایی‌های خلاقانه ارائه‌شده توسط خریدار را به ناشر ارسال می‌کند.
  5. ناشر دارایی‌ها را در یک آگهی بومی جمع‌آوری می‌کند و آن‌ها را به‌گونه‌ای طراحی می‌کند که با طراحی سایت مطابقت داشته باشند.

قالب‌های پیام

Google از مشخصات OpenRTB در هر دو قالب JSON و Protobuf پشتیبانی می‌کند.

برای آگهی‌های بومی OpenRTB Protobuf، فیلدهای زیر با مشخصات تفاوت دارند:

(قالب) JSON نوع JSON Protobuf نوع Protobuf
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 پر کند، درغیراین‌صورت از مزایده فیلتر خواهد شد.

وقتی پیشنهادی شامل آگهی بومی ارائه می‌دهید، نقطه پایانی پیشنهاد قیمت شما باید دارایی‌های الزامی و هرگونه دارایی اختیاری را که انتخاب می‌کنید در فیلد BidResponse.seatbid.bid.{adm/adm_native}.assets گنجانده شود مشخص کند. دارایی‌های ارسال‌شده در پاسخ باید شامل مقدار id مربوطه باشد که در درخواست پیشنهاد قیمت مشخص شده است. از id برای ساختاردهی الگو و متمایز کردن انواع مشابه دارایی‌ها، مانند تصاویر اصلی و نمادها، استفاده می‌شود. مثال زیر نشان می‌دهد که چگونه اشیاء NativeRequest و NativeResponse در قالب‌های OpenRTB و JSON پر می‌شوند:

OpenRTB JSON (تجزیه‌شده)

NativeRequest
{
  "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,
      "required": 1,
      "img": {
        "type": 1,
        "wmin": 100,
        "hmin": 100
      }
    },
    {
      "id": 6,
      "data": {
        "type": 3,
        "len": 5
      }
    },
    {
      "id": 7,
      "data": {
        "type": 6
      }
    }
  ],
  "eventtrackers": [
    {
      "event": 1,
      "methods": [
        1
      ]
    }
  ]
}

NativeResponse
{
  "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": 100,
        "h": 100
      }
    },
    {
      "id": 5,
      "img": {
        "url": "https://native.test.com/icon?id=123456",
        "w": 200,
        "h": 200
      }
    }
  ],
  "link": {
    "url": "https://www.google.com",
    "clicktrackers": [
      "https://native.test.com/click?id=123456"
    ]
  },
  "imptrackers": [
    "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
  ]
}

OpenRTB Protobuf

NativeRequest
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
    required: true
    img {
      type: ICON
      wmin: 100
      hmin: 100
    }
  }
  assets {
    id: 6
    data {
      type: RATING
      len: 5
    }
  }
  assets {
    id: 7
    data {
      type: PRICE
    }
  }
  eventtrackers {
    event: IMPRESSION
    methods: IMG
  }
}

NativeResponse
adm_native {
  assets {
    id: 1
    required: true
    title {
      text: "Luxury Mars Cruises"
    }
  }
  assets {
    id: 2
    required: true
    data {
      value: "Visit the planet in a luxury spaceship."
    }
  }
  assets {
    id: 3
    data {
      value: "Book today"
    }
  }
  assets {
    id: 4
    required: true
    img {
      url: "https://native.test.com/image?id=123456"
      w: 1200
      h: 627
    }
  }
  assets {
    id: 5
    required: true
    img {
      url: "https://native.test.com/icon?id=123456"
      w: 128
      h: 128
    }
  }
  assets {
    id: 6
    data {
      value: "5"
    }
  }
  link {
    url: "https://www.google.com"
    clicktrackers: "https://native.test.com/click?id=123456"
  }
  imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
}

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

الگوهای آگهی بومی

الگوهای آگهی بومی اجزای آگهی بومی را توصیف می‌کنند و محتوا و ساختار NativeRequest را در درخواست پیشنهاد قیمت تعیین می‌کنند. Google از دو الگوی آگهی بومی رایج برای آگهی‌های بومی غیرویدیویی و ویدیویی پشتیبانی می‌کند:

الگوهای دیگری وجود دارد و ممکن است مجموعه متفاوتی از الزامات برای فیلدها، ابعاد، و اندازه‌ها داشته باشند.

الگوی آگهی نصب برنامه

جدول‌های زیر فیلدهایی را نشان می‌دهند که با برچسب الزامی یا توصیه‌شده مشخص شده‌اند. قوانین زیر اعمال می‌شود:

  • فیلدهایی که با الزامی علامت‌گذاری شده‌اند، برای پیشنهاددهنده الزامی هستند.
  • فیلدهای علامت‌گذاری‌شده با توصیه‌شده برای پیشنهاددهنده الزامی نیستند و ناشر ممکن است آن‌ها را درصورت ارائه نمایش دهد یا ندهد (برای مثال، رده‌بندی ستاره‌ای).
  • «دعوت به اقدام» (CTA) همیشه به‌عنوان توصیه‌شده علامت‌گذاری می‌شود زیرا اگر پیشنهاددهنده آن را ارسال نکند، مقدار پیش‌فرضی به آن اختصاص داده می‌شود، اما اگر ارسال شود، همیشه نمایش داده خواهد شد.

جدول زیر فیلدهای الگوی آگهی نصب برنامه را فهرست می‌کند. برنامه‌های تلفن همراه از این فیلدها برای ایجاد آگهی‌های نصب برنامه به زبان اصلی دستگاه استفاده می‌کنند.

فیلد شرح الزامی یا توصیه‌شده؟ همیشه نمایش داده شود؟ اندازه تصویر توصیه‌شده/ حداکثر تعداد نویسه‌ها مثال
Headline عنوان برنامه الزامی بله ‫۲۵ نویسه Flood-It!
تصویر نماگرفتی از برنامه یا تصویر مرتبط دیگری الزامی نه ۱٬۲۰۰ پیکسل در ۶۲۷ پیکسل یا ۶۰۰ پیکسل در ۶۰۰ پیکسل بسته به نسبت ابعادی که ناشر درخواست کرده است. <نماگرفتی از بازی Flood-It!‎>
بدن نوشتار اصلی برنامه الزامی نه ۹۰ نویسه ساده فریبنده + چالش وسوسه‌انگیز = اعتیادآور لذت‌بخش!
نماد برنامه نماد برنامه الزامی نه ۱۲۸ × ۱۲۸ پیکسل <نماد برنامه Flood-it!‎>
دعوت به اقدام کنش کاربر ترجیحی توصیه‌شده بله ‫۱۵ نویسه نصب
رده‌بندی با ستاره تعداد ستاره‌ها (۰ تا ۵) که نشان‌دهنده رده‌بندی برنامه در فروشگاه برنامه است توصیه‌شده نه ۰ تا ۵ ۴٫۵
قیمت هزینه برنامه توصیه‌شده نه ‫۱۵ نویسه رایگان

یادداشت‌هایی درباره طول نوشتار

اگر خریدار دارایی نوشتاری (مثلاً متن اصلی) ارسال کند که طولانی‌تر از حداکثر تعداد نویسه پیشنهادی باشد، ممکن است نوشتار توسط Google یا ناشر کوتاه شود و با سه‌نقطه نشان داده شود. توجه داشته باشید که محدودیت‌های کوتاه کردن در زبان‌های چینی، ژاپنی، و کره‌ای نصف اندازه است. برای مثال، حد عنوان برای انگلیسی ۹۰ و برای چینی ۴۵ است.

یادداشت‌هایی درباره اندازه تصویر

ناشران مجازند:

  • تصویر اصلی را به‌صورت متقارن تا ۲۰٪ در یک بعد (ارتفاع یا عرض) برش دهید.
  • تصویر را بدون تغییر دادن نسبت ابعادی آن مقیاس‌بندی کنید.
  • تصاویری که نسبت ابعادی آن‌ها تفاوت قابل‌توجهی با نسبت ابعادی حاصل از ارتفاع و عرض دارد ممکن است فیلتر شوند.

الگوی آگهی محتوا

جدول زیر فیلدهای الگوی آگهی محتوا را فهرست می‌کند. ناشران از این فیلدها برای ایجاد آگهی‌های محتوای بومی استفاده می‌کنند.

فیلد شرح الزامی یا توصیه‌شده؟ همیشه نمایش داده شود؟ اندازه تصویر توصیه‌شده/ حداکثر تعداد نویسه * مثال
Headline سرصفحه آگهی الزامی بله ‫۲۵ نویسه پایین‌ترین نرخ سود وام مسکن
تصویر تصویر اصلی آگهی الزامی نه ۱٬۲۰۰ پیکسل در ۶۲۷ پیکسل یا ۶۰۰ پیکسل در ۶۰۰ پیکسل بسته به نسبت ابعادی که ناشر درخواست کرده است. <تصویر اصلی آگهی>
بدن محتوای آگهی الزامی نه ۹۰ نویسه خانه شیرین شما در بروکلین - ارزان‌تر و زودتر از آنچه فکر می‌کنید!
نشان‌واره نشان‌واره آگهی‌دهنده یا تصویر کوچک مرتبط دیگر توصیه‌شده نه ۱۲۸ × ۱۲۸ پیکسل <لوگوی NY Mortgage Inc.‎>
دعوت به اقدام کنش ترجیحی کاربر توصیه‌شده نه ‫۱۵ نویسه پیشنهاد قیمت را دریافت کنید
آگهی‌دهنده نوشتاری که آگهی‌دهنده یا نمانام را مشخص می‌کند الزامی نه ‫۲۵ نویسه NY Mortgage Inc.

الگوی آگهی نصب برنامه ویدیو

فیلد شرح الزامی یا توصیه‌شده؟ همیشه نمایش داده شود؟ اندازه تصویر توصیه‌شده/ حداکثر تعداد نویسه * مثال
ویدیو پاسخ VAST ویدیو حاوی همه دارایی‌های لازم برای بازپخش آگهی ویدیویی. الزامی نه - نشانی وب به VAST XML حاوی Flood-It!‎ آگهی ویدیویی
Headline عنوان برنامه الزامی بله ‫۲۵ نویسه Flood-It!
تصویر تصویر (ریزعکس) نشان داده شده در پخش‌کننده قبل از کلیک روی آگهی ویدیویی یا در حین بارگیری آن. الزامی نه باید با نسبت ابعادی ویدیو مطابقت داشته باشد (برای مثال: ۱۲۸۰x۷۲۰ برای ویدیو ۱۶x۹، ۴x۳ برای ویدیو ۶۴۰x۴۸۰). نماگرفتی از بازی Flood-It! یا از ویدیو
بدن نوشتار اصلی برنامه الزامی نه ۹۰ نویسه ساده فریبنده + چالش وسوسه‌انگیز = اعتیادآور لذت‌بخش!
نماد برنامه نماد برنامه الزامی نه ۱۲۸ × ۱۲۸ پیکسل نماد برنامه Flood-it!
دعوت به اقدام کنش کاربر ترجیحی الزامی بله ‫۱۵ نویسه نصب
رده‌بندی با ستاره تعداد ستاره‌ها (۰ تا ۵) که نشان‌دهنده رده‌بندی برنامه در فروشگاه برنامه است توصیه‌شده نه ۰ تا ۵ ۴٫۵
قیمت هزینه برنامه توصیه‌شده نه ‫۱۵ نویسه رایگان

محدودیت‌ها

  • ویدیو: همه ویدیوها باید به‌شکل نشانی وب VAST یا برچسب VAST باشند. فایل ویدیویی خام مانند WebM،‏ MP4، و غیره نمی‌تواند مشخص شود.

  • طول نوشتار: اگر خریدار دارایی نوشتاری‌ای مثل body را در پاسخ مشخص کند، ممکن است Google یا ناشر آن را کوتاه کند و با سه‌نقطه نشان دهد. توجه داشته باشید که محدودیت‌های کوتاه کردن در زبان‌های چینی، ژاپنی، و کره‌ای نصف اندازه است. برای مثال، حد عنوان در زبان انگلیسی ۹۰ و در زبان چینی ۴۵ است.

  • اندازه تصویر: ناشران مجازند:

    • تصویر اصلی را به‌صورت متقارن تا ۲۰٪ در یک بعد (ارتفاع یا عرض) برش دهید.
    • تصویر را بدون تغییر دادن نسبت ابعادی آن مقیاس‌بندی کنید.

نمونه آگهی نصب برنامه

ویدیو بومی

الگوی آگهی محتوای ویدیویی

فیلد شرح الزامی یا توصیه‌شده؟ همیشه نمایش داده شود؟ اندازه تصویر توصیه‌شده/ حداکثر تعداد نویسه * مثال
ویدیو پاسخ VAST ویدیو حاوی همه دارایی‌های لازم برای بازپخش آگهی ویدیویی. الزامی بله - نشانی وب به VAST XML حاوی Flood-It!‎ آگهی ویدیویی
Headline سرصفحه آگهی الزامی بله ‫۲۵ نویسه پایین‌ترین نرخ سود وام مسکن
تصویر تصویر (ریزعکس) نشان داده شده در پخش‌کننده قبل از کلیک روی آگهی ویدیویی یا در حین بارگیری آن. الزامی نه باید با نسبت ابعادی ویدیو مطابقت داشته باشد (برای مثال: ۱۲۸۰x۷۲۰ برای ویدیو ۱۶x۹، ۴x۳ برای ویدیو ۶۴۰x۴۸۰). نماگرفتی از ویدیو
بدن محتوای آگهی الزامی نه ۹۰ نویسه خانه شیرین شما در بروکلین - ارزان‌تر و زودتر از آنچه فکر می‌کنید!
نشان‌واره نشان‌واره آگهی‌دهنده یا تصویر کوچک مرتبط دیگر توصیه‌شده نه ۱۲۸ × ۱۲۸ پیکسل نشان‌واره NY Mortgage Inc.‎
دعوت به اقدام کنش ترجیحی کاربر الزامی نه ‫۱۵ نویسه پیشنهاد قیمت را دریافت کنید
آگهی‌دهنده نوشتاری که آگهی‌دهنده یا نمانام را مشخص می‌کند الزامی نه ‫۲۵ نویسه NY Mortgage Inc.

فیلدهای متا

فیلدهای متا زیر در همه الگوهای آگهی پشتیبانی‌شده مشترک هستند:

فیلد شرح
BidResponse.seatbid.bid.{adm/adm_native}.link.url

نشانی وب صفحه مقصد نهایی که کاربر پس‌از کلیک کردن روی آگهی به آن هدایت می‌شود. درصورت استفاده از صفحه‌های مقصد پویا، استفاده از این فیلد الزامی است.

BidResponse.seatbid.bid.{adm/adm_native}.link.clicktrackers اختیاری. نشانی‌های وب اضافی که به تبلیغ‌کنندگان اجازه می‌دهد کلیک‌های کاربر روی آگهی را ردیابی کنند.
BidResponse.seatbid.bid.{adm/adm_native}.privacy پیوند به صفحه اولویت‌های آگهی یا انصراف. اگر وجود داشته باشد، نماد AdChoices استاندارد به طرح آگهی بومی اضافه می‌شود و به این نشانی وب پیوند داده می‌شود.
BidResponse.seatbid.bid.{adm/adm_native}.eventtrackers ردگیری ظهور را می‌توان با گنجاندن eventtrackers در پاسخ بومی انجام داد، که در آن event روی IMPRESSION تنظیم شده است.

نمایش الگوی آگهی بومی در درخواست قیمت پیشنهادی

هنگام دریافت درخواست پیشنهاد قیمت حاوی فضای آگهی بومی، این درخواست حاوی الگوی آگهی بومی خواهد بود که با پیام NativeRequest OpenRTB نشان داده می‌شود. این گزارش اطلاعات زیر را درباره فضای آگهی بومی ارائه می‌دهد:

  • دارایی‌هایی که اختیاری یا الزامی هستند.
  • ابعاد تصاویر، نشان‌واره‌ها، و نمادهای برنامه.
  • مشخصات سبکی که آگهی در آن ارائه می‌شود.

دارایی‌های اختیاری و الزامی

می‌توانید دارایی‌های اختیاری و الزامی برای ظهور آگهی بومی را در BidRequest.imp.native.{request/request_native}.assets پیدا کنید. این مؤلفه‌های آگهی بومی را توصیف می‌کند، مثل عنوان، متن، یا نشان‌واره. هر دارایی موجود در درخواست دارای id متمایز است و required را به‌عنوان True برای مواردی که باید در پاسخ پیشنهاد قیمت گنجانده شوند، پر می‌کند.

نمایش آگهی بومی در پاسخ پیشنهاد قیمت

هنگام پیشنهاد قیمت برای فضای آگهی بومی، باید NativeResponse را که با دارایی‌های الزامی مشخص‌شده در درخواست پیشنهاد قیمت پر شده است اضافه کنید، و همچنین می‌توانید هر دارایی اختیاری مشخص‌شده را اضافه کنید. می‌توانید این موارد را در پاسخ پیشنهاد قیمت با BidResponse.seatbid.bid.{adm/adm_native}.assets اضافه کنید. وقتی assets را در پاسخ پر می‌کنید، هرکدام باید شامل id مربوط به آن دارایی از درخواست پیشنهاد قیمت باشد.

نمونه درخواست‌های پیشنهاد قیمت

OpenRTB Protobuf

OpenRTB JSON

نمونه پاسخ‌های قیمت پیشنهادی

OpenRTB Protobuf

OpenRTB JSON