Quảng cáo gốc

Quảng cáo gốc là quảng cáo được định dạng để phù hợp với nội dung và thiết kế trực quan xung quanh, làm tăng khả năng người dùng xem và nhấp vào quảng cáo hơn. Khoảng không quảng cáo quảng cáo gốc có trên ứng dụng di động cũng như trang web dành cho máy tính và thiết bị di động. Để biết thêm thông tin về quảng cáo gốc, hãy xem bài viết Tổng quan về quảng cáo gốc.

Quảng cáo gốc được hỗ trợ cho cả Authorized Buyers và tính năng Đặt giá thầu mở.

Sau đây là quy trình làm việc cho quảng cáo gốc:

Một lệnh gọi cho quảng cáo gốc được gửi đến Google. Lệnh gọi chỉ định một hoặc cả hai mẫu quảng cáo gốc sau đây, mỗi mẫu chỉ định các trường gốc ưu tiên.
Google gửi cho người mua một yêu cầu giá thầu RTB chứa danh sách các trường đang được yêu cầu.
Người mua quan tâm sẽ phản hồi bằng các trường được yêu cầu.
Google chạy một phiên đấu giá để chọn giá thầu giành chiến thắng và gửi các thành phần mẫu quảng cáo do người mua cung cấp cho nhà xuất bản.
Nhà xuất bản tập hợp các thành phần thành một quảng cáo gốc và tạo kiểu cho quảng cáo đó để phù hợp với thiết kế của trang web.

Định dạng thư

Google hỗ trợ quy cách OpenRTB ở cả định dạng JSON và Protobuf.

Đối với quảng cáo gốc OpenRTB Protobuf, các trường sau đây khác với quy cách:

JSON	Loại JSON	Protobuf	Loại Protobuf
`BidRequest.imp[].native.request`	`string`	`BidRequest.imp[].native.request_native`	`NativeRequest`
`BidResponse.seatbid[].bid[].adm`	`string`	`BidResponse.seatbid[].bid[].adm_native`	`NativeResponse`

Các trường OpenRTB Protobuf là thông báo Protobuf chứ không phải chuỗi.

Nếu bạn sử dụng việc triển khai OpenRTB Protobuf, điểm cuối của bạn sẽ nhận được các yêu cầu giá thầu chứa BidRequest.imp.native.request_native thay vì BidRequest.imp.native.request. Ngoài ra, điểm cuối của bạn phải trả về các phản hồi giá thầu điền sẵn BidResponse.seatbid.bid.adm_native thay vì BidResponse.seatbid.bid.adm, nếu không, điểm cuối đó sẽ bị lọc khỏi phiên đấu giá.

Khi đặt giá thầu bao gồm quảng cáo gốc, điểm cuối đặt giá thầu của bạn phải chỉ định các thành phần bắt buộc và mọi thành phần không bắt buộc mà bạn chọn đưa vào trường BidResponse.seatbid.bid.{adm/adm_native}.assets. Các thành phần được gửi trong phản hồi phải bao gồm giá trị id tương ứng được chỉ định trong yêu cầu giá thầu. id được dùng để cấu trúc mẫu và phân biệt các loại thành phần tương tự như hình ảnh chính và biểu tượng. Ví dụ sau đây cho thấy cách các đối tượng NativeRequest và NativeResponse được điền sẵn ở định dạng OpenRTB và JSON:

JSON OpenRTB (đã phân tích cú pháp)

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

Nếu sử dụng SDK của bên mua để hiển thị quảng cáo gốc, bạn phải thêm một hình ảnh type vào declared_ad khi gửi mẫu quảng cáo để xem xét.

Mẫu quảng cáo gốc

Mẫu quảng cáo gốc mô tả các thành phần của quảng cáo gốc và xác định nội dung cũng như cấu trúc của NativeRequest trong yêu cầu đặt giá thầu. Google hỗ trợ 2 mẫu quảng cáo gốc phổ biến nhất cho quảng cáo gốc dạng video và không phải dạng video:

Mẫu quảng cáo cài đặt ứng dụng – Quảng bá và thúc đẩy lượt cài đặt ứng dụng di động.
Mẫu quảng cáo nội dung – Kết hợp chung hơn giữa văn bản và hình ảnh cho quảng cáo thương hiệu hoặc quảng cáo trên web.
Mẫu quảng cáo cài đặt ứng dụng dạng video
Mẫu quảng cáo dạng video trong nội dung

Ngoài ra còn có các mẫu khác và có thể có một bộ yêu cầu khác về trường, phương diện và kích thước.

Mẫu quảng cáo cài đặt ứng dụng

Các trường bắt buộc và nên dùng

Các bảng sau đây cho thấy những trường được gắn nhãn Bắt buộc hoặc Nên có. Các quy tắc sau được áp dụng:

Các trường được đánh dấu là Bắt buộc là những trường mà bên đặt giá thầu phải điền.
Các trường được đánh dấu là Nên dùng không bắt buộc đối với bên đặt giá thầu và nhà xuất bản có thể hiển thị hoặc không hiển thị các trường này nếu được cung cấp (ví dụ: điểm xếp hạng bằng sao).
Lời kêu gọi hành động (CTA) luôn được đánh dấu là Được đề xuất vì giá trị mặc định sẽ được chỉ định nếu bên đặt giá thầu không gửi giá trị này, nhưng giá trị này sẽ luôn hiển thị nếu được gửi.

Bảng sau đây liệt kê các trường của mẫu quảng cáo cài đặt ứng dụng. Ứng dụng di động sử dụng các trường này để tạo quảng cáo gốc cài đặt ứng dụng.

Trường	Mô tả	Bắt buộc hay nên dùng?	Luôn hiển thị?	Kích thước hình ảnh/số ký tự tối đa được đề xuất	Ví dụ:
Dòng tiêu đề	Tiêu đề ứng dụng	Bắt buộc	Có	25 ký tự	Flood-It!
Hình ảnh	Ảnh chụp màn hình trong ứng dụng hoặc một hình ảnh khác có liên quan	Bắt buộc	Không	1.200 px x 627 px hoặc 600 px x 600 px,tuỳ thuộc vào tỷ lệ khung hình mà nhà xuất bản yêu cầu.	<Ảnh chụp màn hình trò chơi Flood-It!>
Nội dung	Văn bản chính của ứng dụng	Bắt buộc	Không	90 ký tự	Đơn giản nhưng đầy thử thách = gây nghiện một cách thú vị!
Biểu tượng ứng dụng	Biểu tượng ứng dụng	Bắt buộc	Không	128 x 128 px	<Biểu tượng ứng dụng Flood-it!>
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Đề xuất	Có	15 ký tự	Cài đặt
Điểm xếp hạng theo sao	Số lượng sao (từ 0 đến 5) biểu thị điểm xếp hạng của ứng dụng trong cửa hàng ứng dụng	Đề xuất	Không	0 – 5	4,5
Giá	Chi phí của ứng dụng	Đề xuất	Không	15 ký tự	Miễn phí

Lưu ý về độ dài văn bản

Nếu người mua gửi một thành phần văn bản (ví dụ: nội dung văn bản) dài hơn số ký tự tối đa được đề xuất, thì văn bản đó có thể bị Google hoặc nhà xuất bản cắt bớt và đánh dấu bằng dấu ba chấm. Xin lưu ý rằng giới hạn cắt bớt là một nửa kích thước trong tiếng Trung, tiếng Nhật và tiếng Hàn. Ví dụ: giới hạn tiêu đề là 90 cho tiếng Anh và 45 cho tiếng Trung Quốc.

Lưu ý về kích thước hình ảnh

Nhà xuất bản được phép:

