- Biểu diễn dưới dạng JSON
- AssetType
- AssetPolicySummary
- AssetFieldTypePolicySummary
- YoutubeVideoAsset
- MediaBundleAsset
- ImageAsset
- ImageDimension
- TextAsset (Thành phần văn bản)
- LeadFormAsset
- LeadFormCallToActionType
- LeadFormField
- LeadFormSingleChoiceAnswers
- LeadFormCustomQuestionField
- LeadFormDeliveryMethod
- WebhookDelivery
- LeadFormPostSubmitCallToActionType
- LeadFormDesiredIntent
- BookOnGoogleAsset
- PromotionAsset
- CalloutAsset
- StructuredSnippetAsset
- SitelinkAsset
- PageFeedAsset
- DynamicEducationAsset
- MobileAppAsset
- HotelCalloutAsset (Thành phần chú thích khách sạn)
- CallAsset
- PriceAsset (Thành phần giá)
- PriceOffering
- CallToActionAsset
- DynamicRealEstateAsset
- DynamicCustomAsset
- DynamicHotelsAndRentalsAsset
- DynamicFlightsAsset
- DiscoveryCarouselCardAsset
- DynamicTravelAsset
- DynamicLocalAsset (Thành phần linh động)
- DynamicJobsAsset
- LocationAsset
- BusinessProfileLocation
- HotelPropertyAsset
Thành phần là một phần của quảng cáo có thể được dùng chung trên nhiều quảng cáo. Đó có thể là hình ảnh (ImageAsset), video (YouTubeVideoAsset), v.v. Thành phần là không thể thay đổi và không thể xoá. Để dừng phân phát một thành phần, hãy xoá thành phần đó khỏi thực thể đang sử dụng thành phần đó.
Biểu diễn dưới dạng JSON |
---|
{ "resourceName": string, "type": enum ( |
Trường | |
---|---|
resourceName |
Không thể thay đổi. Tên tài nguyên của tài sản. Tên tài nguyên thành phần có dạng:
|
type |
Chỉ có đầu ra. Loại tài sản. |
finalUrls[] |
Danh sách các URL cuối cùng có thể xảy ra sau tất cả các lần chuyển hướng nhiều miền. |
finalMobileUrls[] |
Danh sách các URL cuối cùng trên thiết bị di động có thể có sau tất cả các lần chuyển hướng nhiều miền. |
urlCustomParameters[] |
Danh sách các ánh xạ được sử dụng để thay thế thẻ thông số tùy chỉnh URL trong trackUrlTemplate, lastUrls và/hoặc lastMobileUrls. |
source |
Chỉ có đầu ra. Nguồn của tài sản. |
policySummary |
Chỉ có đầu ra. Thông tin chính sách cho nội dung. |
fieldTypePolicySummaries[] |
Chỉ có đầu ra. Thông tin chính sách cho nội dung cho từng TrườngType. |
id |
Chỉ có đầu ra. ID của nội dung. |
name |
Tên tài sản (không bắt buộc). |
trackingUrlTemplate |
Mẫu URL để tạo URL theo dõi. |
finalUrlSuffix |
Mẫu URL để thêm thông số vào URL trang đích được phân phát cùng với tính năng theo dõi song song. |
Trường hợp asset_data . Loại nội dung cụ thể. asset_data chỉ có thể là một trong những trạng thái sau: |
|
youtubeVideoAsset |
Không thể thay đổi. Tài sản video trên YouTube. |
mediaBundleAsset |
Không thể thay đổi. Thành phần gói phương tiện. |
imageAsset |
Chỉ có đầu ra. Thành phần hình ảnh. |
textAsset |
Không thể thay đổi. Thành phần văn bản. |
leadFormAsset |
Thành phần biểu mẫu khách hàng tiềm năng. |
bookOnGoogleAsset |
Một cuốn sách trên tài sản của Google. |
promotionAsset |
Thành phần chương trình khuyến mãi. |
calloutAsset |
Thành phần chú thích. |
structuredSnippetAsset |
Thành phần đoạn thông tin có cấu trúc. |
sitelinkAsset |
Thành phần đường liên kết của trang web. |
pageFeedAsset |
Thành phần nguồn cấp dữ liệu trang. |
dynamicEducationAsset |
Một thành phần linh động cho lĩnh vực giáo dục. |
mobileAppAsset |
Thành phần ứng dụng di động. |
hotelCalloutAsset |
Thành phần chú thích cho khách sạn. |
callAsset |
Thành phần cuộc gọi. |
priceAsset |
Thành phần giá. |
callToActionAsset |
Không thể thay đổi. Thành phần lời kêu gọi hành động. |
dynamicRealEstateAsset |
Một tài sản linh động về bất động sản. |
dynamicCustomAsset |
Một thành phần tuỳ chỉnh linh động. |
dynamicHotelsAndRentalsAsset |
Một thành phần linh động về khách sạn và nhà nghỉ cho thuê. |
dynamicFlightsAsset |
Thành phần linh động về chuyến bay. |
discoveryCarouselCardAsset |
Không thể thay đổi. Thành phần thẻ băng chuyền của chiến dịch Khám phá. |
dynamicTravelAsset |
Một thành phần linh động về du lịch. |
dynamicLocalAsset |
Một thành phần linh động tại địa phương. |
dynamicJobsAsset |
Một thành phần linh động về việc làm. |
locationAsset |
Chỉ có đầu ra. Thành phần địa điểm. |
hotelPropertyAsset |
Không thể thay đổi. Thành phần cơ sở lưu trú khách sạn. |
AssetType
Enum mô tả các loại tài sản có thể sử dụng.
Enum | |
---|---|
UNSPECIFIED |
Chưa chỉ định. |
UNKNOWN |
Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này. |
YOUTUBE_VIDEO |
Tài sản video trên YouTube. |
MEDIA_BUNDLE |
Thành phần gói phương tiện. |
IMAGE |
Thành phần hình ảnh. |
TEXT |
Thành phần văn bản. |
LEAD_FORM |
Thành phần biểu mẫu khách hàng tiềm năng. |
BOOK_ON_GOOGLE |
Tài sản Đặt phòng trên Google. |
PROMOTION |
Thành phần chương trình khuyến mãi. |
CALLOUT |
Thành phần chú thích. |
STRUCTURED_SNIPPET |
Thành phần Đoạn thông tin có cấu trúc. |
SITELINK |
Thành phần đường liên kết của trang web. |
PAGE_FEED |
Thành phần Nguồn cấp dữ liệu trang. |
DYNAMIC_EDUCATION |
thành phần Dynamic Education. |
MOBILE_APP |
Thành phần ứng dụng di động. |
HOTEL_CALLOUT |
Thành phần chú thích cho khách sạn. |
CALL |
Thành phần cuộc gọi. |
PRICE |
Thành phần giá. |
CALL_TO_ACTION |
Thành phần lời kêu gọi hành động. |
DYNAMIC_REAL_ESTATE |
Thành phần linh động về bất động sản. |
DYNAMIC_CUSTOM |
Thành phần tuỳ chỉnh linh động. |
DYNAMIC_HOTELS_AND_RENTALS |
Thành phần linh động về khách sạn và nhà nghỉ cho thuê. |
DYNAMIC_FLIGHTS |
Thành phần linh động về chuyến bay. |
DISCOVERY_CAROUSEL_CARD |
Tài sản Thẻ băng chuyền của chiến dịch Khám phá. |
DYNAMIC_TRAVEL |
Thành phần linh động về du lịch. |
DYNAMIC_LOCAL |
Thành phần linh động tại địa phương. |
DYNAMIC_JOBS |
Thành phần linh động về việc làm. |
LOCATION |
Thành phần địa điểm. |
HOTEL_PROPERTY |
Thành phần cơ sở lưu trú khách sạn. |
AssetPolicySummary
Chứa thông tin chính sách của một nội dung.
Biểu diễn dưới dạng JSON |
---|
{ "policyTopicEntries": [ { object ( |
Trường | |
---|---|
policyTopicEntries[] |
Chỉ có đầu ra. Danh sách các phát hiện liên quan đến chính sách cho nội dung này. |
reviewStatus |
Chỉ có đầu ra. Vị trí của thành phần này trong quy trình xem xét. |
approvalStatus |
Chỉ có đầu ra. Trạng thái phê duyệt tổng thể của thành phần này, được tính dựa trên trạng thái của từng mục nhập chủ đề chính sách riêng lẻ. |
AssetFieldTypePolicySummary
Chứa thông tin chính sách cho một nội dung trong ngữ cảnh AssetFieldType.
Biểu diễn dưới dạng JSON |
---|
{ "assetFieldType": enum ( |
Trường | |
---|---|
assetFieldType |
Chỉ có đầu ra. Trường Loại của thành phần này. |
assetSource |
Chỉ có đầu ra. Nguồn của tài sản này. |
policySummaryInfo |
Chỉ có đầu ra. Thông tin tóm tắt về chính sách. |
YoutubeVideoAsset
Tài sản trên YouTube.
Biểu diễn dưới dạng JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Trường | |
---|---|
youtubeVideoTitle |
Tiêu đề video trên YouTube. |
youtubeVideoId |
Mã video trên YouTube. Đây là giá trị chuỗi gồm 11 ký tự được sử dụng trong URL của video trên YouTube. |
MediaBundleAsset
Một thành phần MediaBundle.
Biểu diễn dưới dạng JSON |
---|
{ "data": string } |
Trường | |
---|---|
data |
Dữ liệu thành phần gói phương tiện (tệp ZIP). Định dạng của tệp ZIP đã tải lên phụ thuộc vào trường quảng cáo sẽ sử dụng tệp này. Để biết thêm thông tin về định dạng này, hãy xem tài liệu về trường quảng cáo mà bạn dự định sử dụng MediaBundleAsset. Trường này chỉ có thể thay đổi. Một chuỗi được mã hoá base64. |
ImageAsset
Thành phần Hình ảnh.
Biểu diễn dưới dạng JSON |
---|
{ "mimeType": enum ( |
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 ban đầu. |
data |
Dữ liệu byte thô của một hình ảnh. Trường này chỉ có thể thay đổi. Một chuỗi được mã hoá base64. |
fileSize |
Kích thước tệp của thành phần hình ảnh tính bằng byte. |
ImageDimension
Siêu dữ liệu của hình ảnh ở một kích thước nhất định, có thể là bản gốc hoặc đã đổi kích thước.
Biểu diễn dưới dạng JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Trường | |
---|---|
heightPixels |
Chiều cao của hình ảnh. |
widthPixels |
Chiều rộng của hình ảnh. |
url |
URL trả về hình ảnh có chiều cao và chiều rộng này. |
TextAsset
Thành phần Văn bản.
Biểu diễn dưới dạng JSON |
---|
{ "text": string } |
Trường | |
---|---|
text |
Nội dung văn bản của thành phần văn bản. |
LeadFormAsset
Thành phần Biểu mẫu khách hàng tiềm năng.
Biểu diễn dưới dạng JSON |
---|
{ "businessName": string, "callToActionType": enum ( |
Trường | |
---|---|
businessName |
Bắt buộc. Tên của doanh nghiệp đang được quảng cáo. |
callToActionType |
Bắt buộc. Văn bản hiển thị được xác định trước khuyến khích người dùng mở rộng biểu mẫu. |
callToActionDescription |
Bắt buộc. Văn bản đưa ra tuyên bố giá trị rõ ràng về những gì người dùng mong đợi khi họ mở rộng biểu mẫu. |
headline |
Bắt buộc. Dòng tiêu đề của biểu mẫu mở rộng để mô tả những nội dung mà biểu mẫu này yêu cầu hoặc hỗ trợ. |
description |
Bắt buộc. Nội dung mô tả chi tiết về biểu mẫu mở rộng để mô tả những nội dung mà biểu mẫu yêu cầu hoặc hỗ trợ. |
privacyPolicyUrl |
Bắt buộc. Liên kết đến một trang mô tả chính sách về cách nhà quảng cáo/doanh nghiệp xử lý dữ liệu đã thu thập. |
fields[] |
Danh sách các trường nhập dữ liệu theo thứ tự. Bạn có thể cập nhật trường này bằng cách sắp xếp lại thứ tự các câu hỏi, nhưng không thể bằng cách thêm hoặc xoá câu hỏi. |
customQuestionFields[] |
Danh sách các trường câu hỏi tuỳ chỉnh theo thứ tự. Trường này có giới hạn là 5 câu hỏi đủ điều kiện cho mỗi biểu mẫu. |
deliveryMethods[] |
Các phương thức thiết lập để phân phối dữ liệu khách hàng tiềm năng đã thu thập cho nhà quảng cáo. Bạn chỉ có thể định cấu hình một phương thức đã nhập là Webhookdelivery. |
postSubmitCallToActionType |
Văn bản hiển thị được xác định trước khuyến khích người dùng hành động sau khi gửi biểu mẫu. |
desiredIntent |
Ý định được chọn cho biểu mẫu khách hàng tiềm năng, ví dụ: số lượng nhiều hơn hoặc đủ tiêu chuẩn hơn. |
postSubmitHeadline |
Dòng tiêu đề là văn bản xuất hiện sau khi gửi biểu mẫu, trong đó mô tả cách nhà quảng cáo sẽ liên hệ với người dùng. |
postSubmitDescription |
Nội dung mô tả chi tiết hiển thị sau khi người dùng gửi biểu mẫu, trong đó mô tả cách nhà quảng cáo sẽ liên hệ với người dùng. |
backgroundImageAsset |
Tên tài nguyên thành phần của hình nền. Kích thước hình ảnh phải chính xác là 1200x628. |
customDisclosure |
Thông tin công bố tuỳ chỉnh xuất hiện cùng tuyên bố từ chối trách nhiệm của Google trên biểu mẫu khách hàng tiềm năng. Chỉ những khách hàng được cho phép mới truy cập được. |
LeadFormCallToActionType
Enum mô tả loại cụm từ kêu gọi hành động trong biểu mẫu khách hàng tiềm năng.
Enum | |
---|---|
UNSPECIFIED |
Chưa chỉ định. |
UNKNOWN |
Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này. |
LEARN_MORE |
Tìm hiểu thêm. |
GET_QUOTE |
Nhận thông tin báo giá. |
APPLY_NOW |
Đăng ký ngay. |
SIGN_UP |
Đăng ký. |
CONTACT_US |
Liên hệ với chúng tôi. |
SUBSCRIBE |
Đăng ký. |
DOWNLOAD |
Tải xuống. |
BOOK_NOW |
Đặt chỗ ngay. |
GET_OFFER |
Nhận ưu đãi. |
REGISTER |
Đăng ký. |
GET_INFO |
Nhận thông tin. |
REQUEST_DEMO |
Yêu cầu bản minh họa. |
JOIN_NOW |
Tham gia ngay. |
GET_STARTED |
Bắt đầu. |
LeadFormField
Một thực thể của trường nhập dữ liệu trong một biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{ "inputType": enum ( |
Trường | |
---|---|
inputType |
Mô tả loại thông tin đầu vào (có thể là loại được xác định trước, chẳng hạn như "tên đầy đủ" hoặc câu hỏi được xem xét kỹ lưỡng như "Bạn có loại xe nào?". |
Trường hợp answers . Xác định cấu hình câu trả lời mà trường biểu mẫu này chấp nhận. Nếu một trong hai giá trị không được đặt, thì đây là câu trả lời dạng văn bản tự do. answers chỉ có thể là một trong những trạng thái sau: |
|
singleChoiceAnswers |
Cấu hình câu trả lời cho câu hỏi chỉ có một lựa chọn. Chỉ có thể đặt cho các trường câu hỏi đã được xem xét trước. Bạn phải đưa ra tối thiểu 2 câu trả lời và tối đa 12 câu trả lời. |
hasLocationAnswer |
Trả lời cấu hình cho câu hỏi về vị trí. Nếu đúng, dữ liệu vị trí ở cấp chiến dịch/tài khoản (tiểu bang, thành phố, tên doanh nghiệp, v.v.) sẽ hiển thị trên Biểu mẫu khách hàng tiềm năng. Kể từ phiên bản 13.1, bạn chỉ có thể đặt hasLocationAnswer cho câu hỏi "Bạn ưu tiên đại lý nào?" đối với những nhà quảng cáo đã thiết lập Thành phần địa điểm ở cấp chiến dịch/tài khoản. |
LeadFormSingleChoiceAnswers
Xác định các câu trả lời có thể có cho câu hỏi chỉ có một lựa chọn, thường được trình bày dưới dạng danh sách thả xuống có một lựa chọn.
Biểu diễn dưới dạng JSON |
---|
{ "answers": [ string ] } |
Trường | |
---|---|
answers[] |
Danh sách các lựa chọn cho một trường câu hỏi. Thứ tự của các mục nhập xác định thứ tự giao diện người dùng. Bạn phải đưa ra tối thiểu 2 câu trả lời và tối đa 12 câu trả lời. |
LeadFormCustomQuestionField
Một trường hợp trường nhập câu hỏi tuỳ chỉnh trong một biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{ "customQuestionText": string, // Union field |
Trường | |
---|---|
customQuestionText |
Văn bản chính xác của trường câu hỏi tuỳ chỉnh (ví dụ: "Bạn có loại xe nào?"). |
Trường hợp answers . Xác định cấu hình câu trả lời mà trường biểu mẫu này chấp nhận. Nếu một trong hai giá trị không được đặt, thì đây là câu trả lời dạng văn bản tự do. answers chỉ có thể là một trong những trạng thái sau: |
|
singleChoiceAnswers |
Cấu hình câu trả lời cho câu hỏi chỉ có một lựa chọn. Bạn có thể đưa ra tối thiểu 2 câu trả lời và tối đa 12 câu trả lời. |
hasLocationAnswer |
Trả lời cấu hình cho câu hỏi về vị trí. Nếu đúng, dữ liệu vị trí ở cấp chiến dịch/tài khoản (tiểu bang, thành phố, tên doanh nghiệp, v.v.) sẽ hiển thị trên Biểu mẫu khách hàng tiềm năng. Kể từ phiên bản 13.1, bạn chỉ có thể đặt hasLocationAnswer cho câu hỏi "Bạn ưu tiên đại lý nào?" đối với những nhà quảng cáo đã thiết lập Thành phần địa điểm ở cấp chiến dịch/tài khoản. |
LeadFormDeliveryMethod
Cấu hình cách phân phối khách hàng tiềm năng đến nhà quảng cáo.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp delivery_details . Nhiều loại phân phối phụ. delivery_details chỉ có thể là một trong những trạng thái sau: |
|
webhook |
Phương thức phân phối webhook. |
WebhookDelivery
Google thông báo cho nhà quảng cáo về khách hàng tiềm năng bằng cách thực hiện lệnh gọi HTTP tới điểm cuối mà họ chỉ định. Các yêu cầu này chứa JSON khớp với một giản đồ mà Google xuất bản trong tài liệu về quảng cáo biểu mẫu.
Biểu diễn dưới dạng JSON |
---|
{ "advertiserWebhookUrl": string, "googleSecret": string, "payloadSchemaVersion": string } |
Trường | |
---|---|
advertiserWebhookUrl |
URL webhook do nhà quảng cáo chỉ định để gửi khách hàng tiềm năng. |
googleSecret |
Bí mật chống giả mạo do nhà quảng cáo đặt trong tải trọng webhook. |
payloadSchemaVersion |
Phiên bản giản đồ mà thực thể phân phối này sẽ sử dụng. |
LeadFormPostSubmitCallToActionType
Enum mô tả loại cụm từ kêu gọi hành động cho phần sau khi gửi biểu mẫu cho biểu mẫu khách hàng tiềm năng.
Enum | |
---|---|
UNSPECIFIED |
Chưa chỉ định. |
UNKNOWN |
Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này. |
VISIT_SITE |
Truy cập trang web. |
DOWNLOAD |
Tải xuống. |
LEARN_MORE |
Tìm hiểu thêm. |
SHOP_NOW |
Mua ngay. |
LeadFormDesiredIntent
Enum mô tả mức độ ý định chọn lọc của khách hàng tiềm năng đã tạo.
Enum | |
---|---|
UNSPECIFIED |
Chưa chỉ định. |
UNKNOWN |
Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này. |
LOW_INTENT |
Phân phối thêm nhiều khách hàng tiềm năng với chất lượng có thể thấp hơn. |
HIGH_INTENT |
Cung cấp những khách hàng tiềm năng chất lượng hơn. |
BookOnGoogleAsset
Loại này không có trường.
Một tài sản Đặt phòng trên Google. Dùng để chuyển hướng người dùng đặt phòng qua Google. Tính năng Đặt phòng trên Google sẽ thay đổi URL chuyển hướng để đặt phòng trực tiếp qua Google.
PromotionAsset
Thành phần Chương trình khuyến mãi.
Biểu diễn dưới dạng JSON |
---|
{ "promotionTarget": string, "discountModifier": enum ( |
Trường | |
---|---|
promotionTarget |
Bắt buộc. Nội dung mô tả dạng tự do về nội dung mà chương trình khuyến mãi nhắm đến. |
discountModifier |
Công cụ sửa đổi để đủ điều kiện hưởng chiết khấu. |
redemptionStartDate |
Ngày bắt đầu khi chương trình khuyến mãi đủ điều kiện sử dụng, ở định dạng yyyy-MM-dd. |
redemptionEndDate |
Ngày cuối cùng mà chương trình khuyến mãi đủ điều kiện sử dụng, ở định dạng yyyy-MM-dd. |
occasion |
Dịp áp dụng chương trình khuyến mãi. Nếu bạn đặt một dịp, thì khoảng thời gian đổi thưởng cần phải nằm trong phạm vi ngày tương ứng với sự kiện đó. |
languageCode |
Ngôn ngữ của chương trình khuyến mãi. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47. |
startDate |
Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd. |
endDate |
Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd. |
adScheduleTargets[] |
Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu. |
Trường hợp discount_type . Loại chiết khấu, có thể là giảm giá theo phần trăm hoặc giảm giá. discount_type chỉ có thể là một trong những hình thức sau: |
|
percentOff |
Phần trăm chiết khấu trong chương trình khuyến mãi. 1.000.000 = 100%. Đây là yêu cầu bắt buộc phải có số tiền này hoặc amountAmountOff. |
moneyAmountOff |
Số tiền giảm giá trong chương trình khuyến mãi. Bạn phải áp dụng phần trăm chiết khấu hoặc phần trăm này. |
Trường hợp promotion_trigger . Trình kích hoạt khuyến mãi. Có thể bằng mã khuyến mãi hoặc khuyến mãi theo số tiền hợp lệ của đơn đặt hàng. promotion_trigger chỉ có thể là một trong những trạng thái sau: |
|
promotionCode |
Mã mà người dùng phải sử dụng để đủ điều kiện tham gia chương trình khuyến mãi. |
ordersOverAmount |
Số tiền của tổng đơn đặt hàng cần đạt được để người dùng đủ điều kiện tham gia chương trình khuyến mãi. |
CalloutAsset
Thành phần chú thích.
Biểu diễn dưới dạng JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Trường | |
---|---|
calloutText |
Bắt buộc. Văn bản chú thích. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25. |
startDate |
Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd. |
endDate |
Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd. |
adScheduleTargets[] |
Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu. |
StructuredSnippetAsset
Thành phần Đoạn thông tin có cấu trúc.
Biểu diễn dưới dạng JSON |
---|
{ "header": string, "values": [ string ] } |
Trường | |
---|---|
header |
Bắt buộc. Tiêu đề của đoạn thông tin. Chuỗi này phải là một trong các giá trị được xác định trước tại https://developers.google.com/google-ads/api/reference/data/structured-snippet-headers |
values[] |
Bắt buộc. Các giá trị trong đoạn mã. Kích thước của bộ sưu tập này nên nằm trong khoảng từ 3 đến 10. Độ dài của mỗi giá trị phải từ 1 đến 25 ký tự, bao gồm cả hai giá trị này. |
SitelinkAsset
Thành phần Đường liên kết của trang web.
Biểu diễn dưới dạng JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Trường | |
---|---|
linkText |
Bắt buộc. Văn bản hiển thị URL cho đường liên kết của trang web. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25. |
description1 |
Dòng đầu tiên của nội dung mô tả cho đường liên kết của trang web. Nếu đặt, độ dài phải nằm trong khoảng từ 1 đến 35, bao gồm cả phần mô tả và phần mô tả 2 cũng phải được đặt. |
description2 |
Dòng thứ hai của nội dung mô tả cho đường liên kết của trang web. Nếu đặt, độ dài phải nằm trong khoảng từ 1 đến 35, và bạn cũng phải đặt description1. |
startDate |
Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd. |
endDate |
Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd. |
adScheduleTargets[] |
Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu. |
PageFeedAsset
Thành phần Nguồn cấp dữ liệu trang.
Biểu diễn dưới dạng JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Trường | |
---|---|
pageUrl |
Bắt buộc. Trang web mà nhà quảng cáo muốn nhắm mục tiêu. |
labels[] |
Nhãn dùng để nhóm các URL trang. |
DynamicEducationAsset
Một thành phần Dynamic Education.
Biểu diễn dưới dạng JSON |
---|
{ "programId": string, "locationId": string, "programName": string, "subject": string, "programDescription": string, "schoolName": string, "address": string, "contextualKeywords": [ string ], "androidAppLink": string, "similarProgramIds": [ string ], "iosAppLink": string, "iosAppStoreId": string, "thumbnailImageUrl": string, "imageUrl": string } |
Trường | |
---|---|
programId |
Bắt buộc. Mã chương trình có thể là bất kỳ chuỗi chữ cái và số nào, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc. |
locationId |
Mã vị trí có thể là một chuỗi chữ cái và số bất kỳ và phải là duy nhất. |
programName |
Bắt buộc. Tên chương trình, ví dụ: Cho con bú. Bắt buộc. |
subject |
Đối tượng nghiên cứu, ví dụ: Sức khoẻ. |
programDescription |
Nội dung mô tả chương trình, ví dụ: Chứng chỉ điều dưỡng. |
schoolName |
Tên trường học, ví dụ: Trường điều dưỡng Mountain View. |
address |
Địa chỉ trường học có thể được chỉ định ở một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403 |
contextualKeywords[] |
Từ khoá theo ngữ cảnh (ví dụ: Chứng chỉ điều dưỡng, Sức khoẻ, Mountain View). |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
similarProgramIds[] |
Mã chương trình tương tự. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
thumbnailImageUrl |
URL hình ảnh thu nhỏ, ví dụ: http://www.example.com/thumbnail.png. Hình thu nhỏ sẽ không được tải lên dưới dạng thành phần hình ảnh. |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
MobileAppAsset
Một thành phần đại diện cho ứng dụng di động.
Biểu diễn dưới dạng JSON |
---|
{
"appId": string,
"appStore": enum ( |
Trường | |
---|---|
appId |
Bắt buộc. Một chuỗi xác định duy nhất một ứng dụng dành cho thiết bị di động. Tệp này chỉ nên chứa id gốc của nền tảng, chẳng hạn như "com.android.ebay" đối với Android hoặc "12345689" đối với iOS. |
appStore |
Bắt buộc. Cửa hàng ứng dụng phân phối ứng dụng cụ thể này. |
linkText |
Bắt buộc. Văn bản xuất hiện khi đường liên kết xuất hiện trong quảng cáo. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25. |
startDate |
Ngày bắt đầu mà thành phần này có hiệu lực và có thể bắt đầu phân phát, ở định dạng yyyy-MM-dd. |
endDate |
Ngày cuối cùng mà thành phần này có hiệu lực và vẫn đang phân phát, ở định dạng yyyy-MM-dd. |
HotelCalloutAsset
Thành phần đại diện cho chú thích cho khách sạn.
Biểu diễn dưới dạng JSON |
---|
{ "text": string, "languageCode": string } |
Trường | |
---|---|
text |
Bắt buộc. Văn bản của thành phần chú thích cho khách sạn. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25. |
languageCode |
Bắt buộc. Ngôn ngữ của chú thích cho khách sạn. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47. |
CallAsset
Thành phần Cuộc gọi.
Biểu diễn dưới dạng JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Trường | |
---|---|
countryCode |
Bắt buộc. Mã quốc gia gồm hai chữ cái của số điện thoại. Ví dụ: "US", "us". |
phoneNumber |
Bắt buộc. Số điện thoại thô của nhà quảng cáo. Ví dụ: "1234567890", "(123)456-7890" |
callConversionReportingState |
Cho biết liệu CallAsset này sẽ sử dụng chế độ cài đặt lượt chuyển đổi cuộc gọi riêng, tuân theo chế độ cài đặt cấp tài khoản hay tắt tính năng lượt chuyển đổi cuộc gọi. |
callConversionAction |
Hành động chuyển đổi để phân bổ lượt chuyển đổi dẫn đến cuộc gọi. Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng hành động chuyển đổi mặc định. Trường này chỉ có hiệu lực nếu callConversionReportingState được đặt thành USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
Danh sách các lịch biểu không trùng lặp chỉ định tất cả các khoảng thời gian mà nội dung có thể phân phát. Có thể có tối đa 6 lịch biểu mỗi ngày, tổng cộng 42 lịch biểu. |
PriceAsset
Một thành phần đại diện cho danh sách các ưu đãi về giá.
Biểu diễn dưới dạng JSON |
---|
{ "type": enum ( |
Trường | |
---|---|
type |
Bắt buộc. Loại thành phần giá. |
priceQualifier |
Bộ định giá của thành phần giá. |
languageCode |
Bắt buộc. Ngôn ngữ của thành phần giá. Được thể hiện dưới dạng thẻ ngôn ngữ BCP 47. |
priceOfferings[] |
Các đề xuất về giá của thành phần giá. Kích thước của bộ sưu tập này phải nằm trong khoảng từ 3 đến 8. |
PriceOffering
Một sản phẩm cung cấp giá duy nhất trong một thành phần giá.
Biểu diễn dưới dạng JSON |
---|
{ "header": string, "description": string, "price": { object ( |
Trường | |
---|---|
header |
Bắt buộc. Tiêu đề của nội dung cung cấp giá. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25. |
description |
Bắt buộc. Nội dung mô tả ưu đãi giá. Độ dài của chuỗi này phải nằm trong khoảng từ 1 đến 25. |
price |
Bắt buộc. Giá trị của sản phẩm đưa ra giá. |
unit |
Đơn vị giá của sản phẩm/dịch vụ cung cấp giá. |
finalUrl |
Bắt buộc. URL cuối cùng sau tất cả các lần chuyển hướng nhiều miền. |
finalMobileUrl |
URL cuối cùng trên thiết bị di động sau tất cả các lần chuyển hướng nhiều miền. |
CallToActionAsset
Thành phần lời kêu gọi hành động.
Biểu diễn dưới dạng JSON |
---|
{
"callToAction": enum ( |
Trường | |
---|---|
callToAction |
Lời kêu gọi hành động. |
DynamicRealEstateAsset
Một tài sản linh động về bất động sản.
Biểu diễn dưới dạng JSON |
---|
{ "listingId": string, "listingName": string, "cityName": string, "description": string, "address": string, "price": string, "imageUrl": string, "propertyType": string, "listingType": string, "contextualKeywords": [ string ], "formattedPrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarListingIds": [ string ] } |
Trường | |
---|---|
listingId |
Bắt buộc. Mã trang thông tin có thể là một chuỗi chữ cái và số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tái tiếp thị. Bắt buộc. |
listingName |
Bắt buộc. Tên trang thông tin, ví dụ: Boulevard Bungalow. Bắt buộc. |
cityName |
Tên thành phố, ví dụ: Mountain View, California. |
description |
Mô tả, ví dụ: 3 giường, 2 phòng tắm, 1568 bộ vuông. |
address |
Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403 |
price |
Giá có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng '.' làm dấu thập phân, ví dụ: 200.000.00 USD. |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
propertyType |
Loại tài sản, ví dụ: Nhà. |
listingType |
Loại trang thông tin, ví dụ: Để bán. |
contextualKeywords[] |
Từ khoá theo ngữ cảnh (ví dụ: Bán; Nhà rao bán). |
formattedPrice |
Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", chẳng hạn như Bắt đầu từ $200.000. |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
similarListingIds[] |
ID danh sách tương tự. |
DynamicCustomAsset
Một thành phần tuỳ chỉnh linh động.
Biểu diễn dưới dạng JSON |
---|
{ "id": string, "id2": string, "itemTitle": string, "itemSubtitle": string, "itemDescription": string, "itemAddress": string, "itemCategory": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "imageUrl": string, "contextualKeywords": [ string ], "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarIds": [ string ] } |
Trường | |
---|---|
id |
Bắt buộc. Mã nhận dạng có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại, ví dụ: xe sedan. Bắt buộc. |
id2 |
Mã nhận dạng 2 có thể là một chuỗi chữ cái và chữ số bất kỳ, ví dụ: màu đỏ. Chuỗi mã nhận dạng (mã nhận dạng + mã nhận dạng 2) phải là duy nhất. |
itemTitle |
Bắt buộc. Tiêu đề mặt hàng, ví dụ: Xe sedan cỡ trung. Bắt buộc. |
itemSubtitle |
Tên phụ của mặt hàng, chẳng hạn như Tại đại lý Mountain View của bạn. |
itemDescription |
Nội dung mô tả mặt hàng, ví dụ: Chiếc ô tô cỡ trung bán chạy nhất. |
itemAddress |
Địa chỉ mặt hàng có thể được chỉ định ở một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403 |
itemCategory |
Danh mục mặt hàng, ví dụ: xe sedan. |
price |
Giá có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng '.' làm dấu thập phân, ví dụ: 20.000 USD. |
salePrice |
Giá ưu đãi có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng '.' làm dấu thập phân, ví dụ: 15.000 USD. Phải nhỏ hơn trường "price". |
formattedPrice |
Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", chẳng hạn như Bắt đầu từ $20.000. |
formattedSalePrice |
Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Đang giảm giá với giá $15.000. |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
contextualKeywords[] |
Từ khoá theo ngữ cảnh (ví dụ: xe sedan, xe sedan 4 cửa). |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
similarIds[] |
ID tương tự. |
DynamicHotelsAndRentalsAsset
Một thành phần linh động về khách sạn và nhà nghỉ cho thuê.
Biểu diễn dưới dạng JSON |
---|
{ "propertyId": string, "propertyName": string, "imageUrl": string, "destinationName": string, "description": string, "price": string, "salePrice": string, "starRating": string, "category": string, "contextualKeywords": [ string ], "address": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "formattedPrice": string, "formattedSalePrice": string, "similarPropertyIds": [ string ] } |
Trường | |
---|---|
propertyId |
Bắt buộc. Mã tài sản có thể là một chuỗi chữ cái và số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc. |
propertyName |
Bắt buộc. Tên cơ sở lưu trú, ví dụ: Khách sạn Mountain View. Bắt buộc. |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
destinationName |
Tên điểm đến, ví dụ: Trung tâm thành phố Mountain View. |
description |
Nội dung mô tả, ví dụ: Gần sân bay SJC. |
price |
Giá có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD. |
salePrice |
Tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "price". |
starRating |
Điểm xếp hạng theo sao. Phải là một số từ 1 đến 5, bao gồm cả 1 số từ 1 đến 5. |
category |
Danh mục, ví dụ: Bộ khách sạn. |
contextualKeywords[] |
Từ khoá theo ngữ cảnh (ví dụ: "Khách sạn" ở Mountain View), khách sạn ở South Bay. |
address |
Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Kinh độ-vĩ độ ở định dạng DDD, ví dụ: 41.40338, 2.17403 |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
formattedPrice |
Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100. |
formattedSalePrice |
Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND. |
similarPropertyIds[] |
ID thuộc tính tương tự. |
DynamicFlightsAsset
Thành phần linh động về chuyến bay.
Biểu diễn dưới dạng JSON |
---|
{ "destinationId": string, "originId": string, "flightDescription": string, "imageUrl": string, "destinationName": string, "originName": string, "flightPrice": string, "flightSalePrice": string, "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string, "similarDestinationIds": [ string ], "customMapping": string } |
Trường | |
---|---|
destinationId |
Bắt buộc. Mã đích đến có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc. |
originId |
Mã điểm khởi hành có thể là một chuỗi chữ cái và chữ số bất kỳ. Chuỗi mã (mã đích đến + mã điểm khởi hành) phải là duy nhất. |
flightDescription |
Bắt buộc. Nội dung mô tả chuyến bay (ví dụ: Đặt vé). Bắt buộc. |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
destinationName |
Tên điểm đến, ví dụ: Paris. |
originName |
Tên điểm khởi hành, ví dụ: London. |
flightPrice |
Giá vé máy bay có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD. |
flightSalePrice |
Giá ưu đãi của chuyến bay có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "flightPrice". |
formattedPrice |
Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100. |
formattedSalePrice |
Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND. |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
similarDestinationIds[] |
Mã điểm đến tương tự, ví dụ: PAR,LON. |
customMapping |
Một trường tuỳ chỉnh có thể chứa nhiều khoá cho mục ánh xạ giá trị được phân tách bằng dấu phân cách (",", "|" và ":"), ở dạng " |
DiscoveryCarouselCardAsset
Tài sản Thẻ băng chuyền của quảng cáo Khám phá.
Biểu diễn dưới dạng JSON |
---|
{ "marketingImageAsset": string, "squareMarketingImageAsset": string, "portraitMarketingImageAsset": string, "headline": string, "callToActionText": string } |
Trường | |
---|---|
marketingImageAsset |
Tên tài nguyên thành phần của hình ảnh tiếp thị 1,91:1 được liên kết. Thành phần này và/hoặc hình ảnh tiếp thị hình vuông là bắt buộc. |
squareMarketingImageAsset |
Tên tài nguyên thành phần của hình ảnh tiếp thị hình vuông được liên kết. Bạn phải có thành phần này và/hoặc thành phần hình ảnh tiếp thị. |
portraitMarketingImageAsset |
Tên tài nguyên thành phần của hình ảnh tiếp thị dọc tỷ lệ 4:5 được liên kết. |
headline |
Bắt buộc. Dòng tiêu đề của thẻ băng chuyền. |
callToActionText |
Nội dung lời kêu gọi hành động. |
DynamicTravelAsset
Một thành phần linh động về du lịch.
Biểu diễn dưới dạng JSON |
---|
{ "destinationId": string, "originId": string, "title": string, "destinationName": string, "destinationAddress": string, "originName": string, "price": string, "salePrice": string, "formattedPrice": string, "formattedSalePrice": string, "category": string, "contextualKeywords": [ string ], "similarDestinationIds": [ string ], "imageUrl": string, "androidAppLink": string, "iosAppLink": string, "iosAppStoreId": string } |
Trường | |
---|---|
destinationId |
Bắt buộc. Mã đích đến có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc. |
originId |
Mã điểm khởi hành có thể là một chuỗi chữ cái và chữ số bất kỳ. Chuỗi mã (mã đích đến + mã điểm khởi hành) phải là duy nhất. |
title |
Bắt buộc. Tiêu đề, ví dụ: Đặt vé tàu. Bắt buộc. |
destinationName |
Tên điểm đến, ví dụ: Paris. |
destinationAddress |
Địa chỉ điểm đến có thể được chỉ định ở một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Vĩ độ-kinh độ ở định dạng DDD, ví dụ: 41,40338, 2,17403. |
originName |
Tên điểm khởi hành, ví dụ: London. |
price |
Giá có thể là một số theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD. |
salePrice |
Giá ưu đãi có thể là một con số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "price". |
formattedPrice |
Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100. |
formattedSalePrice |
Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND. |
category |
Danh mục, ví dụ: Sao lưu nhanh. |
contextualKeywords[] |
Từ khoá theo ngữ cảnh, ví dụ: tàu hoả ở Paris. |
similarDestinationIds[] |
Mã điểm đến tương tự, ví dụ: NYC. |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
DynamicLocalAsset
Một thành phần linh động tại địa phương.
Biểu diễn dưới dạng JSON |
---|
{ "dealId": string, "dealName": string, "subtitle": string, "description": string, "price": string, "salePrice": string, "imageUrl": string, "address": string, "category": string, "contextualKeywords": [ string ], "formattedPrice": string, "formattedSalePrice": string, "androidAppLink": string, "similarDealIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
Trường | |
---|---|
dealId |
Bắt buộc. Mã giao dịch có thể là bất kỳ chuỗi chữ cái và chữ số nào, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc. |
dealName |
Bắt buộc. Tên ưu đãi, ví dụ: giảm giá 50% tại Cửa hàng tạp hoá Mountain View. Bắt buộc. |
subtitle |
Tiêu đề phụ, ví dụ: Hàng tạp hoá. |
description |
Nội dung mô tả, ví dụ: Tiết kiệm trên hoá đơn hằng tuần của bạn. |
price |
Giá có thể là một số theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 100.00 USD. |
salePrice |
Giá ưu đãi có thể là số, theo sau là mã đơn vị tiền tệ dạng chữ cái, theo tiêu chuẩn ISO 4217. Sử dụng "." làm dấu thập phân, ví dụ: 80.00 USD. Phải nhỏ hơn trường "price". |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
address |
Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Vĩ độ-kinh độ ở định dạng DDD, ví dụ: 41,40338, 2,17403. |
category |
Danh mục, ví dụ: Thực phẩm. |
contextualKeywords[] |
Từ khoá theo ngữ cảnh, ví dụ: Lưu phiếu giảm giá hàng tạp hoá. |
formattedPrice |
Giá được định dạng có thể là bất kỳ ký tự nào. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "price", ví dụ: Bắt đầu từ $100. |
formattedSalePrice |
Giá ưu đãi được định dạng có thể là ký tự bất kỳ. Nếu bạn đặt thuộc tính này, thuộc tính này sẽ được sử dụng thay cho "giá ưu đãi", ví dụ: Giảm giá với giá 800.000 VND. |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
similarDealIds[] |
Mã giao dịch tương tự, ví dụ: 1275. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
DynamicJobsAsset
Một thành phần linh động về việc làm.
Biểu diễn dưới dạng JSON |
---|
{ "jobId": string, "locationId": string, "jobTitle": string, "jobSubtitle": string, "description": string, "imageUrl": string, "jobCategory": string, "contextualKeywords": [ string ], "address": string, "salary": string, "androidAppLink": string, "similarJobIds": [ string ], "iosAppLink": string, "iosAppStoreId": string } |
Trường | |
---|---|
jobId |
Bắt buộc. Mã công việc có thể là một chuỗi chữ cái và chữ số bất kỳ, đồng thời phải là duy nhất và khớp với các giá trị của thẻ tiếp thị lại. Bắt buộc. |
locationId |
Mã vị trí có thể là một chuỗi chữ cái và số bất kỳ. Chuỗi mã (mã công việc + mã vị trí) phải là duy nhất. |
jobTitle |
Bắt buộc. Chức danh, ví dụ: Kỹ sư phần mềm. Bắt buộc. |
jobSubtitle |
Chức danh phụ, ví dụ: Cấp II. |
description |
Nội dung mô tả (ví dụ: Áp dụng kỹ năng kỹ thuật). |
imageUrl |
URL của hình ảnh, ví dụ: http://www.example.com/image.png. Hình ảnh sẽ không được tải lên dưới dạng thành phần hình ảnh. |
jobCategory |
Danh mục công việc, ví dụ: Kỹ thuật. |
contextualKeywords[] |
Từ khoá theo ngữ cảnh (ví dụ: công việc kỹ thuật phần mềm). |
address |
Địa chỉ có thể được chỉ định bằng một trong các định dạng sau. (1) Thành phố, tiểu bang, mã, quốc gia, ví dụ: Mountain View, CA, Hoa Kỳ. (2) Địa chỉ đầy đủ, ví dụ: 123 Boulevard St, Mountain View, CA 94043. (3) Vĩ độ-kinh độ ở định dạng DDD, ví dụ: 41,40338, 2,17403. |
salary |
Lương, ví dụ: 100.000 đô la. |
androidAppLink |
Đường liên kết sâu của Android, chẳng hạn như android-app://com.example.android/http/example.com/gizmos?1234. |
similarJobIds[] |
Mã công việc tương tự, ví dụ: 1275. |
iosAppLink |
Đường liên kết sâu đến iOS, ví dụ: exampleApp://content/page. |
iosAppStoreId |
Mã cửa hàng ứng dụng iOS. Mã này dùng để kiểm tra xem người dùng đã cài đặt ứng dụng trên thiết bị của họ hay chưa trước khi bạn thêm đường liên kết sâu. Nếu bạn đặt trường này, thì cũng phải có trường iosAppLink. |
LocationAsset
Thành phần địa điểm.
Biểu diễn dưới dạng JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Trường | |
---|---|
placeId |
Mã địa điểm xác định duy nhất một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Trường này là dành riêng cho một mã khách hàng và loại thành phần nhất định. Xem https://developers.google.com/places/web-service/place-id để tìm hiểu thêm về Mã địa điểm. |
businessProfileLocations[] |
Danh sách địa điểm doanh nghiệp của khách hàng. Hệ thống sẽ chỉ trả về giá trị này nếu Thành phần địa điểm đang đồng bộ hoá từ tài khoản Trang doanh nghiệp. Bạn có thể có nhiều trang thông tin Trang doanh nghiệp trong cùng một tài khoản trỏ đến cùng một Mã địa điểm. |
locationOwnershipType |
Loại quyền sở hữu vị trí. Nếu loại doanh nghiệp là BUSINESS_OWNER, loại doanh nghiệp này sẽ được phân phát dưới dạng phần mở rộng về địa điểm. Nếu loại là AFFLIATE, loại sản phẩm này sẽ được phân phát dưới dạng vị trí của đơn vị liên kết. |
BusinessProfileLocation
Dữ liệu vị trí của Trang doanh nghiệp được đồng bộ hoá từ tài khoản Trang doanh nghiệp đã liên kết.
Biểu diễn dưới dạng JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Trường | |
---|---|
labels[] |
Nhãn do nhà quảng cáo chỉ định cho vị trí trên tài khoản Trang doanh nghiệp. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp. |
storeCode |
Mã cửa hàng trên Trang doanh nghiệp của vị trí này. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp. |
listingId |
Mã trang thông tin của vị trí trên Trang doanh nghiệp này. Thông tin này được đồng bộ hoá từ tài khoản Trang doanh nghiệp đã liên kết. |
HotelPropertyAsset
Thành phần cơ sở lưu trú khách sạn.
Biểu diễn dưới dạng JSON |
---|
{ "placeId": string, "hotelAddress": string, "hotelName": string } |
Trường | |
---|---|
placeId |
Mã địa điểm xác định duy nhất một địa điểm trong cơ sở dữ liệu Google Địa điểm và trên Google Maps. Hãy tham khảo https://developers.google.com/places/web-service/place-id để tìm hiểu thêm. |
hotelAddress |
Địa chỉ của khách sạn. Chỉ đọc. |
hotelName |
Tên khách sạn. Chỉ đọc. |