Halaman ini diterjemahkan oleh Cloud Translation API.

Iklan AMPHTML melalui RTB

Halaman ini menjelaskan cara mulai menggunakan iklan AMPHTML dengan RTB. Lihat Referensi di bawah untuk mengetahui info tambahan tentang iklan dan fitur AMPHTML yang akan membantu Anda memulai.

Pendekatan tingkat tinggi

Permintaan bid RTB

Permintaan bid RTB menunjukkan apakah permintaan berasal dari halaman AMP dan persyaratan untuk iklan AMPHTML.

OpenRTB

halaman 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;
}

Persyaratan iklan AMPHTML

// 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];
}

RTB Authorized Buyers

halaman AMP

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

Persyaratan iklan AMPHTML

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

Respons bid RTB

OpenRTB

Di OpenRTB 3.0 dan Advertising Common Model yang menyertainya, beberapa tambahan untuk mendukung iklan AMPHTML disertakan dalam spesifikasi draf terbaru IAB, termasuk berikut ini.

Bid	Kolom	Atr	Jenis	Deskripsi
Permintaan	`Site.amp`	`amp`	bilangan bulat	Kolom `Site.amp` menunjukkan apakah halaman dirender di AMP, dihilangkan jika tidak diketahui: `0` = halaman non-AMP `1` = halaman dibuat dengan HTML AMP
Permintaan	`ampformat`	`rend`	bilangan bulat	Spesifikasi Format AMP menunjukkan persyaratan dan perilaku rendering untuk iklan AMPHTML: `1` = Persyaratan iklan AMP tidak diketahui `2` = Iklan AMP tidak diizinkan `3` = Iklan AMP atau iklan non-AMP diizinkan; iklan AMP tidak dirender lebih awal `4` = Iklan AMP atau iklan non-AMP diizinkan, dan iklan AMP dirender lebih awal `5` = Iklan AMP diperlukan. Iklan yang non-AMP dapat ditolak oleh penayang `500+` = Nilai khusus Bursa; harus dikomunikasikan kepada bidder a priori
Respons	`display`	`curl`	string	Dalam respons bid, `display.curl` telah ditambahkan agar dapat mengirimkan materi iklan melalui URL, termasuk dukungan untuk iklan AMPHTML. Ini adalah URL tempat markup materi iklan akan ditemukan. Berlaku untuk jenis materi iklan seperti: Iklan AMP, VAST, DAAST, dan Native. Biasanya hanya salah satu adm atau curl yang valid dalam iklan tertentu.

RTB Authorized Buyers

Kolom BidResponse.Ad.amp_ad_url dalam respons bid Authorized Buyers menerima URL yang mengarah ke konten iklan AMPHTML. Kolom yang sama ada sebagai ekstensi di objek Bid dalam implementasi 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;

Verifikasi AMPHTML yang valid

Agar iklan AMPHTML dirender lebih awal, bursa wajib memverifikasi dan menandatanganinya, yang menunjukkan bahwa iklan ditulis dalam format materi iklan <html amp4ads> amp4ads.

Iklan yang berupa AMPHTML yang valid akan diizinkan untuk dirender lebih awal oleh halaman AMP. Iklan yang tidak diverifikasi sebagai AMPHTML yang valid akan dirender dengan kecepatan yang sama seperti iklan non-AMPHTML.

Hanya iklan AMPHTML yang boleh ditampilkan di amp_ad_url.

Di masa mendatang, jika penayang hanya memerlukan iklan AMPHTML, iklan yang tidak ditandatangani sebagai AMPHTML tidak akan dirender.

Dengan Authorized Buyers, bidder akan tetap dikenai biaya jika mereka menampilkan Iklan non-AMPHTML ke slot iklan yang diperlukan iklan AMPHTML.

Pengambilan sisi server

Agar iklan AMPHTML dapat dirender lebih awal, konten iklan AMPHTML harus dirender tanpa memerlukan hop tambahan dari klien. Hal ini dirancang untuk menghindari pengalaman pengguna yang buruk karena latensi iklan dan panggilan sisi klien tambahan.

Setelah bidder memenangkan lelang, bursa akan melakukan permintaan server ke server untuk mengambil konten iklan AMPHTML yang berada di URL yang disediakan di amp_ad_url. Server materi iklan harus merespons dan menampilkan konten dalam waktu 300 milidetik.