Cắt ảnh chính đối xứng tối đa 20% theo một chiều (chiều cao hoặc chiều rộng).
Điều chỉnh tỷ lệ hình ảnh mà không thay đổi tỷ lệ khung hình.
Những hình ảnh có tỷ lệ khung hình khác biệt đáng kể so với tỷ lệ khung hình do chiều cao và chiều rộng ngụ ý có thể bị lọc.

Mẫu quảng cáo nội dung

Bảng sau đây liệt kê các trường của mẫu quảng cáo nội dung. Nhà xuất bản sử dụng các trường này để tạo quảng cáo nội dung gốc.

Trường	Mô tả	Bắt buộc hay nên dùng?	Luôn hiển thị?	Kích thước hình ảnh/số lượng ký tự tối đa được đề xuất *	Ví dụ:
Dòng tiêu đề	Tiêu đề quảng cáo	Bắt buộc	Có	25 ký tự	Lãi suất thế chấp thấp nhất
Hình ảnh	Hình ảnh chính của quảng cáo	Bắt buộc	Không	1.200 px x 627 px hoặc 600 px x 600 px,tuỳ thuộc vào tỷ lệ khung hình mà nhà xuất bản yêu cầu.	<Hình ảnh chính của quảng cáo>
Nội dung	Nội dung quảng cáo	Bắt buộc	Không	90 ký tự	Ngôi nhà thân yêu của bạn ở Brooklyn – rẻ hơn và nhanh hơn bạn nghĩ!
Biểu trưng	Biểu trưng của nhà quảng cáo hoặc một hình ảnh nhỏ có liên quan khác	Đề xuất	Không	128 x 128 px	<Biểu trưng của NY Mortgage Inc.>
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Đề xuất	Không	15 ký tự	Nhận bản báo giá
Nhà quảng cáo	Văn bản xác định nhà quảng cáo hoặc thương hiệu	Bắt buộc	Không	25 ký tự	NY Mortgage Inc.

Mẫu quảng cáo cài đặt ứng dụng dạng video

Trường	Mô tả	Bắt buộc hay nên dùng?	Luôn hiển thị?	Kích thước hình ảnh đề xuất/số lượng ký tự tối đa *	Ví dụ:
Video	Phản hồi VAST video chứa tất cả các phần tử cần thiết để phát lại quảng cáo dạng video.	Bắt buộc	Không	-	URL đến VAST XML chứa Flood-It! Quảng cáo dạng video
Dòng tiêu đề	Tiêu đề ứng dụng	Bắt buộc	Có	25 ký tự	Flood-It!
Hình ảnh	Hình ảnh (hình thu nhỏ) hiển thị trong trình phát trước khi quảng cáo dạng video được nhấp vào hoặc trong khi quảng cáo đó đang tải.	Bắt buộc	Không	Phải khớp với tỷ lệ khung hình của video (ví dụ: 1280x720 cho video 16:9, 4:3 cho video 640x480).	Ảnh chụp màn hình trò chơi Flood-It! Hoặc trong video
Nội dung	Văn bản chính của ứng dụng	Bắt buộc	Không	90 ký tự	Đơn giản nhưng đầy thử thách = gây nghiện một cách thú vị!
Biểu tượng ứng dụng	Biểu tượng ứng dụng	Bắt buộc	Không	128 x 128 px	Biểu tượng ứng dụng Flood-it!
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Bắt buộc	Có	15 ký tự	Cài đặt
Điểm xếp hạng theo sao	Số lượng sao (từ 0 đến 5) biểu thị điểm xếp hạng của ứng dụng trong cửa hàng ứng dụng	Đề xuất	Không	0 – 5	4,5
Giá	Chi phí của ứng dụng	Đề xuất	Không	15 ký tự	Miễn phí

Quy định hạn chế

