الإعلانات التي تستخدم رمز HTML لصفحات AMP عبر عرض الأسعار في الوقت الفعلي (RTB)

توضح هذه الصفحة كيفية البدء في استخدام إعلانات AMPHTML مع عرض الأسعار في الوقت الفعلي (RTB). يُرجى الاطّلاع على المراجع أدناه للحصول على معلومات إضافية. حول إعلانات وأدوات AMPHTML لمساعدتك على البدء.

نهج عالي المستوى

طلب عرض سعر "عرض الأسعار في الوقت الفعلي" (RTB)

يشير طلب عرض سعر العرض في الوقت الفعلي إلى ما إذا كان الطلب صادرًا من صفحة AMP ومتطلبات إعلانات AMPHTML.

OpenRTB

صفحة AMP

message SiteExt {
  enum AmpPage {
    // This is not an AMP page.
    DIALECT_HTML = 0;

    // This is an Amp page.
    DIALECT_HTML_AMP = 1;
  }

  // Whether this is an AMP page or not. Omitted if unknown.
  optional AmpPage amp = 1;
  enum VisibilityState {
    VISIBILITY_STATE_UNKNOWN = 0;

    // The page is at least partially visible. For example, in the foreground
    // tab of a non-minimized window.
    VISIBILITY_STATE_VISIBLE = 1;

    // The page is not visible to users. For example, when the page is in a
    // background browser tab, or in a minimized window.
    VISIBILITY_STATE_HIDDEN = 2;
  }

  // The visibility state of the web page containing the ad slot.
  // See https://www.w3.org/TR/page-visibility/.
  // [AdX: BidRequest.page_visibility]
  optional VisibilityState page_visibility = 2 [default =
    VISIBILITY_STATE_UNKNOWN];

  // Information about a browser window's user activation state. See
  // https://html.spec.whatwg.org/multipage/interaction.html#the-useractivation-interface.
  message UserActivation {
    // Indicates whether a user has completed an interaction since page load.
    optional bool wasact = 1;

    // Indicates whether a user is currently interacting with the page.
    optional bool isact = 2;
  }

  // User activation information from the browser for the current request, if
  // the request is for a web page.
  optional UserActivation uact = 5;

  // The set of possible web navigation types that predicate a page load. Each
  // of these types may have different performance characteristics. For example,
  // users going back and forth might experience a faster site than users
  // performing navigation for the first time or submitting forms. See
  // https://w3c.github.io/navigation-timing/#dom-performancenavigationtiming-type.
  enum NavigationType {
    NAVIGATION_TYPE_UNKNOWN = 0;

    // Navigation started by clicking a link, entering the URL in the browser's
    // address bar, form submission, or initializing through a script operation
    // other than reload and back_forward.
    NAVIGATION_TYPE_NAVIGATE = 1;

    // Navigation is through the browser's reload operation, location.reload(),
    // or a Refresh pragma directive like
    // <meta http-equiv="refresh" content="300">.
    NAVIGATION_TYPE_RELOAD = 2;

    // Navigation is through the browser's history traversal operation.
    NAVIGATION_TYPE_BACK_FORWARD = 3;

    // Navigation is initiated by a prerender hint (deprecated). See
    // https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel/prerender.
    NAVIGATION_TYPE_PRERENDER = 4;
  }

  // The type of browser navigation that led to the current page. Unset for
  // non-web ad requests.
  optional NavigationType ntype = 6;

  // Indicates that the request is using semi-transparent branding,
  // which means only a truncated version of the request URL will
  // be provided. This decision is made by the publisher, see
  // https://support.google.com/admanager/answer/4584891#urls for context.
  optional bool is_semi_transparent_request = 3;

  // The domain of the partner (of the site owner) with ownership
  // of some portion of ad inventory on the site. The partner's ads.txt file
  // will be hosted here. More detail at
  // http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf
  optional string inventorypartnerdomain = 4;
}

متطلبات الإعلانات التي تستخدم رمز HTML لصفحات AMP

// Ad Exchange extensions for the Imp object.
message ImpExt {
...
  // Possible requirement types for AMP ads.
  enum AmpAdRequirementType {
    // AMP ad requirements unknown.
    UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 1;
    // AMP ads are not allowed.
    AMP_AD_NOT_ALLOWED = 2;
    // Either AMP ads or non-AMP ads are allowed;
    // AMP ads are not early rendered.
    AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 3;
    // Either AMP ads or non-AMP ads are allowed;
    // AMP ads are early rendered.
    AMP_AD_ALLOWED_AND_EARLY_RENDERED = 4;
    // AMP ads are required.
    // Ads that are non-AMP may be rejected by the publisher.
    AMP_AD_REQUIRED = 5;
    // Exchange-specific values above 500.
  }
  optional AmpAdRequirementType ampad = 8
    [default = UNKNOWN_AMP_AD_REQUIREMENT_TYPE];
}