Iklan AMPHTML yang ditampilkan dari server materi iklan akan dimasukkan ke dalam slot iklan dan kemudian dirender. Perhatikan bahwa iklan AMPHTML yang valid tidak boleh berisi iframe atau tag <amp-ad> lainnya. Lihat spesifikasi iklan AMPHTML untuk detail selengkapnya.

Fitur khusus beta: Hubungi tim akun Anda jika memerlukannya

Selama pengambilan iklan AMPHTML secara server ke server (ditentukan dalam amp_ad_url), Authorized Buyers dapat meneruskan header HTTP dan IP dari browser pengguna ke server materi iklan. Hal ini memastikan server materi iklan menerima informasi yang serupa dengan yang dikirim dari pengambilan sisi klien standar. Dalam beberapa kasus, alamat IP mungkin terpotong hanya menjadi 3 byte pertama (IPv4) atau 6 byte pertama (IPv6). Hubungi tim akun Anda jika memerlukan fitur ini. Berikut adalah contoh header HTTP:

Url: "http://amp.com"
Params {
  RequestorID: "harpoon-adx-amp-ads"
  UserAgentToSend: "Mozilla/5.0 Google-AMP"
  Referer: "amp-url.com"

  HTTPOptions {
    ExternalUserIPPacked: "12.345.67.890"
    AlwaysSendExternalUserIP: true
    Headers {
      key: "Accept-Language"
      value: "fr"
    }
    Headers {
      key: "Accept-Language"
      value: "en"
    }
  }
  CompressBody: false
}

URL pelacakan tayangan dan makro klik

Pembeli RTB sering menyertakan pelacak tayangan sebagai kolom terstruktur dalam respons bid (ini adalah Bid.burl, "URL pemberitahuan penagihan" di OpenRTB 2.5).

Dengan Authorized Buyers, parameter ini akan diaktifkan di sisi klien; amp-pixel mengaktifkan URL pelacakan saat materi iklan dirender. amp-analytics dapat menangani kasus penggunaan pelacakan lanjutan di luar rendering.

Iklan AMPHTML harus berisi makro klik yang valid dalam AMPAMP. Informasi ini biasanya akan terlihat seperti ini:

<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>

Materi iklan sering kali menyertakan piksel pencocokan cookie dalam kode materi iklan. Iklan AMPHTML dapat menggunakan komponen amp-pixel dan amp-analytics untuk kasus penggunaan ini. Jika kasus penggunaan Anda tidak dapat diakomodasi menggunakan amp-analytics atau amp-pixel, buka masalah GitHub untuk membahas opsi alternatif. Kami menyambut baik ekstensi baru yang dapat digunakan secara luas oleh berbagai perusahaan. Lihat panduan mendetail atau panduan teknis untuk membuat ekstensi baru.

Contoh URL Iklan AMP untuk pengujian

Anda dapat menggunakan contoh konten iklan AMPHTML berikut untuk pengujian:

Referensi

Project AMP dan Google telah merilis sejumlah referensi untuk membantu Anda memulai:

Membuat iklan di AMP

Spesifikasi Format Materi Iklan AMPHTML (GitHub)
Ringkasan iklan AMPHTML (GitHub)
Situs iklan AMPHTML dari Project AMP
Contoh iklan AMPHTML
Perbandingan kecepatan—Lihat seberapa cepat iklan AMPHTML dimuat dibandingkan dengan iklan biasa. Paling sering ditonton di koneksi 3G.

Proposal khusus RTB untuk IAB / OpenRTB Group

Diskusi di Forum Developer OpenRTB

Iklan AMPHTML melalui RTB

Pendekatan tingkat tinggi

Permintaan bid RTB

OpenRTB

halaman AMP

Persyaratan iklan AMPHTML

RTB Authorized Buyers

halaman AMP

Persyaratan iklan AMPHTML

Respons bid RTB

OpenRTB

RTB Authorized Buyers

Verifikasi AMPHTML yang valid

Pengambilan sisi server

Fitur khusus beta: Hubungi tim akun Anda jika memerlukannya

URL pelacakan tayangan dan makro klik

Pencocokan cookie

Contoh URL Iklan AMP untuk pengujian

Referensi