Video: Tất cả video phải ở dạng URL VAST hoặc Thẻ VAST. Bạn không thể chỉ định một tệp video thô như WebM, MP4, v.v.
Độ dài văn bản: Nếu người mua chỉ định một thành phần văn bản như body trong phản hồi, thì Google hoặc nhà xuất bản có thể cắt bớt và đánh dấu bằng dấu ba chấm. Xin lưu ý rằng giới hạn cắt bớt chỉ bằng một nửa kích thước trong tiếng Trung, tiếng Nhật và tiếng Hàn. Ví dụ: giới hạn tiêu đề là 90 ký tự đối với tiếng Anh và 45 ký tự đối với tiếng Trung Quốc.
Kích thước hình ảnh: Nhà xuất bản được phép:
- Cắt ảnh chính đối xứng tối đa 20% theo một chiều (chiều cao hoặc chiều rộng).
- Điều chỉnh tỷ lệ hình ảnh mà không thay đổi tỷ lệ khung hình.

Ví dụ về quảng cáo cài đặt ứng dụng

Mẫu quảng cáo nội dung dạng video

Trường	Mô tả	Bắt buộc hay nên dùng?	Luôn hiển thị?	Kích thước hình ảnh đề xuất/số lượng ký tự tối đa *	Ví dụ:
Video	Phản hồi VAST video chứa tất cả các phần tử cần thiết để phát lại quảng cáo dạng video.	Bắt buộc	Có	-	URL đến VAST XML chứa Flood-It! Quảng cáo dạng video
Dòng tiêu đề	Tiêu đề quảng cáo	Bắt buộc	Có	25 ký tự	Lãi suất thế chấp thấp nhất
Hình ảnh	Hình ảnh (hình thu nhỏ) hiển thị trong trình phát trước khi quảng cáo dạng video được nhấp vào hoặc trong khi quảng cáo đó đang tải.	Bắt buộc	Không	Phải khớp với tỷ lệ khung hình của video (ví dụ: 1280x720 cho video 16:9, 4:3 cho video 640x480).	Ảnh chụp màn hình trong video
Nội dung	Nội dung quảng cáo	Bắt buộc	Không	90 ký tự	Ngôi nhà thân yêu của bạn ở Brooklyn – rẻ hơn và nhanh hơn bạn nghĩ!
Biểu trưng	Biểu trưng của nhà quảng cáo hoặc một hình ảnh nhỏ có liên quan khác	Đề xuất	Không	128 x 128 px	Biểu trưng của NY Mortgage Inc.
Lời kêu gọi hành động	Hành động ưu tiên của người dùng	Bắt buộc	Không	15 ký tự	Nhận bản báo giá
Nhà quảng cáo	Văn bản xác định nhà quảng cáo hoặc thương hiệu	Bắt buộc	Không	25 ký tự	NY Mortgage Inc.

Trường meta

Tất cả các mẫu quảng cáo được hỗ trợ đều dùng chung các trường meta sau:

Trường	Mô tả
`BidResponse.seatbid.bid.{adm/adm_native}.link.url`	URL của trang đích cuối cùng mà người dùng sẽ được chuyển hướng đến sau khi họ nhấp vào quảng cáo. Bạn phải sử dụng trường này trong trường hợp trang đích động.
`BidResponse.seatbid.bid.{adm/adm_native}.link.clicktrackers`	Không bắt buộc. Các URL bổ sung cho phép nhà quảng cáo theo dõi lượt nhấp của người dùng vào quảng cáo.
`BidResponse.seatbid.bid.{adm/adm_native}.privacy`	Liên kết đến trang lựa chọn ưu tiên về quảng cáo hoặc trang chọn không nhận quảng cáo. Nếu có, biểu tượng Lựa chọn quảng cáo tiêu chuẩn sẽ được thêm vào mẫu quảng cáo gốc và liên kết đến URL này.
`BidResponse.seatbid.bid.{adm/adm_native}.eventtrackers`	Bạn có thể thực hiện hoạt động theo dõi lượt hiển thị bằng cách thêm `eventtrackers` vào phản hồi gốc, trong đó `event` được đặt thành `IMPRESSION`.