عرض الأسعار في الوقت الفعلي للشراة المعتمَدين

صفحة AMP

// Whether this is an AMP page or not.
enum AmpPage {
  // AMP page status unknown.
  UNKNOWN_AMP_PAGE = 0;

متطلبات الإعلانات التي تستخدم رمز HTML لصفحات AMP

// Possible requirement types for AMP ads.
enum AmpAdRequirementType {
  // AMP ad requirements unknown.
  UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0;

استجابة عرض السعر في الوقت الفعلي (RTB)

OpenRTB

في OpenRTB 3.0 والإعلانات المصاحبة له في ما يتعلّق بالنموذج الشائع، يتم تضمين عدّة إضافات لإتاحة إعلانات AMPHTML في أحدث مسودة المواصفات الصادرة عن مكتب IAB، بما في ذلك ما يلي.

عرض السعر الحقل السمة النوع الوصف
الطلب Site.amp amp عدد صحيح يشير الحقل Site.amp إلى ما إذا كان سيتم عرض الصفحة أم لا في صفحات AMP، يتم حذفها إذا كانت غير معروفة:
0 = الصفحة ليست بتنسيق AMP
تم إنشاء الصفحة 1 باستخدام رمز HTML لصفحات AMP.
الطلب ampformat rend عدد صحيح تشير مواصفات تنسيق AMP إلى المتطلبات والعرض السلوك لإعلانات AMPHTML:
1 = متطلبات إعلانات AMP غير معروفة
2 = لا يُسمح بإعلانات AMP
3 = يُسمح بإعلانات AMP أو الإعلانات التي ليست بتنسيق AMP؛ لا يتم عرض إعلانات AMP مبكرًا
4 = يُسمح بإعلانات AMP أو الإعلانات التي ليست بتنسيق AMP، ويتم عرض إعلانات AMP مبكرًا
5 = إعلانات AMP مطلوبة. قد يرفض الناشر الإعلانات التي ليست بتنسيق AMP
500+ = القيم الخاصة بـ Exchange، إعلام مقدِّمي عروض الأسعار مسبقًا
الرد display curl سلسلة في استجابة عرض السعر، تمت إضافة display.curl لتتمكن من الإرسال المواد الإبداعية من خلال عنوان URL، بما في ذلك دعم إعلانات AMPHTML.
هذا هو عنوان URL الذي سيتم العثور على ترميز تصميم الإعلان عليه. تنطبق على أنواع تصاميم الإعلانات، مثل: إعلانات AMP وVAST وDAAST والإعلانات المدمجة مع المحتوى. عادةً ما يكون واحد فقط من adm أو curl صالحًا في إعلان معين.

عرض الأسعار في الوقت الفعلي للشراة المعتمَدين

الحقل BidResponse.Ad.amp_ad_url في عرض سعر "الشراة المعتمَدون" الردود على عنوان URL يشير إلى محتوى إعلان AMPHTML. يتوفّر الحقل نفسه. كإضافة في كائن Bid في بروتوكول OpenRTB من Google التنفيذ.

// The URL to fetch an AMPHTML ad. Only one of the following should be set:
// html_snippet, video_url, amp_ad_url, native_ad.
optional string amp_ad_url = 23;

إثبات صحة رمز HTML لصفحات AMP

لعرض إعلانات AMPHTML مبكرًا، يجب التبادل للتحقّق من ذلك لتوقيعها، للإشارة إلى أنّ الإعلان مكتوب بتنسيق تصميم الإعلان <html amp4ads> في amp4ads.

سيُسمح بعرض الإعلانات التي تكون رمز HTML لصفحات AMP صالحة بالظهور مبكرًا بواسطة صفحات AMP. الإعلانات إذا لم يتم التحقق من أنها صفحات AMPHTML صالحة، سيتم عرضها بالسرعة نفسها الإعلانات التي ليست رمز HTML لصفحات AMP

يجب عرض إعلانات AMPHTML فقط في amp_ad_url.

في المستقبل، إذا كان الناشر يطلب إعلانات AMPHTML فقط، لن يتم وضع علامة على الإعلانات لن يتم عرض رمز HTML لصفحات AMP.

من خلال برنامج "الشراة المعتمَدون"، سيستمر تحصيل الرسوم من مقدِّمي عروض الأسعار في حال إرجاع إعلان ليس رمز HTML لصفحات AMP في مساحة إعلانية مطلوبة لإعلان AMPHTML.

الجلب من جهة الخادم

لكي يتم عرض إعلانات AMPHTML مبكرًا، يجب عرض محتوى إعلان AMPHTML دون الحاجة إلى قفزات إضافية من العميل. تم تصميم هذا لتجنب تجارب المستخدمين السيئة بسبب وقت استجابة الإعلانات والمكالمات الإضافية من جهة العميل.

بعد فوز مقدِّم عرض السعر بالمزاد، ستُجري البورصة طلب من خادم إلى خادم لاسترداد محتوى إعلان AMPHTML الموجود على عنوان URL المقدمة في amp_ad_url. يجب أن تستجيب خوادم تصميمات الإعلانات وتعرضها المحتوى خلال 300 ملي ثانية.

إعلان AMPHTML المعروض من خادم تصميم الإعلان سيتم إدخاله في الشريحة الإعلانية وعرضها لاحقًا تجدر الإشارة إلى أنّه لا يمكن أن يحتوي إعلان AMPHTML صالح على إطارات iframe أو علامات <amp-ad> أخرى الاطّلاع على رمز HTML لصفحات AMP مواصفات الإعلانات لمزيد من التفاصيل.

الميزة التجريبية فقط: يمكنك التواصل مع فريق حسابك إذا كنت بحاجة إلى هذه الميزة

أثناء استرداد إعلان AMPHTML من خادم إلى خادم (المحدّد في amp_ad_url)، يجوز للشراة المعتمَدين تمرير عنوان HTTP وعنوان IP. من متصفّح المستخدم إلى خادم تصميم الإعلان يضمن ذلك تصميم الإعلان معلومات مشابهة لتلك التي يتم إرسالها من جهة العميل القياسية جلب. في بعض الحالات، قد يتم اقتطاع عنوان IP إلى أول 3 بايت فقط (IPv4) أو أول 6 بايت (IPv6). يُرجى التواصل مع فريق الحساب إذا كنت بحاجة إلى ذلك. الجديدة. وفي ما يلي نموذج لعنوان HTTP:

عناوين URL لتتبع مرات الظهور ووحدات ماكرو النقرات

غالبًا ما يشتمل مشترو عروض الأسعار في الوقت الفعلي (RTB) على أدوات تتبع مرات الظهور كحقل منظم في استجابة عرض السعر (هذا هو Bid.burl، "عنوان URL لإشعار الفوترة" في OpenRTB 2.5).

وعند التعامل مع برنامج "الشراة المعتمَدون"، سيتم فصلهم من العمل من جهة العميل. amp-pixel تطلق عناوين URL للتتبّع عند عرض تصميم الإعلان. amp-analytics معالجة حالات استخدام التتبّع الأكثر تقدّمًا التي تتجاوز العرض

يجب أن تحتوي إعلانات AMPHTML على وحدة ماكرو للنقرات صالحة في رمز HTML لصفحات AMP سيكون هذا عادة في شكل شيء مثل هذا:

<a href="%%CLICK_URL_UNESC%%http%3A%2F%2my.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a>
<a href=”https://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%”></a>

تتضمن تصميمات الإعلانات غالبًا ملفات تعريف الارتباط مطابقة وحدات البكسل في رمز التصميم. يمكن أن تستخدم إعلانات AMPHTML amp-pixel وamp-analytics مكونات لحالة الاستخدام هذه. إذا تعذر ملاءمة حالة الاستخدام باستخدام amp-analytics أو amp-pixel، افتح مشكلة في GitHub لمناقشتها خيارات بديلة. نرحّب بالإضافات الجديدة التي يمكن أن يستخدمها على نطاق واسع عدد من الشركات المختلفة. عرض تفصيل الإرشادات أو الفنية الدليل لإنشاء إضافة جديدة.

نماذج عناوين URL لإعلانات AMP لأغراض الاختبار

يمكنك استخدام النموذج التالي لمحتوى إعلان AMPHTML للاختبار:

الموارد

أصدر مشروع AMP وGoogle عددًا من الموارد لمساعدتك على البدء:

إنشاء إعلانات بتنسيق AMP
عروض خاصة بعرض الأسعار في الوقت الفعلي (RTB) إلى IAB / OpenRTB Group