- Tài nguyên: Mẫu quảng cáo
- HostingSource
- CreativeAttribute
- ReviewStatusInfo (Thông tin trạng thái đánh giá)
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- Thành phần
- AssetRole
- ExitEvent (Sự kiện thoát)
- ExitEventType
- TimerEvent
- CounterEvent (Sự kiện bộ đếm),
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- Chuyển mã
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- Phương thức
Tài nguyên: Mẫu quảng cáo
Một mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
Các trường | |
---|---|
name |
Chỉ có đầu ra. Tên tài nguyên của mẫu quảng cáo. |
advertiserId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của nhà quảng cáo chứa mẫu quảng cáo. |
creativeId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của mẫu quảng cáo. Do hệ thống chỉ định. |
cmPlacementId |
Chỉ có đầu ra. Mã nhận dạng duy nhất của vị trí Campaign Manager 360 được liên kết với mẫu quảng cáo. Trường này chỉ áp dụng cho các mẫu quảng cáo được đồng bộ hoá từ Campaign Manager. |
displayName |
Bắt buộc. Tên hiển thị của mẫu quảng cáo. Phải là mã UTF-8 với kích thước tối đa là 240 byte. |
entityStatus |
Bắt buộc. Kiểm soát việc mẫu quảng cáo có thể phân phát hay không. Các giá trị được chấp nhận là:
|
updateTime |
Chỉ có đầu ra. Dấu thời gian khi mẫu quảng cáo được cập nhật lần gần đây nhất, do người dùng hoặc hệ thống (ví dụ: xem xét mẫu quảng cáo). Do hệ thống chỉ định. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
createTime |
Chỉ có đầu ra. Dấu thời gian khi mẫu quảng cáo được tạo. Do hệ thống chỉ định. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
creativeType |
Bắt buộc. Không thể thay đổi. Loại mẫu quảng cáo. |
hostingSource |
Bắt buộc. Cho biết nơi lưu trữ mẫu quảng cáo. |
dynamic |
Chỉ có đầu ra. Cho biết liệu quảng cáo có động hay không. |
dimensions |
Bắt buộc. Các phương diện chính của mẫu quảng cáo. Áp dụng cho tất cả các loại mẫu quảng cáo. Giá trị của
|
additionalDimensions[] |
Các phương diện bổ sung. Áp dụng khi
Nếu bạn chỉ định trường này, thì cả |
mediaDuration |
Chỉ có đầu ra. Thời lượng nội dung đa phương tiện của mẫu quảng cáo. Áp dụng khi
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 ' |
creativeAttributes[] |
Chỉ có đầu ra. Danh sách các thuộc tính của mẫu quảng cáo do hệ thống tạo ra. |
reviewStatus |
Chỉ có đầu ra. Trạng thái hiện tại của quy trình xem xét mẫu quảng cáo. |
assets[] |
Bắt buộc. Các thành phần liên kết với mẫu quảng cáo này. |
exitEvents[] |
Bắt buộc. Sự kiện thoát cho mẫu quảng cáo này. Điểm thoát (còn gọi là thẻ nhấp chuột) là bất kỳ vùng nào trong quảng cáo của bạn mà người dùng có thể nhấp hoặc nhấn vào để mở trang đích của nhà quảng cáo. Mỗi mẫu quảng cáo phải bao gồm ít nhất một lần thoát. Bạn có thể thêm điểm thoát vào mẫu quảng cáo theo bất kỳ cách nào sau đây:
|
timerEvents[] |
Hẹn giờ cho các sự kiện tuỳ chỉnh cho mẫu quảng cáo đa phương tiện. Bộ tính giờ theo dõi thời gian người dùng xem và tương tác với một phần được chỉ định của quảng cáo đa phương tiện. Một mẫu quảng cáo có thể có nhiều sự kiện trong bộ tính giờ, mỗi sự kiện được tính một cách độc lập. Hãy để trống hoặc không đặt trường này đối với mẫu quảng cáo chỉ chứa thành phần hình ảnh. |
counterEvents[] |
Sự kiện bộ đếm cho mẫu quảng cáo đa phương tiện. Bộ đếm theo dõi số lần người dùng tương tác với bất kỳ phần nào trong quảng cáo đa phương tiện theo cách được chỉ định (di chuột qua, di chuột ra, nhấp chuột, nhấn, tải dữ liệu, nhập dữ liệu bằng bàn phím, v.v.). Bất kỳ sự kiện nào có thể được ghi lại trong mẫu quảng cáo đều có thể được ghi lại dưới dạng bộ đếm. Hãy để trống hoặc không đặt trường này đối với mẫu quảng cáo chỉ chứa thành phần hình ảnh. |
appendedTag |
Thẻ theo dõi HTML của bên thứ ba được thêm vào thẻ quảng cáo. |
integrationCode |
Thông tin ID được sử dụng để liên kết quảng cáo này với hệ thống bên ngoài. Phải là mã UTF-8 với độ dài không quá 10.000 ký tự. |
notes |
Ghi chú của người dùng cho mẫu quảng cáo này. Phải là mã UTF-8 với độ dài không quá 20.000 ký tự. |
iasCampaignMonitoring |
Cho biết liệu tính năng giám sát chiến dịch Integral Ad Science (IAS) có được bật hay không. Để kích hoạt tính năng này cho mẫu quảng cáo, hãy đảm bảo |
companionCreativeIds[] |
Mã của mẫu quảng cáo đồng hành của một mẫu quảng cáo dạng video. Bạn có thể chỉ định các mẫu quảng cáo hiển thị hiện có (có thành phần hình ảnh hoặc HTML5) để phân phát xung quanh trình phát video của nhà xuất bản. Quảng cáo đồng hành hiển thị xung quanh trình phát video trong khi video đang phát và vẫn hiển thị sau khi video phát xong. Quảng cáo chứa Trường này chỉ được hỗ trợ cho
|
skippable |
Liệu người dùng có thể chọn bỏ qua mẫu quảng cáo dạng video hay không. Trường này chỉ được hỗ trợ cho
|
skipOffset |
Khoảng thời gian phát video trước khi nút bỏ qua xuất hiện. Trường này là bắt buộc khi Trường này chỉ được hỗ trợ cho
|
progressOffset |
Khoảng thời gian phát video trước khi tính một lượt xem. Trường này là bắt buộc khi Trường này chỉ được hỗ trợ cho
|
universalAdId |
Không bắt buộc. Mã nhận dạng mẫu quảng cáo (không bắt buộc) do tổ chức quản lý tên miền cung cấp và duy nhất trên tất cả các nền tảng. Mã quảng cáo chung là một phần của tiêu chuẩn VAST 4.0. Bạn có thể sửa đổi mẫu quảng cáo này sau khi tạo mẫu quảng cáo. Trường này chỉ được hỗ trợ cho
|
thirdPartyUrls[] |
Theo dõi URL từ bên thứ ba để theo dõi các lượt tương tác với mẫu quảng cáo dạng video. Trường này chỉ được hỗ trợ cho
|
transcodes[] |
Chỉ có đầu ra. Chuyển mã Âm thanh/Video. Display & Video 360 chuyển mã thành phần chính thành một số phiên bản sử dụng các định dạng tệp khác nhau hoặc có các thuộc tính khác nhau (độ phân giải, tốc độ bit âm thanh và tốc độ bit của video), mỗi phiên bản được thiết kế cho trình phát video hoặc băng thông cụ thể. Việc chuyển mã này mang lại cho hệ thống của nhà xuất bản nhiều tuỳ chọn hơn để lựa chọn cho mỗi lượt hiển thị trên video của bạn và đảm bảo rằng tệp phù hợp được phân phát dựa trên kết nối và kích thước màn hình của người xem. Trường này chỉ được hỗ trợ trong
|
trackerUrls[] |
URL theo dõi của nhà cung cấp dịch vụ phân tích hoặc nhà cung cấp công nghệ quảng cáo bên thứ ba. URL phải bắt đầu bằng https (ngoại trừ trên khoảng không quảng cáo không yêu cầu tuân thủ SSL). Nếu bạn sử dụng macro trong URL, hãy chỉ sử dụng macro được Display & Video 360 hỗ trợ. Chỉ dành cho URL chuẩn, không có thẻ IMG hoặc RECORD. Bạn chỉ có thể ghi trường này trong
|
jsTrackerUrl |
URL đo lường JavaScript từ các nhà cung cấp dịch vụ xác minh bên thứ ba được hỗ trợ (ComScore, DoubleVerify, IAS, Moat). Thẻ tập lệnh HTML không được hỗ trợ. Bạn chỉ có thể ghi trường này trong
|
cmTrackingAd |
Quảng cáo theo dõi Campaign Manager 360 được liên kết với mẫu quảng cáo. Không bắt buộc đối với
Chỉ xuất dữ liệu cho các trường hợp khác. |
obaIcon |
Chỉ định biểu tượng OBA cho mẫu quảng cáo dạng video. Trường này chỉ được hỗ trợ trong
|
thirdPartyTag |
Không bắt buộc. Thẻ ban đầu của bên thứ ba được dùng cho mẫu quảng cáo này. Bắt buộc và chỉ hợp lệ đối với mẫu quảng cáo thẻ của bên thứ ba. Mẫu quảng cáo thẻ của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
requireMraid |
Không bắt buộc. Cho biết rằng mẫu quảng cáo yêu cầu MRAID (hệ thống Định nghĩa giao diện quảng cáo nội dung đa phương tiện dành cho thiết bị di động). Đặt chế độ cài đặt này nếu mẫu quảng cáo dựa vào cử chỉ trên thiết bị di động để tương tác, chẳng hạn như vuốt hoặc nhấn. Không bắt buộc và chỉ hợp lệ cho mẫu quảng cáo thẻ của bên thứ ba. Mẫu quảng cáo thẻ của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
requireHtml5 |
Không bắt buộc. Cho biết rằng mẫu quảng cáo dựa vào HTML5 để hiển thị đúng cách. Không bắt buộc và chỉ hợp lệ cho mẫu quảng cáo thẻ của bên thứ ba. Mẫu quảng cáo thẻ của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
requirePingForAttribution |
Không bắt buộc. Cho biết rằng mẫu quảng cáo sẽ đợi ping trả về để phân bổ. Chỉ hợp lệ khi sử dụng quảng cáo theo dõi Campaign Manager 360 với thông số máy chủ quảng cáo bên thứ ba và macro ${DC_DBM_TOKEN}. Không bắt buộc và chỉ hợp lệ cho mẫu quảng cáo thẻ của bên thứ ba hoặc mẫu quảng cáo thẻ VAST của bên thứ ba. Mẫu quảng cáo thẻ của bên thứ ba là các mẫu quảng cáo có
kết hợp với
Mẫu quảng cáo thẻ VAST của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
expandingDirection |
Không bắt buộc. Xác định hướng mở rộng của mẫu quảng cáo. Bắt buộc và chỉ hợp lệ đối với mẫu quảng cáo có thể mở rộng của bên thứ ba. Quảng cáo có thể mở rộng của bên thứ ba là các quảng cáo có nguồn lưu trữ sau:
kết hợp với
|
expandOnHover |
Không bắt buộc. Cho biết rằng mẫu quảng cáo sẽ tự động mở rộng khi di chuột. Tùy chọn và chỉ hợp lệ cho quảng cáo có thể mở rộng của bên thứ ba. Quảng cáo có thể mở rộng của bên thứ ba là các quảng cáo có nguồn lưu trữ sau:
kết hợp với
|
vastTagUrl |
Không bắt buộc. URL của thẻ VAST cho mẫu quảng cáo thẻ VAST của bên thứ ba. Bắt buộc và chỉ hợp lệ đối với mẫu quảng cáo thẻ VAST của bên thứ ba. Mẫu quảng cáo thẻ VAST của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
vpaid |
Chỉ có đầu ra. Cho biết rằng mẫu quảng cáo thẻ VAST của bên thứ ba yêu cầu VPAID (Giao diện quảng cáo trên trình phát video kỹ thuật số). Chỉ có đầu ra và chỉ hợp lệ đối với mẫu quảng cáo thẻ VAST của bên thứ ba. Mẫu quảng cáo thẻ VAST của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
html5Video |
Chỉ có đầu ra. Cho biết rằng mẫu quảng cáo thẻ VAST của bên thứ ba yêu cầu hỗ trợ Video HTML5. Chỉ có đầu ra và chỉ hợp lệ đối với mẫu quảng cáo thẻ VAST của bên thứ ba. Mẫu quảng cáo thẻ VAST của bên thứ ba là các mẫu quảng cáo có
kết hợp với
|
lineItemIds[] |
Chỉ có đầu ra. Mã của mục hàng liên kết với mẫu quảng cáo này. Để liên kết một mẫu quảng cáo với mục hàng, hãy sử dụng |
mp3Audio |
Chỉ có đầu ra. Cho biết mẫu quảng cáo dạng âm thanh của bên thứ ba có hỗ trợ MP3. Chỉ có đầu ra và chỉ hợp lệ đối với mẫu quảng cáo dạng âm thanh của bên thứ ba. Mẫu quảng cáo dạng âm thanh của bên thứ ba là mẫu quảng cáo có
kết hợp với
|
oggAudio |
Chỉ có đầu ra. Cho biết mẫu quảng cáo dạng âm thanh của bên thứ ba có hỗ trợ OGG. Chỉ có đầu ra và chỉ hợp lệ đối với mẫu quảng cáo dạng âm thanh của bên thứ ba. Mẫu quảng cáo dạng âm thanh của bên thứ ba là mẫu quảng cáo có
kết hợp với
|
HostingSource
Các nguồn lưu trữ có thể có cho một mẫu quảng cáo. Cho biết nơi một mẫu quảng cáo được tạo và lưu trữ.
Enum | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
Nguồn lưu trữ không được chỉ định hoặc không xác định trong phiên bản này. |
HOSTING_SOURCE_CM |
Một mẫu quảng cáo được đồng bộ hoá từ Campaign Manager 360. Các phương thức tạo và cập nhật không được hỗ trợ cho loại lưu trữ này. |
HOSTING_SOURCE_THIRD_PARTY |
Quảng cáo được lưu trữ bởi máy chủ quảng cáo của bên thứ ba (3PAS). Các phương thức tạo và cập nhật được hỗ trợ cho loại lưu trữ này nếu
|
HOSTING_SOURCE_HOSTED |
Một mẫu quảng cáo được tạo trong DV360 và do Campaign Manager 360 lưu trữ. Các phương thức tạo và cập nhật được hỗ trợ cho loại lưu trữ này nếu
|
HOSTING_SOURCE_RICH_MEDIA |
Một mẫu quảng cáo đa phương tiện được tạo trong Studio và do Campaign Manager 360 lưu trữ. Các phương thức tạo và cập nhật không được hỗ trợ cho loại lưu trữ này. |
CreativeAttribute
Các thuộc tính có thể có của một mẫu quảng cáo.
Enum | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
Thuộc tính mẫu quảng cáo không được chỉ định hoặc không xác định trong phiên bản này. |
CREATIVE_ATTRIBUTE_VAST |
Mẫu quảng cáo là mẫu quảng cáo VAST. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
Mẫu quảng cáo là mẫu quảng cáo VPAID tuyến tính. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
Mẫu quảng cáo là mẫu quảng cáo VPAID phi tuyến tính. |
ReviewStatusInfo
Xem trạng thái của mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "approvalStatus": enum ( |
Các trường | |
---|---|
approvalStatus |
Thể hiện sự phê duyệt cơ bản cần thiết để mẫu quảng cáo bắt đầu phân phát. Tóm tắt về |
creativeAndLandingPageReviewStatus |
Trạng thái xem xét mẫu quảng cáo và trang đích của mẫu quảng cáo. |
contentAndPolicyReviewStatus |
Trạng thái đánh giá nội dung và chính sách của mẫu quảng cáo. |
exchangeReviewStatuses[] |
Trao đổi trạng thái xem xét cho mẫu quảng cáo. |
publisherReviewStatuses[] |
Trạng thái đánh giá của nhà xuất bản đối với mẫu quảng cáo. |
ApprovalStatus
Các loại trạng thái phê duyệt có thể có. Đây là bản tóm tắt của creativeAndLandingPageReviewStatus
và contentAndPolicyReviewStatus
.
Enum | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
Mẫu quảng cáo vẫn đang trong quá trình xem xét và không thể phân phát. |
APPROVAL_STATUS_PENDING_SERVABLE |
Quảng cáo đã vượt qua quy trình xem xét mẫu quảng cáo và trang đích, đồng thời có thể phân phát, nhưng đang chờ đánh giá nội dung và chính sách bổ sung. |
APPROVAL_STATUS_APPROVED_SERVABLE |
Cả quy trình xem xét mẫu quảng cáo và trang đích, cũng như đánh giá nội dung và chính sách đều được phê duyệt. Mẫu quảng cáo có thể phân phát. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
Đã xảy ra sự cố với mẫu quảng cáo và bạn phải khắc phục vấn đề này thì mẫu quảng cáo mới có thể phân phát. |
ReviewStatus
Các loại trạng thái xem xét có thể có.
Enum | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
Giá trị loại không được chỉ định hoặc không xác định trong phiên bản này. |
REVIEW_STATUS_APPROVED |
Mẫu quảng cáo đã được phê duyệt. |
REVIEW_STATUS_REJECTED |
Mẫu quảng cáo bị từ chối. |
REVIEW_STATUS_PENDING |
Mẫu quảng cáo đang chờ xem xét. |
ExchangeReviewStatus
Trao đổi trạng thái xem xét cho mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "exchange": enum ( |
Các trường | |
---|---|
exchange |
Cuộc trao đổi về việc xem xét mẫu quảng cáo. |
status |
Trạng thái xem xét trao đổi. |
PublisherReviewStatus
Trạng thái đánh giá của nhà xuất bản đối với mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{
"publisherName": string,
"status": enum ( |
Các trường | |
---|---|
publisherName |
Nhà xuất bản xem xét mẫu quảng cáo. |
status |
Trạng thái xem xét của nhà xuất bản. |
AssetAssociation
Mối liên kết tài sản cho mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "asset": { object ( |
Các trường | |
---|---|
asset |
Tài sản được liên kết. |
role |
Vai trò của thành phần này đối với mẫu quảng cáo. |
Tài sản
Một tài sản duy nhất.
Biểu diễn dưới dạng JSON |
---|
{ "mediaId": string, "content": string } |
Các trường | |
---|---|
mediaId |
Mã nhận dạng nội dung đa phương tiện của tài sản đã tải lên. Đây là giá trị nhận dạng duy nhất của tài sản. Mã này có thể được chuyển tới các lệnh gọi API khác, ví dụ: Không gian Mã nhận dạng nội dung đa phương tiện được cập nhật vào ngày 5 tháng 4 năm 2023. Cập nhật mã nội dung nghe nhìn được lưu vào bộ nhớ đệm trước ngày 5 tháng 4 năm 2023 bằng cách truy xuất mã nội dung nghe nhìn mới từ các tài nguyên mẫu quảng cáo được liên kết hoặc tải thành phần này lên lại. |
content |
Nội dung tài sản. Đối với các thành phần đã tải lên, nội dung là đường dẫn phân phát. |
AssetRole
Vai trò của thành phần này đối với mẫu quảng cáo.
Enum | |
---|---|
ASSET_ROLE_UNSPECIFIED |
Vai trò tài sản chưa được chỉ định hoặc không xác định trong phiên bản này. |
ASSET_ROLE_MAIN |
Thành phần này là thành phần chính của mẫu quảng cáo. |
ASSET_ROLE_BACKUP |
Thành phần này là thành phần dự phòng của mẫu quảng cáo. |
ASSET_ROLE_POLITE_LOAD |
Thành phần này là một thành phần tải thông minh của mẫu quảng cáo. |
ASSET_ROLE_HEADLINE |
Dòng tiêu đề của một mẫu quảng cáo gốc.
Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_LONG_HEADLINE |
Dòng tiêu đề dài của một mẫu quảng cáo gốc.
Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_BODY |
Văn bản nội dung của một mẫu quảng cáo gốc.
Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_LONG_BODY |
Văn bản có nội dung dài của một mẫu quảng cáo gốc.
Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_CAPTION_URL |
Phiên bản ngắn, thân thiện của URL trang đích sẽ xuất hiện trong mẫu quảng cáo. URL này cho người dùng biết trang web mà họ sẽ truy cập sau khi nhấp vào mẫu quảng cáo.
Ví dụ: nếu URL trang đích là "http://www.example.com/page", thì URL phụ đề có thể là "example.com". Giao thức (http://) là không bắt buộc, nhưng URL không được chứa dấu cách hoặc ký tự đặc biệt. Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_CALL_TO_ACTION |
Văn bản cần sử dụng trên nút kêu gọi hành động của một mẫu quảng cáo gốc.
Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_ADVERTISER_NAME |
Văn bản giúp nhận diện tên nhà quảng cáo hoặc tên thương hiệu.
Vai trò này chỉ được hỗ trợ trong
|
ASSET_ROLE_PRICE |
Giá mua của ứng dụng trong Cửa hàng Google Play hoặc cửa hàng ứng dụng dành cho iOS (ví dụ: 5, 99 USD). Xin lưu ý rằng giá trị này không tự động được đồng bộ hoá với giá trị thực tế được liệt kê trong cửa hàng. URL này sẽ luôn là tên được cung cấp khi lưu mẫu quảng cáo.
Các thành phần của vai trò này đang ở chế độ chỉ có thể đọc. |
ASSET_ROLE_ANDROID_APP_ID |
Mã nhận dạng của một ứng dụng Android trong Cửa hàng Google Play. Bạn có thể tìm thấy mã này trong URL sau "id" trong URL của ứng dụng trên Cửa hàng Google Play. Ví dụ: trong https://play.google.com/store/apps/details?id=com.company.appname, mã nhận dạng là com.company.appname. Các thành phần của vai trò này đang ở chế độ chỉ có thể đọc. |
ASSET_ROLE_IOS_APP_ID |
Mã nhận dạng của một ứng dụng iOS trong cửa hàng ứng dụng của Apple. Bạn có thể tìm thấy mã nhận dạng này trong URL của Apple App Store dưới dạng chuỗi số ngay sau "id". Ví dụ: Trong https://apps.apple.com/us/app/gmail-email-by-google/id422689480, mã nhận dạng là 422689480. Các thành phần của vai trò này đang ở chế độ chỉ có thể đọc. |
ASSET_ROLE_RATING |
Điểm xếp hạng của một ứng dụng trong cửa hàng Google Play hoặc cửa hàng ứng dụng iOS. Xin lưu ý rằng giá trị này không tự động được đồng bộ hoá với điểm xếp hạng thực tế trong cửa hàng. URL này sẽ luôn là tên được cung cấp khi lưu mẫu quảng cáo. Các thành phần của vai trò này đang ở chế độ chỉ có thể đọc. |
ASSET_ROLE_ICON |
Biểu tượng của một mẫu quảng cáo. Vai trò này chỉ được hỗ trợ và bắt buộc trong
|
ASSET_ROLE_COVER_IMAGE |
Ảnh bìa của một mẫu quảng cáo dạng video gốc. Vai trò này chỉ được hỗ trợ và bắt buộc trong
|
ExitEvent
Sự kiện thoát của mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{
"type": enum ( |
Các trường | |
---|---|
type |
Bắt buộc. Loại sự kiện thoát. |
url |
Bắt buộc. URL lượt nhấp của sự kiện thoát. Đây là yêu cầu bắt buộc khi
|
name |
Tên thẻ nhấp của sự kiện thoát. Tên không được trùng lặp trong một mẫu quảng cáo. Hãy để trống hoặc không đặt trường này đối với mẫu quảng cáo chỉ chứa thành phần hình ảnh. |
reportingName |
Tên được dùng để xác định sự kiện này trong báo cáo. Hãy để trống hoặc không đặt trường này đối với mẫu quảng cáo chỉ chứa thành phần hình ảnh. |
ExitEventType
Loại sự kiện thoát.
Enum | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
Loại sự kiện thoát chưa được chỉ định hoặc chưa xác định trong phiên bản này. |
EXIT_EVENT_TYPE_DEFAULT |
Sự kiện thoát là sự kiện mặc định. |
EXIT_EVENT_TYPE_BACKUP |
Sự kiện thoát là một sự kiện thoát dự phòng. Có thể có nhiều sự kiện thoát dự phòng trong một mẫu quảng cáo. |
TimerEvent
Sự kiện bộ tính giờ của mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "reportingName": string } |
Các trường | |
---|---|
name |
Bắt buộc. Tên của sự kiện bộ tính giờ. |
reportingName |
Bắt buộc. Tên dùng để xác định sự kiện bộ tính giờ này trong báo cáo. |
CounterEvent
Sự kiện phản đối của mẫu quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "reportingName": string } |
Các trường | |
---|---|
name |
Bắt buộc. Tên của sự kiện bộ đếm. |
reportingName |
Bắt buộc. Tên dùng để xác định sự kiện bộ đếm này trong báo cáo. |
AudioVideoOffset
Thời lượng phát âm thanh hoặc video.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm offset . Giá trị của phần bù trừ. offset chỉ có thể là một trong những trạng thái sau đây: |
|
percentage |
Độ lệch phần trăm thời lượng của âm thanh hoặc video. |
seconds |
Độ lệch (tính bằng giây) tính từ lúc bắt đầu âm thanh hoặc video. |
UniversalAdId
Giá trị nhận dạng mẫu quảng cáo do tổ chức quản lý tên miền cung cấp và giá trị này là duy nhất trên tất cả các nền tảng. Đây là một phần của tiêu chuẩn VAST 4.0.
Biểu diễn dưới dạng JSON |
---|
{
"id": string,
"registry": enum ( |
Các trường | |
---|---|
id |
Mã nhận dạng mẫu quảng cáo duy nhất. |
registry |
Tổ chức quản lý tên miền cung cấp mã nhận dạng mẫu quảng cáo duy nhất. |
UniversalAdRegistry
Tổ chức quản lý tên miền cung cấp mã nhận dạng mẫu quảng cáo duy nhất trong một Mã quảng cáo chung.
Enum | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
Sổ đăng ký Quảng cáo chung chưa được chỉ định hoặc không xác định trong phiên bản này. |
UNIVERSAL_AD_REGISTRY_OTHER |
Sử dụng một nhà cung cấp tuỳ chỉnh để cung cấp Mã quảng cáo chung. |
UNIVERSAL_AD_REGISTRY_AD_ID |
Sử dụng Ad-ID để cung cấp Mã quảng cáo chung. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
Sử dụng clearcast.co.uk để cung cấp Mã quảng cáo chung. |
UNIVERSAL_AD_REGISTRY_DV360 |
Sử dụng Display & Video 360 để cung cấp Mã quảng cáo chung. |
UNIVERSAL_AD_REGISTRY_CM |
Sử dụng Campaign Manager 360 để cung cấp Mã quảng cáo chung. |
ThirdPartyUrl
Theo dõi URL từ các bên thứ ba để theo dõi các lượt tương tác với mẫu quảng cáo dạng âm thanh hoặc video.
Biểu diễn dưới dạng JSON |
---|
{
"type": enum ( |
Các trường | |
---|---|
type |
Loại tương tác cần được theo dõi bằng URL theo dõi |
url |
URL theo dõi dùng để theo dõi lượt tương tác. Cung cấp một URL có đường dẫn hoặc chuỗi truy vấn không bắt buộc, bắt đầu bằng |
ThirdPartyUrlType
Loại tương tác cần được theo dõi bằng URL theo dõi bên thứ ba.
Enum | |
---|---|
THIRD_PARTY_URL_TYPE_UNSPECIFIED |
Loại URL của bên thứ ba chưa được chỉ định hoặc không xác định trong phiên bản này. |
THIRD_PARTY_URL_TYPE_IMPRESSION |
Dùng để tính số lượt hiển thị của mẫu quảng cáo sau khi quá trình lưu vào bộ đệm âm thanh hoặc video hoàn tất. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
Dùng để theo dõi lượt nhấp của người dùng vào âm thanh hoặc video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
Dùng để theo dõi số lần người dùng khởi động âm thanh hoặc video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
Dùng để theo dõi số lần âm thanh hoặc video phát đến 25% thời lượng. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
Dùng để theo dõi số lần âm thanh hoặc video phát đến 50% thời lượng. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
Dùng để theo dõi số lần âm thanh hoặc video phát đến 75% thời lượng. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
Dùng để theo dõi số lần âm thanh hoặc video phát đến hết. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
Dùng để theo dõi số lần người dùng tắt âm thanh hoặc video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
Dùng để theo dõi số lần người dùng tạm dừng âm thanh hoặc video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
Dùng để theo dõi số lần người dùng phát lại âm thanh hoặc video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
Dùng để theo dõi số lần người dùng mở rộng trình phát lên kích thước toàn màn hình. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
Dùng để theo dõi số lần người dùng dừng âm thanh hoặc video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
Dùng để theo dõi số lần người dùng thực hiện lượt nhấp tuỳ chỉnh, chẳng hạn như nhấp vào một vị trí có thể nhấp vào trong video. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
Dùng để theo dõi số lần âm thanh hoặc video đã bị bỏ qua. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
Dùng để theo dõi số lần âm thanh hoặc video phát đến độ lệch do progressOffset xác định. |
Chuyển mã
Biểu thị thông tin về tệp âm thanh hoặc video đã chuyển mã.
Biểu diễn dưới dạng JSON |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
Các trường | |
---|---|
name |
Tên của tệp đã chuyển mã. |
mimeType |
Loại MIME của tệp đã chuyển mã. |
transcoded |
Cho biết quá trình chuyển mã có thành công hay không. |
dimensions |
Kích thước của video đã chuyển mã. |
bitRateKbps |
Tốc độ bit của video đã chuyển mã, tính bằng kilobit trên giây. |
frameRate |
Tốc độ khung hình của video đã chuyển mã, tính bằng khung hình/giây. |
audioBitRateKbps |
Tốc độ bit của luồng âm thanh của video đã chuyển mã hoặc tốc độ bit của âm thanh đã chuyển mã, tính bằng kilobit trên giây. |
audioSampleRateHz |
Tốc độ lấy mẫu cho luồng âm thanh của video đã chuyển mã hoặc tốc độ lấy mẫu của âm thanh đã chuyển mã tính bằng shetz. |
fileSizeBytes |
Kích thước của tệp đã chuyển mã, tính bằng byte. |
CmTrackingAd
Quảng cáo theo dõi Campaign Manager 360.
Biểu diễn dưới dạng JSON |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
Các trường | |
---|---|
cmPlacementId |
Mã vị trí của Campaign Manager 360 theo dõi quảng cáo. |
cmCreativeId |
Mã mẫu quảng cáo của Campaign Manager 360 theo dõi quảng cáo. |
cmAdId |
Mã quảng cáo của Campaign Manager 360 theo dõi quảng cáo. |
ObaIcon
Biểu tượng OBA cho một mẫu quảng cáo
Biểu diễn dưới dạng JSON |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
Các trường | |
---|---|
resourceUrl |
URL của tài nguyên biểu tượng OBA. |
resourceMimeType |
Loại MIME của tài nguyên biểu tượng OBA. |
position |
Vị trí của biểu tượng OBA trên mẫu quảng cáo. |
dimensions |
Kích thước của biểu tượng OBA. |
program |
Chương trình của biểu tượng OBA. Ví dụ: “Lựa chọn quảng cáo”. |
landingPageUrl |
Bắt buộc. URL trang đích của biểu tượng OBA. Chỉ cho phép URL của các miền sau: |
clickTrackingUrl |
Bắt buộc. URL theo dõi lượt nhấp của biểu tượng OBA. Chỉ cho phép URL của các miền sau: |
viewTrackingUrl |
Bắt buộc. URL theo dõi lượt xem của biểu tượng OBA. Chỉ cho phép URL của các miền sau: |
ObaIconPosition
Vị trí của biểu tượng OBA trên mẫu quảng cáo.
Enum | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
Bạn chưa chỉ định vị trí biểu tượng OBA. |
OBA_ICON_POSITION_UPPER_RIGHT |
Ở phía trên bên phải của mẫu quảng cáo. |
OBA_ICON_POSITION_UPPER_LEFT |
Ở phía trên bên trái của mẫu quảng cáo. |
OBA_ICON_POSITION_LOWER_RIGHT |
Ở phía dưới bên phải của mẫu quảng cáo. |
OBA_ICON_POSITION_LOWER_LEFT |
Ở phía dưới bên trái của mẫu quảng cáo. |
ExpandingDirection
Hướng mở rộng của quảng cáo có thể mở rộng bên thứ ba.
Enum | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
Hướng mở rộng chưa được chỉ định. |
EXPANDING_DIRECTION_NONE |
Không mở rộng theo bất kỳ hướng nào. |
EXPANDING_DIRECTION_UP |
Mở rộng lên trên. |
EXPANDING_DIRECTION_DOWN |
Mở rộng xuống dưới. |
EXPANDING_DIRECTION_LEFT |
Mở rộng sang trái. |
EXPANDING_DIRECTION_RIGHT |
Mở rộng sang phải. |
EXPANDING_DIRECTION_UP_AND_LEFT |
Mở rộng lên trên và sang bên trái. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
Mở rộng lên trên và sang bên phải. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
Mở rộng xuống và sang bên trái. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
Mở rộng xuống dưới và sang bên phải. |
EXPANDING_DIRECTION_UP_OR_DOWN |
Mở rộng lên hoặc xuống. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
Mở rộng sang bên trái hoặc bên phải. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
Có thể mở rộng theo hướng chéo bất kỳ. |
Phương thức |
|
---|---|
|
Tạo mẫu quảng cáo mới. |
|
Xoá mẫu quảng cáo. |
|
Nhận một mẫu quảng cáo. |
|
Liệt kê mẫu quảng cáo trong một nhà quảng cáo. |
|
Cập nhật một mẫu quảng cáo hiện có. |