Biểu thị mẫu quảng cáo gốc trong yêu cầu giá thầu

Khi nhận được một yêu cầu đặt giá thầu có chứa khoảng không quảng cáo gốc, yêu cầu đó sẽ chứa mẫu quảng cáo gốc được biểu thị bằng thông báo NativeRequest của OpenRTB. Thông tin này cung cấp những thông tin sau về khoảng không quảng cáo gốc:

Thành phần không bắt buộc hoặc bắt buộc.
Kích thước cho hình ảnh, biểu trưng và biểu tượng ứng dụng.
Quy cách về kiểu hiển thị quảng cáo.

Lưu ý: Đối với BidRequest.imp.native.{request/request_native}.ext.style_layout_type, PIXEL cho biết đơn vị gốc có kích thước cố định, trong khi FLUID có nghĩa là đơn vị đó sẽ điều chỉnh tỷ lệ để lấp đầy chiều rộng của cột bao quanh và điều chỉnh chiều cao để giữ nguyên tỷ lệ khung hình. Khi FLUID được chỉ định, chiều cao và chiều rộng có thể xuất hiện dưới dạng 1x1.

Thành phần không bắt buộc và bắt buộc

Bạn có thể tìm thấy các thành phần không bắt buộc và bắt buộc cho một lượt hiển thị quảng cáo gốc trong BidRequest.imp.native.{request/request_native}.assets. Tham số này mô tả các thành phần của quảng cáo gốc, chẳng hạn như tiêu đề, nội dung hoặc biểu trưng. Mỗi thành phần có trong yêu cầu đều có một id riêng biệt và điền sẵn required dưới dạng True cho những thành phần phải có trong phản hồi giá thầu.

Hình minh hoạ một quảng cáo gốc trong phản hồi giá thầu

Khi đặt giá thầu cho khoảng không quảng cáo gốc, bạn phải thêm một NativeResponse được điền sẵn các thành phần bắt buộc được chỉ định trong yêu cầu giá thầu, đồng thời cũng có thể thêm mọi thành phần không bắt buộc đã được chỉ định. Bạn có thể đưa những thông tin này vào phản hồi giá thầu bằng BidResponse.seatbid.bid.{adm/adm_native}.assets. Khi bạn điền assets vào phản hồi, mỗi phản hồi phải bao gồm id tương ứng với tài sản đó trong yêu cầu giá thầu.

Ví dụ về yêu cầu giá thầu

OpenRTB Protobuf

Ví dụ minh họa

Yêu cầu được chuyển đổi tuần tự

