- Tài nguyên: Nhóm quảng cáo
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute (Thuộc tính CommonInStream)
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- Hình thu nhỏ
- VideoPerformanceAd
- AdUrl
- AdUrlType
- Phương thức
Tài nguyên: Nhóm quảng cáo
Một quảng cáo được liên kết với một nhóm quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
Các trường | |
---|---|
name |
Tên tài nguyên của quảng cáo. |
advertiserId |
Mã nhận dạng duy nhất của nhà quảng cáo chứa quảng cáo. |
adGroupAdId |
Mã nhận dạng duy nhất của quảng cáo. Do hệ thống chỉ định. |
adGroupId |
Mã nhận dạng duy nhất của nhóm quảng cáo chứa quảng cáo. |
displayName |
Tên hiển thị của quảng cáo. Phải là mã UTF-8 với kích thước tối đa là 255 byte. |
entityStatus |
Trạng thái thực thể của quảng cáo. |
adUrls[] |
Danh sách URL mà quảng cáo sử dụng. |
Trường nhóm ad_details . Chi tiết về quảng cáo. ad_details chỉ có thể là một trong những trạng thái sau đây: |
|
displayVideoSourceAd |
Thông tin chi tiết về quảng cáo lấy từ mẫu quảng cáo trên Display & Video 360. |
mastheadAd |
Thông tin chi tiết về quảng cáo được phân phát trên danh sách video trên Trang chủ của YouTube. |
inStreamAd |
Thông tin chi tiết về một quảng cáo trong luồng phát có thể bỏ qua sau 5 giây, dùng để nâng cao mức độ nhận biết thương hiệu hoặc đạt được các mục tiêu tiếp thị. |
nonSkippableAd |
Thông tin chi tiết về quảng cáo dạng video ngắn trong luồng phát không thể bỏ qua, dài từ 6 đến 15 giây, được dùng cho các mục tiêu tiếp thị về phạm vi tiếp cận. |
bumperAd |
Thông tin chi tiết về quảng cáo dạng video ngắn không thể bỏ qua (có thời lượng bằng hoặc dưới 6 giây) để mở rộng phạm vi tiếp cận. |
audioAd |
Thông tin chi tiết về quảng cáo dạng âm thanh được dùng để đạt được các mục tiêu tiếp thị về phạm vi tiếp cận. |
videoDiscoverAd |
Thông tin chi tiết về một quảng cáo quảng bá video xuất hiện ở những nơi mà người dùng khám phá. |
videoPerformanceAd |
Thông tin chi tiết về một quảng cáo được dùng trong chiến dịch thúc đẩy hành động trong quảng cáo dạng video để thúc đẩy hành động đến doanh nghiệp, dịch vụ hoặc sản phẩm. |
DisplayVideoSourceAd
Quảng cáo bắt nguồn từ mẫu quảng cáo của DV360.
Biểu diễn dưới dạng JSON |
---|
{ "creativeId": string } |
Các trường | |
---|---|
creativeId |
Mã của mẫu quảng cáo nguồn. |
MastheadAd
Thông tin chi tiết về Quảng cáo trên đầu trang chủ.
Biểu diễn dưới dạng JSON |
---|
{ "video": { object ( |
Các trường | |
---|---|
video |
Video trên YouTube mà quảng cáo sử dụng. |
headline |
Dòng tiêu đề của quảng cáo. |
description |
Nội dung mô tả về quảng cáo. |
videoAspectRatio |
Tỷ lệ khung hình của video YouTube tự động phát trên Quảng cáo trên đầu trang chủ. |
autoplayVideoStartMillisecond |
Khoảng thời gian tính bằng mili giây mà sau đó video sẽ bắt đầu phát. |
autoplayVideoDuration |
Thời lượng video sẽ tự động phát. Thời lượng tính bằng giây có tối đa 9 chữ số phân số, kết thúc bằng ' |
callToActionButtonLabel |
Văn bản trên nút kêu gọi hành động. |
callToActionFinalUrl |
URL đích cho nút gọi hành động. |
callToActionTrackingUrl |
URL theo dõi cho nút kêu gọi hành động. |
showChannelArt |
Có hiển thị nền hoặc biểu ngữ xuất hiện ở đầu trang YouTube hay không. |
companionYoutubeVideos[] |
Những video xuất hiện bên cạnh Quảng cáo trên đầu trang chủ trên máy tính. Không được có nhiều hơn hai. |
YoutubeVideoDetails
Thông tin chi tiết về một video trên YouTube.
Biểu diễn dưới dạng JSON |
---|
{
"id": string,
"unavailableReason": enum ( |
Các trường | |
---|---|
id |
Mã video trên YouTube có thể tìm kiếm được trên trang web YouTube. |
unavailableReason |
Lý do khiến dữ liệu video không có sẵn. |
VideoAspectRatio
Tỷ lệ khung hình có thể có cho một video trên YouTube.
Enum | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
Không được chỉ định hoặc không xác định. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
Video bị kéo giãn, đồng thời phần trên cùng và dưới cùng bị cắt. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
Video sử dụng tỷ lệ khung hình 16:9 cố định. |
InStreamAd
Thông tin chi tiết về quảng cáo trong luồng phát.
Biểu diễn dưới dạng JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Các trường | |
---|---|
commonInStreamAttribute |
Các thuộc tính phổ biến của quảng cáo. |
customParameters |
Các tham số tuỳ chỉnh để chuyển các giá trị tuỳ chỉnh đến mẫu URL theo dõi. Một đối tượng chứa danh sách các cặp |
CommonInStreamAttribute
Thuộc tính phổ biến của quảng cáo trong luồng, quảng cáo không thể bỏ qua và quảng cáo đệm.
Biểu diễn dưới dạng JSON |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
Các trường | |
---|---|
displayUrl |
Địa chỉ trang web xuất hiện cùng với quảng cáo. |
finalUrl |
Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo. |
trackingUrl |
Địa chỉ URL được tải ở chế độ nền cho mục đích theo dõi. |
actionButtonLabel |
Văn bản trên nút kêu gọi hành động. |
actionHeadline |
Tiêu đề của biểu ngữ lời kêu gọi hành động. |
video |
Video trên YouTube của quảng cáo. |
companionBanner |
Hình ảnh hiển thị bên cạnh quảng cáo dạng video. |
ImageAsset
Siêu dữ liệu về thành phần hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{
"mimeType": string,
"fullSize": {
object ( |
Các trường | |
---|---|
mimeType |
Loại MIME của thành phần hình ảnh. |
fullSize |
Siêu dữ liệu cho hình ảnh này ở kích thước gốc. |
fileSize |
Kích thước tệp của thành phần hình ảnh tính bằng byte. |
NonSkippableAd
Thông tin chi tiết về quảng cáo không thể bỏ qua.
Biểu diễn dưới dạng JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Các trường | |
---|---|
commonInStreamAttribute |
Các thuộc tính phổ biến của quảng cáo. |
customParameters |
Các tham số tuỳ chỉnh để chuyển các giá trị tuỳ chỉnh đến mẫu URL theo dõi. Một đối tượng chứa danh sách các cặp |
BumperAd
Thông tin chi tiết về quảng cáo đệm.
Biểu diễn dưới dạng JSON |
---|
{
"commonInStreamAttribute": {
object ( |
Các trường | |
---|---|
commonInStreamAttribute |
Các thuộc tính phổ biến của quảng cáo. |
AudioAd
Thông tin chi tiết về quảng cáo dạng âm thanh.
Biểu diễn dưới dạng JSON |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
Các trường | |
---|---|
displayUrl |
Địa chỉ trang web xuất hiện cùng với quảng cáo. |
finalUrl |
Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo. |
trackingUrl |
Địa chỉ URL được tải ở chế độ nền cho mục đích theo dõi. |
video |
Video trên YouTube của quảng cáo. |
VideoDiscoveryAd
Thông tin chi tiết về quảng cáo khám phá dạng video.
Biểu diễn dưới dạng JSON |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
Các trường | |
---|---|
headline |
Dòng tiêu đề của quảng cáo. |
description1 |
Dòng văn bản đầu tiên của quảng cáo. |
description2 |
Dòng văn bản thứ hai cho quảng cáo. |
video |
Video trên YouTube mà quảng cáo quảng bá. |
thumbnail |
Hình thu nhỏ được sử dụng trong quảng cáo. |
Hình thu nhỏ
Các lựa chọn hình thu nhỏ có thể có trong Quảng cáo khám phá dạng video.
Enum | |
---|---|
THUMBNAIL_UNSPECIFIED |
Không xác định hoặc chưa được chỉ định. |
THUMBNAIL_DEFAULT |
Hình thu nhỏ mặc định có thể được tạo tự động hoặc do người dùng tải lên. |
THUMBNAIL_1 |
Hình thu nhỏ 1, được tạo từ video. |
THUMBNAIL_2 |
Hình thu nhỏ 2, được tạo từ video. |
THUMBNAIL_3 |
Hình thu nhỏ 3, được tạo từ video. |
VideoPerformanceAd
Thông tin chi tiết về quảng cáo dựa trên hiệu suất video.
Biểu diễn dưới dạng JSON |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
Các trường | |
---|---|
finalUrl |
Địa chỉ URL của trang web mà mọi người sẽ được chuyển đến sau khi nhấp vào quảng cáo. |
trackingUrl |
Địa chỉ URL được tải ở chế độ nền cho mục đích theo dõi. |
actionButtonLabels[] |
Danh sách thành phần văn bản xuất hiện trên nút kêu gọi hành động. |
headlines[] |
Danh sách dòng tiêu đề xuất hiện trên biểu ngữ lời kêu gọi hành động. |
longHeadlines[] |
Danh sách từng dòng tiêu đề xuất hiện trên biểu ngữ lời kêu gọi hành động. |
descriptions[] |
Danh sách nội dung mô tả sẽ xuất hiện trên biểu ngữ lời kêu gọi hành động. |
displayUrlBreadcrumb1 |
Phần đầu tiên sau miền trong URL hiển thị. |
displayUrlBreadcrumb2 |
Phần thứ hai sau miền trong URL hiển thị. |
domain |
Tên miền của URL hiển thị. |
videos[] |
Danh sách nội dung video trên YouTube mà quảng cáo này sử dụng. |
customParameters |
Các tham số tuỳ chỉnh để chuyển các giá trị tuỳ chỉnh đến mẫu URL theo dõi. Một đối tượng chứa danh sách các cặp |
companionBanners[] |
Danh sách biểu ngữ đi kèm mà quảng cáo này sử dụng. |
AdUrl
URL bổ sung liên quan đến quảng cáo, bao gồm cả beacon.
Biểu diễn dưới dạng JSON |
---|
{
"type": enum ( |
Các trường | |
---|---|
type |
Loại URL quảng cáo. |
url |
Giá trị chuỗi URL. |
AdUrlType
Các loại URL quảng cáo có thể có.
Enum | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
Không xác định hoặc chưa được chỉ định. |
AD_URL_TYPE_BEACON_IMPRESSION |
Pixel theo dõi 1x1 để ping khi một lượt hiển thị của một mẫu quảng cáo được phân phối. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
Báo hiệu hiển thị DCM có thể mở rộng. Tại thời điểm phân phát, mô-đun này được mở rộng cho một số beacon. |
AD_URL_TYPE_BEACON_CLICK |
URL theo dõi sẽ ping khi sự kiện nhấp chuột được kích hoạt. |
AD_URL_TYPE_BEACON_SKIP |
URL theo dõi sẽ ping khi sự kiện bỏ qua được kích hoạt. |
Phương thức |
|
---|---|
|
Nhận quảng cáo theo nhóm quảng cáo. |
|
Liệt kê quảng cáo của nhóm quảng cáo. |