id: "E308Tm2QEoE47lnhe83X9q"
imp {
  id: "1"
  tagid: "4903055077"
  bidfloor: 81.14974999553961
  bidfloorcur: "JPY"
  secure: true
  native {
    ver: "1.2"
    api: VPAID_1
    api: VPAID_2
    battr: VIDEO_IN_BANNER_AUTO_PLAY
    battr: VIDEO_IN_BANNER_USER_INITIATED
    request_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          len: 25
        }
      }
      assets {
        id: 2
        required: true
        img {
          type: MAIN
          wmin: 1200
          hmin: 627
        }
      }
      eventtrackers {
        event: IMPRESSION
        methods: IMG
      }
      privacy: true
      [com.google.doubleclick.native_ext] {
        style_height: 1
        style_width: 1
        style_layout_type: FLUID
        pos: BELOW_THE_FOLD
      }
    }
  }
  exp: 3600
  metric {
    type: "click_through_rate"
    value: 0.004343720618635416
    vendor: "EXCHANGE"
  }
  metric {
    type: "viewability"
    value: 0.71
    vendor: "EXCHANGE"
  }
  [com.google.doubleclick.imp] {
    billing_id: 24180454294
    billing_id: 14521002479
    publisher_settings_list_id: 3546930920304928337
    publisher_settings_list_id: 6175971934253075185
    allowed_vendor_type: 0
    ampad: AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    excluded_creatives {
      buyer_creative_id: "EXCLUDED_BUYER_CREATIVE_ID"
    }
    creative_enforcement_settings {
      policy_enforcement: POLICY_ENFORCEMENT_NETWORK_AND_PLATFORM_POLICY
      publisher_blocks_enforcement: PUBLISHER_BLOCKS_ENFORCEMENT_APPLIES
    }
    auction_environment: SERVER_SIDE_AUCTION
    ae: SERVER_SIDE_AUCTION
  }
}
site {
  page: "https://www.google.com"
  publisher {
    id: "pub-1111111111111111"
    [com.google.doubleclick.publisher] {
      country: "PL"
    }
  }
  content {
    livestream: false
    language: "pl"
  }
  [com.google.doubleclick.site] {
    amp: DIALECT_HTML
    page_visibility: VISIBILITY_STATE_VISIBLE
    ntype: NAVIGATION_TYPE_BACK_FORWARD
  }
}
device {
  ua: "OMITTED"
  ip: "192.168.1.0"
  geo {
    lat: 0.0
    lon: 0.0
    country: "POL"
    region: "PL-WP"
    city: "Konin"
    zip: "62-500"
    type: IP
    utcoffset: 120
    accuracy: 5108
    [com.google.doubleclick.geo] {
      geo_criteria_id: 1011590
    }
  }
  os: "Windows"
  devicetype: PERSONAL_COMPUTER
  pxratio: 1.2
  sua {
    browsers {
      brand: "Mozilla"
      version: "5"
      version: "0"
    }
    browsers {
      brand: "Gecko"
      version: "20100101"
    }
    platform {
      brand: "Windows NT"
      version: "10"
      version: "0"
    }
    mobile: false
    source: USER_AGENT_STRING
  }
}
user {
  id: "E0ML7e7ETr249RfY471vuDEPklO"
  data {
    id: "0"
    segment {
      id: "OMITTED"
    }
    segment {
      id: "OMITTED"
    }
    [com.google.doubleclick.data] {
      segtax: 4
    }
  }
  consent: "OMITTED"
  [com.google.doubleclick.user] {
    consented_providers_settings {
      consented_providers: 1301
      consented_providers: 70
      additional_consent: "OMITTED"
    }
    consent: "OMITTED"
    idage: 75600
  }
}
at: FIRST_PRICE
tmax: 350
cur: "GBP"
cur: "JPY"
bcat: "3"
bcat: "5"
regs {
  [com.google.doubleclick.regs] {
    gdpr: true
  }
}
source {
  schain {
    complete: true
    nodes {
      asi: "testssp.com"
      sid: "pub-1111111111111111"
      hp: true
    }
    ver: "1.0"
  }
}
cattax: GOOGLE_CATEGORIES
[com.google.doubleclick.bid_request] {
  bid_feedback {
    request_id: "L47877z78x3rN3S7S58fK4"
    creative_status_code: 80
    event_notification_token {
      payload: "token"
    }
    buyer_creative_id: "test_creative_id_472475"
    minimum_bid_to_win: 1.55
    feedbacktype: BID_FEEDBACK
  }
  google_query_id: "ANy-zlz7ER-Ywn21DS7CCy047o63UiiOIE1ye5yXAYubmwH33Y6y8T3rLT3G338zT4lOxA79"
  fcap_scope: FREQUENCY_CAPPING_SCOPE_BROWSER
  privacy_treatments {
    allow_user_data_collection: true
  }
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "E308Tm2QEoE47lnhe83X9q",
  "imp": [
    {
      "id": "1",
      "tagid": "4903055077",
      "bidfloor": 81.14974999553961,
      "bidfloorcur": "JPY",
      "secure": 1,
      "native": {
        "ver": "1.2",
        "api": [
          1,
          2
        ],
        "battr": [
          6,
          7
        ],
        "request": "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":25}},{\"id\":2,\"required\":1,\"img\":{\"type\":3,\"wmin\":1200,\"hmin\":627}}],\"eventtrackers\":[{\"event\":1,\"methods\":[1]}],\"privacy\":1,\"ext\":{\"style_height\":1,\"style_width\":1,\"style_layout_type\":1,\"pos\":3}}"
      },
      "exp": 3600,
      "metric": [
        {
          "type": "click_through_rate",
          "value": 0.004343720618635416,
          "vendor": "EXCHANGE"
        },
        {
          "type": "viewability",
          "value": 0.71,
          "vendor": "EXCHANGE"
        }
      ],
      "ext": {
        "billing_id": [
          "24180454294",
          "14521002479"
        ],
        "publisher_settings_list_id": [
          "3546930920304928337",
          "6175971934253075185"
        ],
        "allowed_vendor_type": [
          0
        ],
        "ampad": 3,
        "excluded_creatives": [
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          },
          {
            "buyer_creative_id": "EXCLUDED_BUYER_CREATIVE_ID"
          }
        ],
        "creative_enforcement_settings": {
          "policy_enforcement": 2,
          "publisher_blocks_enforcement": 1
        },
        "auction_environment": 0,
        "ae": 0
      }
    }
  ],
  "site": {
    "page": "https://www.google.com",
    "publisher": {
      "id": "pub-1111111111111111",
      "ext": {
        "country": "PL"
      }
    },
    "content": {
      "livestream": 0,
      "language": "pl"
    },
    "ext": {
      "amp": 0,
      "page_visibility": 1,
      "ntype": 3
    }
  },
  "device": {
    "ua": "OMITTED",
    "ip": "192.168.1.0",
    "geo": {
      "lat": 0.0,
      "lon": 0.0,
      "country": "POL",
      "region": "PL-WP",
      "city": "Konin",
      "zip": "62-500",
      "type": 2,
      "utcoffset": 120,
      "accuracy": 5108,
      "ext": {
        "geo_criteria_id": 1011590
      }
    },
    "os": "Windows",
    "devicetype": 2,
    "pxratio": 1.2,
    "sua": {
      "browsers": [
        {
          "brand": "Mozilla",
          "version": [
            "5",
            "0"
          ]
        },
        {
          "brand": "Gecko",
          "version": [
            "20100101"
          ]
        }
      ],
      "platform": {
        "brand": "Windows NT",
        "version": [
          "10",
          "0"
        ]
      },
      "mobile": 0,
      "source": 3
    }
  },
  "user": {
    "id": "E0ML7e7ETr249RfY471vuDEPklO",
    "data": [
      {
        "id": "0",
        "segment": [
          {
            "id": "OMITTED"
          },
          {
            "id": "OMITTED"
          }
        ],
        "ext": {
          "segtax": 4
        }
      }
    ],
    "consent": "OMITTED",
    "ext": {
      "consented_providers_settings": {
        "consented_providers": [
          "1301",
          "70"
        ],
        "additional_consent": "OMITTED"
      },
      "consent": "OMITTED",
      "idage": 75600
    }
  },
  "at": 1,
  "tmax": 350,
  "cur": [
    "GBP",
    "JPY"
  ],
  "bcat": [
    "3",
    "5"
  ],
  "regs": {
    "ext": {
      "gdpr": 1
    }
  },
  "source": {
    "schain": {
      "complete": 1,
      "nodes": [
        {
          "asi": "testssp.com",
          "sid": "pub-1111111111111111",
          "hp": 1
        }
      ],
      "ver": "1.0"
    }
  },
  "cattax": 500,
  "ext": {
    "bid_feedback": [
      {
        "request_id": "L47877z78x3rN3S7S58fK4",
        "creative_status_code": 80,
        "event_notification_token": {
          "payload": "token"
        },
        "buyer_creative_id": "test_creative_id_472475",
        "minimum_bid_to_win": 1.55,
        "feedbacktype": 1
      }
    ],
    "google_query_id": "ANy-zlz7ER-Ywn21DS7CCy047o63UiiOIE1ye5yXAYubmwH33Y6y8T3rLT3G338zT4lOxA79",
    "fcap_scope": 2,
    "privacy_treatments": {
      "allow_user_data_collection": 1
    }
  }
}

Ví dụ về phản hồi giá thầu

OpenRTB Protobuf

Ví dụ minh họa

Phản hồi được chuyển đổi tuần tự

id: "42MVqin85i25Y9832I39o7"
seatbid {
  bid {
    id: "VL1295pT2ke789Bvu86"
    impid: "1"
    price: 1.0531195402145386
    crid: "test_creative_id_783370"
    dealid: "0"
    adm_native {
      ver: "1.2"
      assets {
        id: 2
        img {
          url: "https://native.test.com/image?id=123456"
          w: 800
          h: 800
          type: MAIN
        }
      }
      assets {
        id: 1
        title {
          text: "Luxury Mars Cruises"
        }
      }
      link {
        url: "https://www.google.com"
      }
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://example.com/impression?id=654321"
      ad_choices_destination_url: "https://test.com/preferences"
      event_notification_token {
        payload: "token"
      }
      billing_id: 24180454294
      dsa {
        adrender: true
      }
      clickurl: "google.com"
    }
  }
}
cur: "JPY"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 16
}

JSON OpenRTB

Ví dụ minh họa

{
  "id": "42MVqin85i25Y9832I39o7",
  "seatbid": [
    {
      "bid": [
        {
          "id": "VL1295pT2ke789Bvu86",
          "impid": "1",
          "price": 1.0531195402145386,
          "crid": "test_creative_id_783370",
          "dealid": "0",
          "ext": {
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://example.com/impression?id=654321"
            ],
            "ad_choices_destination_url": "https://test.com/preferences",
            "event_notification_token": {
              "payload": "token"
            },
            "billing_id": "24180454294",
            "dsa": {
              "adrender": 1
            },
            "clickurl": [
              "google.com"
            ]
          },
          "adm": "{\"ver\":\"1.2\",\"assets\":[{\"id\":2,\"img\":{\"url\":\"https://native.test.com/image?id=123456\",\"w\":800,\"h\":800,\"type\":3}},{\"id\":1,\"title\":{\"text\":\"Luxury Mars Cruises\"}}],\"link\":{\"url\":\"https://www.google.com\"}}"
        }
      ]
    }
  ],
  "cur": "JPY",
  "ext": {
    "processing_time_ms": 16
  }
}

Quảng cáo gốc Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Định dạng thư

JSON OpenRTB (đã phân tích cú pháp)

OpenRTB Protobuf

Mẫu quảng cáo gốc

Mẫu quảng cáo cài đặt ứng dụng

Các trường bắt buộc và nên dùng

Lưu ý về độ dài văn bản

Lưu ý về kích thước hình ảnh

Mẫu quảng cáo nội dung

Mẫu quảng cáo cài đặt ứng dụng dạng video

Quy định hạn chế

Ví dụ về quảng cáo cài đặt ứng dụng

Mẫu quảng cáo nội dung dạng video

Trường meta

Biểu thị mẫu quảng cáo gốc trong yêu cầu giá thầu

Thành phần không bắt buộc và bắt buộc

Hình minh hoạ một quảng cáo gốc trong phản hồi giá thầu

Ví dụ về yêu cầu giá thầu

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

Ví dụ về phản hồi giá thầu

OpenRTB Protobuf

Ví dụ minh họa

JSON OpenRTB

Ví dụ minh họa

Quảng cáo gốc