- การแสดง JSON
- FinalAppUrl
- AppUrlOperatingSystemType
- AdType
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- AdVideoAssetInfo
- AdVideoAssetInventoryPreferences
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- AdAppDeepLinkAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- AppPreRegistrationAdInfo
- DemandGenMultiAssetAdInfo
- DemandGenCarouselAdInfo
- AdDemandGenCarouselCardAsset
- DemandGenVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
โฆษณา
การแสดง JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
ช่อง | |
---|---|
resourceName |
เปลี่ยนแปลงไม่ได้ ชื่อทรัพยากรของโฆษณา ชื่อทรัพยากรโฆษณามีรูปแบบดังนี้
|
finalUrls[] |
รายการ URL สุดท้ายที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสําหรับโฆษณา |
finalAppUrls[] |
รายการ URL สุดท้ายของแอปที่จะใช้ในอุปกรณ์เคลื่อนที่หากผู้ใช้ติดตั้งแอปนั้นไว้ |
finalMobileUrls[] |
รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้หลังจากการเปลี่ยนเส้นทางข้ามโดเมนทั้งหมดสําหรับโฆษณา |
urlCustomParameters[] |
รายการการแมปที่สามารถใช้แทนแท็กพารามิเตอร์ที่กําหนดเองใน |
type |
เอาต์พุตเท่านั้น ประเภทของโฆษณา |
devicePreference |
ค่ากําหนดอุปกรณ์ของโฆษณา คุณจะระบุค่ากําหนดได้สําหรับอุปกรณ์เคลื่อนที่เท่านั้น เมื่อตั้งค่ากำหนดนี้ โฆษณาจะมีลำดับความสำคัญเหนือกว่าโฆษณาอื่นๆ เมื่อแสดงในอุปกรณ์เคลื่อนที่ โฆษณาจะยังคงแสดงในอุปกรณ์ประเภทอื่นๆ ได้ เช่น หากไม่มีโฆษณาอื่นที่พร้อมใช้งาน หากไม่ระบุ (ไม่มีค่ากําหนดอุปกรณ์) ระบบจะกําหนดเป้าหมายไปยังอุปกรณ์ทั้งหมด โฆษณาบางประเภทเท่านั้นที่รองรับการทดสอบนี้ |
urlCollections[] |
URL เพิ่มเติมสําหรับโฆษณาที่ติดแท็กด้วยตัวระบุที่ไม่ซ้ำกันซึ่งอ้างอิงได้จากช่องอื่นๆ ในโฆษณา |
systemManagedResourceSource |
เอาต์พุตเท่านั้น หากโฆษณานี้จัดการโดยระบบ ช่องนี้จะระบุแหล่งที่มา ช่องนี้เป็นแบบอ่านอย่างเดียว |
id |
เอาต์พุตเท่านั้น รหัสของโฆษณา |
trackingUrlTemplate |
เทมเพลต URL สำหรับสร้าง URL ติดตาม |
finalUrlSuffix |
คำต่อท้ายที่จะใช้เมื่อสร้าง URL สุดท้าย |
displayUrl |
URL ที่ปรากฏในคำอธิบายโฆษณาสำหรับโฆษณาบางรูปแบบ |
addedByGoogleAds |
เอาต์พุตเท่านั้น ระบุว่า Google Ads เพิ่มโฆษณานี้โดยอัตโนมัติหรือไม่ ตัวอย่างเช่น กรณีนี้อาจเกิดขึ้นเมื่อระบบสร้างโฆษณาโดยอัตโนมัติเป็นคําแนะนําสําหรับโฆษณาใหม่โดยอิงตามความรู้เกี่ยวกับประสิทธิภาพของโฆษณาที่มีอยู่ |
name |
เปลี่ยนแปลงไม่ได้ ชื่อโฆษณา การตั้งค่านี้ใช้เพื่อระบุโฆษณาเท่านั้น โดยไม่จำเป็นต้องซ้ำกันและจะไม่ส่งผลต่อโฆษณาที่แสดง ปัจจุบันช่องชื่อรองรับเฉพาะ DisplayUploadAd, ImageAd, ShoppingComparisonListingAd และ VideoAd เท่านั้น |
ฟิลด์สหภาพ ad_data รายละเอียดที่เกี่ยวข้องกับประเภทโฆษณา ต้องตั้งค่าเพียง 1 ค่าเท่านั้น ad_data ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
textAd |
เปลี่ยนแปลงไม่ได้ รายละเอียดที่เกี่ยวข้องกับโฆษณาแบบข้อความ |
expandedTextAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาแบบข้อความที่ขยายออก |
callAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาแบบโทร |
expandedDynamicSearchAd |
เปลี่ยนแปลงไม่ได้ รายละเอียดเกี่ยวกับโฆษณา Search แบบไดนามิกอย่างกว้าง โฆษณาประเภทนี้มีบรรทัดแรก, URL สุดท้าย และ URL ที่แสดงซึ่งสร้างขึ้นโดยอัตโนมัติ ณ เวลาแสดงตามข้อมูลที่เจาะจงของชื่อโดเมนที่ได้จาก |
hotelAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาโรงแรม |
shoppingSmartAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณา Smart Shopping |
shoppingProductAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาผลิตภัณฑ์ Shopping |
imageAd |
เปลี่ยนแปลงไม่ได้ รายละเอียดที่เกี่ยวข้องกับโฆษณาแบบรูปภาพ |
videoAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาวิดีโอ |
videoResponsiveAd |
รายละเอียดเกี่ยวกับโฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา |
responsiveSearchAd |
รายละเอียดเกี่ยวกับโฆษณา Search ที่ปรับเปลี่ยนตามบริบท |
legacyResponsiveDisplayAd |
รายละเอียดเกี่ยวกับโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณาเดิม |
appAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาแอป |
legacyAppInstallAd |
เปลี่ยนแปลงไม่ได้ รายละเอียดที่เกี่ยวข้องกับโฆษณาเพื่อการติดตั้งแอปรุ่นเดิม |
responsiveDisplayAd |
รายละเอียดเกี่ยวกับโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา |
localAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาในพื้นที่ |
displayUploadAd |
รายละเอียดเกี่ยวกับโฆษณา Display ที่อัปโหลด |
appEngagementAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาเพื่อการมีส่วนร่วมในแอป |
shoppingComparisonListingAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาเปรียบเทียบสินค้า Shopping |
smartCampaignAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณา Smart Campaign |
appPreRegistrationAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาการลงทะเบียนล่วงหน้าของแอป |
demandGenMultiAssetAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณา Demand Gen ที่มีชิ้นงานหลายรายการ |
demandGenCarouselAd |
รายละเอียดเกี่ยวกับโฆษณาแบบภาพสไลด์ Demand Gen |
demandGenVideoResponsiveAd |
รายละเอียดเกี่ยวกับโฆษณาวิดีโอแบบปรับเปลี่ยนตามพื้นที่โฆษณาของ Demand Gen |
demandGenProductAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาผลิตภัณฑ์ Demand Gen |
travelAd |
รายละเอียดที่เกี่ยวข้องกับโฆษณาการเดินทาง |
FinalAppUrl
URL สําหรับการทำ Deep Link ไปยังแอปสําหรับระบบปฏิบัติการที่ระบุ
การแสดง JSON |
---|
{
"osType": enum ( |
ช่อง | |
---|---|
osType |
ระบบปฏิบัติการที่ URL นี้กําหนดเป้าหมาย ต้องระบุ |
url |
URL ของ Deep Link ของแอป Deep Link จะระบุตำแหน่งในแอปที่สอดคล้องกับเนื้อหาที่คุณต้องการแสดง และควรอยู่ในรูปแบบ {scheme}://{host_path} โดยรูปแบบจะระบุแอปที่จะเปิด สําหรับแอป คุณสามารถใช้รูปแบบที่กําหนดเองซึ่งขึ้นต้นด้วยชื่อแอป โฮสต์และเส้นทางจะระบุตำแหน่งที่ไม่ซ้ำกันในแอปที่มีเนื้อหาของคุณอยู่ เช่น "exampleapp://productid_1234" ต้องระบุ |
AppUrlOperatingSystemType
ระบบปฏิบัติการ
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้ |
IOS |
ระบบปฏิบัติการ Apple iOS |
ANDROID |
ระบบปฏิบัติการ Android |
AdType
ประเภทโฆษณาที่เป็นไปได้
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุค่าไว้ |
UNKNOWN |
ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้ ค่านี้เป็นค่าตอบกลับเท่านั้น |
TEXT_AD |
โฆษณาเป็นโฆษณาแบบข้อความ |
EXPANDED_TEXT_AD |
โฆษณาเป็นโฆษณาแบบข้อความที่ขยายออก |
EXPANDED_DYNAMIC_SEARCH_AD |
โฆษณาเป็นโฆษณา Search แบบไดนามิกอย่างกว้าง |
HOTEL_AD |
โฆษณาเป็นโฆษณาโรงแรม |
SHOPPING_SMART_AD |
โฆษณาเป็นโฆษณา Smart Shopping |
SHOPPING_PRODUCT_AD |
โฆษณานี้เป็นโฆษณา Shopping มาตรฐาน |
VIDEO_AD |
โฆษณาเป็นโฆษณาวิดีโอ |
IMAGE_AD |
โฆษณานี้เป็นโฆษณาแบบรูปภาพ |
RESPONSIVE_SEARCH_AD |
โฆษณาเป็นโฆษณา Search ที่ปรับเปลี่ยนตามบริบท |
LEGACY_RESPONSIVE_DISPLAY_AD |
โฆษณานี้เป็นโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณาเดิม |
APP_AD |
โฆษณาเป็นแอปโฆษณา |
LEGACY_APP_INSTALL_AD |
โฆษณานี้เป็นโฆษณาเพื่อการติดตั้งแอปรุ่นเดิม |
RESPONSIVE_DISPLAY_AD |
โฆษณานี้เป็นโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา |
LOCAL_AD |
โฆษณาเป็นโฆษณาในพื้นที่ |
HTML5_UPLOAD_AD |
โฆษณาเป็นโฆษณา Display ที่อัปโหลดซึ่งมีประเภทผลิตภัณฑ์ HTML5_UPLOAD_AD |
DYNAMIC_HTML5_AD |
โฆษณาเป็นโฆษณา Display ที่อัปโหลดซึ่งมีผลิตภัณฑ์ประเภท DYNAMIC_HTML5_* ประเภทใดประเภทหนึ่ง |
APP_ENGAGEMENT_AD |
โฆษณานี้เป็นโฆษณาเพื่อการมีส่วนร่วมกับแอป |
SHOPPING_COMPARISON_LISTING_AD |
โฆษณาเป็นโฆษณาเปรียบเทียบสินค้า Shopping |
VIDEO_BUMPER_AD |
โฆษณาวิดีโอบัมเปอร์ |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
โฆษณาในสตรีมแบบข้ามไม่ได้สำหรับวิดีโอ |
VIDEO_TRUEVIEW_IN_STREAM_AD |
โฆษณา TrueView ในสตรีมวิดีโอ |
VIDEO_RESPONSIVE_AD |
โฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา |
SMART_CAMPAIGN_AD |
โฆษณา Smart Campaign |
CALL_AD |
โฆษณาแบบโทรออก |
APP_PRE_REGISTRATION_AD |
โฆษณาการลงทะเบียนล่วงหน้าของ Universal App |
IN_FEED_VIDEO_AD |
โฆษณาวิดีโอในฟีด |
DEMAND_GEN_MULTI_ASSET_AD |
โฆษณา Demand Gen แบบหลายชิ้นงาน |
DEMAND_GEN_CAROUSEL_AD |
โฆษณาแบบภาพสไลด์ Demand Gen |
TRAVEL_AD |
โฆษณาการท่องเที่ยว |
DEMAND_GEN_VIDEO_RESPONSIVE_AD |
โฆษณาวิดีโอ Demand Gen ที่ปรับเปลี่ยนตามพื้นที่โฆษณา |
DEMAND_GEN_PRODUCT_AD |
โฆษณาผลิตภัณฑ์ Demand Gen |
UrlCollection
ชุด URL ที่ติดแท็กด้วยตัวระบุที่ไม่ซ้ำกัน
การแสดง JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
ช่อง | |
---|---|
finalUrls[] |
รายการ URL สุดท้ายที่เป็นไปได้ |
finalMobileUrls[] |
รายการ URL สุดท้ายบนอุปกรณ์เคลื่อนที่ที่เป็นไปได้ |
urlCollectionId |
ตัวระบุที่ไม่ซ้ำกันสำหรับอินสแตนซ์ UrlCollection นี้ |
trackingUrlTemplate |
เทมเพลต URL สำหรับสร้าง URL ติดตาม |
SystemManagedResourceSource
Enum ที่แสดงแหล่งที่มาของเอนทิตีที่ระบบจัดการที่เป็นไปได้
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้ |
AD_VARIATIONS |
โฆษณาการทดสอบรูปแบบโฆษณาที่สร้างขึ้น |
TextAdInfo
โฆษณาแบบข้อความ
การแสดง JSON |
---|
{ "headline": string, "description1": string, "description2": string } |
ช่อง | |
---|---|
headline |
บรรทัดแรกของโฆษณา |
description1 |
บรรทัดแรกของคําอธิบายโฆษณา |
description2 |
บรรทัดที่สองของคําอธิบายโฆษณา |
ExpandedTextAdInfo
โฆษณาแบบข้อความที่ขยายออก
การแสดง JSON |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
ช่อง | |
---|---|
headlinePart1 |
ส่วนแรกของบรรทัดแรกของโฆษณา |
headlinePart2 |
ส่วนที่สองของบรรทัดแรกของโฆษณา |
headlinePart3 |
ส่วนที่สามของบรรทัดแรกของโฆษณา |
description |
คําอธิบายโฆษณา |
description2 |
คําอธิบายที่ 2 ของโฆษณา |
path1 |
ข้อความที่อาจปรากฏข้าง URL ที่แสดงของโฆษณา |
path2 |
ข้อความเพิ่มเติมที่อาจปรากฏข้าง URL ที่แสดงของโฆษณา |
CallAdInfo
โฆษณาแบบโทร
การแสดง JSON |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
ช่อง | |
---|---|
countryCode |
รหัสประเทศในโฆษณา |
phoneNumber |
หมายเลขโทรศัพท์ในโฆษณา |
businessName |
ชื่อธุรกิจในโฆษณา |
headline1 |
บรรทัดแรกในโฆษณา |
headline2 |
บรรทัดแรกที่ 2 ในโฆษณา |
description1 |
บรรทัดแรกของคําอธิบายโฆษณา |
description2 |
บรรทัดที่สองของคําอธิบายโฆษณา |
callTracked |
การเปิดใช้การติดตามการโทรสําหรับครีเอทีฟโฆษณา การเปิดใช้การติดตามการโทรจะเป็นการเปิดใช้ Conversion การโทรด้วย |
disableCallConversion |
ปิดใช้ Conversion การโทรสําหรับครีเอทีฟโฆษณาหรือไม่ หากตั้งค่าเป็น |
phoneNumberVerificationUrl |
URL ที่จะใช้ในการยืนยันหมายเลขโทรศัพท์ |
conversionAction |
การกระทําที่ถือเป็น Conversion ที่จะระบุแหล่งที่มาของ Conversion การโทร หากไม่ได้ตั้งค่า ระบบจะใช้การกระทําที่ถือเป็น Conversion เริ่มต้น ช่องนี้จะมีผลต่อเมื่อตั้งค่า |
conversionReportingState |
ลักษณะการทํางานของ Conversion การโทรของโฆษณาแบบโทรออกนี้ โดยใช้การตั้งค่า Conversion การโทรของตนเอง รับค่าการตั้งค่าระดับบัญชี หรือปิดใช้ก็ได้ |
path1 |
ส่วนแรกของข้อความที่ต่อท้าย URL ในโฆษณาได้ ไม่บังคับ |
path2 |
ข้อความส่วนที่สองที่ต่อท้าย URL ในโฆษณาได้ ฟิลด์นี้จะตั้งค่าได้ก็ต่อเมื่อตั้งค่า |
ExpandedDynamicSearchAdInfo
โฆษณา Search แบบไดนามิกอย่างกว้าง
การแสดง JSON |
---|
{ "description": string, "description2": string } |
ช่อง | |
---|---|
description |
คําอธิบายโฆษณา |
description2 |
คําอธิบายที่ 2 ของโฆษณา |
HotelAdInfo
ประเภทนี้ไม่มีช่อง
โฆษณาโรงแรม
ShoppingSmartAdInfo
ประเภทนี้ไม่มีช่อง
โฆษณา Smart Shopping
ShoppingProductAdInfo
ประเภทนี้ไม่มีช่อง
โฆษณา Shopping มาตรฐาน
ImageAdInfo
โฆษณาแบบรูปภาพ
การแสดง JSON |
---|
{ "mimeType": enum ( |
ช่อง | |
---|---|
mimeType |
ประเภท MIME ของรูปภาพ |
pixelWidth |
ความกว้างเป็นพิกเซลของรูปภาพขนาดเต็ม |
pixelHeight |
ความสูงเป็นพิกเซลของรูปภาพขนาดเต็ม |
imageUrl |
URL ของรูปภาพขนาดเต็ม |
previewPixelWidth |
ความกว้างเป็นพิกเซลของรูปภาพขนาดตัวอย่าง |
previewPixelHeight |
ความสูงเป็นพิกเซลของรูปภาพขนาดตัวอย่าง |
previewImageUrl |
URL ของรูปภาพขนาดตัวอย่าง |
name |
ชื่อรูปภาพ หากรูปภาพสร้างขึ้นจาก MediaFile จะเป็นชื่อของ MediaFile หากรูปภาพสร้างขึ้นจากไบต์ ช่องนี้จะว่างเปล่า |
ฟิลด์สหภาพ image รูปภาพที่จะสร้าง ImageAd ซึ่งระบุได้ 2 วิธีดังนี้ 1. ทรัพยากร MediaFile ที่มีอยู่ 2. ข้อมูลรูปภาพดิบเป็นไบต์ image ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
imageAsset |
ชิ้นงานรูปภาพที่ใช้สําหรับโฆษณา |
data |
ข้อมูลรูปภาพดิบเป็นไบต์ สตริงที่เข้ารหัส Base64 |
adIdToCopyImageFrom |
รหัสโฆษณาที่จะคัดลอกรูปภาพ |
AdImageAsset
ชิ้นงานรูปภาพที่ใช้ในโฆษณา
การแสดง JSON |
---|
{ "asset": string } |
ช่อง | |
---|---|
asset |
ชื่อแหล่งข้อมูลของชิ้นงานนี้ |
VideoAdInfo
โฆษณาวิดีโอ
การแสดง JSON |
---|
{ "video": { object ( |
ช่อง | |
---|---|
video |
ชิ้นงานวิดีโอ YouTube ที่ใช้สำหรับโฆษณา |
ฟิลด์สหภาพ format สคีมาเฉพาะรูปแบบสำหรับวิดีโอรูปแบบต่างๆ format ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
inStream |
รูปแบบโฆษณา TrueView ในสตรีมวิดีโอ |
bumper |
รูปแบบโฆษณาบัมเปอร์วิดีโอในสตรีม |
outStream |
รูปแบบโฆษณาวิดีโอนอกสตรีม |
nonSkippable |
รูปแบบโฆษณาในสตรีมแบบข้ามไม่ได้ของวิดีโอ |
inFeed |
รูปแบบโฆษณาวิดีโอในฟีด |
AdVideoAsset
ชิ้นงานวิดีโอที่ใช้ภายในโฆษณา
การแสดง JSON |
---|
{
"asset": string,
"adVideoAssetInfo": {
object ( |
ช่อง | |
---|---|
asset |
ชื่อทรัพยากรของเนื้อหาวิดีโอนี้ |
adVideoAssetInfo |
มีช่องข้อมูลสําหรับ AdVideoAsset นี้ |
AdVideoAssetInfo
มีช่องข้อมูลสําหรับ AdVideoAssets
การแสดง JSON |
---|
{
"adVideoAssetInventoryPreferences": {
object ( |
ช่อง | |
---|---|
adVideoAssetInventoryPreferences |
รายการค่ากําหนดพื้นที่โฆษณาสําหรับ AdVideoAsset นี้ ฟิลด์นี้ตั้งค่าได้สําหรับ DiscoveryVideoResponsiveAd เท่านั้น ระบบจะเลือกใช้ชิ้นงานวิดีโอที่มีการตั้งค่าชิ้นงานพื้นที่โฆษณามากกว่าวิดีโออื่นๆ จากโฆษณาเดียวกันในช่วงเวลาที่แสดง ตัวอย่างเช่น พิจารณาว่าโฆษณานี้แสดงในพื้นที่โฆษณาที่เฉพาะเจาะจง ก่อนอื่น เซิร์ฟเวอร์จะพยายามจับคู่วิดีโอที่มีสิทธิ์กับค่ากําหนดซึ่งตรงกันสำหรับพื้นที่โฆษณานั้น ระบบจะเลือกวิดีโอที่ไม่มีค่ากําหนดเฉพาะในกรณีที่ไม่พบวิดีโอที่มีค่ากําหนดตรงกันและมีสิทธิ์แสดงในช่องโฆษณาหนึ่งๆ |
AdVideoAssetInventoryPreferences
ค่ากําหนดพื้นที่โฆษณาของชิ้นงานวิดีโอ YouTube
การแสดง JSON |
---|
{ "inFeedPreference": boolean, "inStreamPreference": boolean, "shortsPreference": boolean } |
ช่อง | |
---|---|
inFeedPreference |
เมื่อเป็น "จริง" ระบบจะเลือกชิ้นงานวิดีโอ YouTube ที่มีค่ากำหนดพื้นที่โฆษณานี้เมื่อเลือกวิดีโอเพื่อแสดงในฟีด |
inStreamPreference |
เมื่อเป็น "จริง" ระบบจะเลือกชิ้นงานวิดีโอ YouTube ที่มีค่ากำหนดพื้นที่โฆษณานี้เมื่อเลือกวิดีโอเพื่อแสดงในสตรีม |
shortsPreference |
เมื่อเป็น "จริง" ระบบจะเลือกชิ้นงานวิดีโอ YouTube ที่มีค่ากำหนดพื้นที่โฆษณานี้เมื่อเลือกวิดีโอที่จะแสดงใน YouTube Shorts |
VideoTrueViewInStreamAdInfo
การนําเสนอรูปแบบโฆษณา TrueView ในสตรีมของวิดีโอ (โฆษณาที่แสดงระหว่างการเล่นวิดีโอ ซึ่งมักแสดงในช่วงต้นและจะมีปุ่มข้ามเมื่อวิดีโอเล่นไปแล้ว 2-3 วินาที)
การแสดง JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
ช่อง | |
---|---|
actionButtonLabel |
ป้ายกำกับบนปุ่ม CTA (คำกระตุ้นให้ดำเนินการ) ที่นําผู้ใช้ไปยัง URL สุดท้ายของโฆษณาวิดีโอ ต้องระบุสำหรับแคมเปญ TrueView for Action แต่จะไม่บังคับหากไม่ต้องการ |
actionHeadline |
ข้อความเพิ่มเติมที่แสดงพร้อมกับปุ่ม CTA (คำกระตุ้นให้ดำเนินการ) เพื่อระบุบริบทและกระตุ้นให้คลิกปุ่ม |
companionBanner |
ชิ้นงานรูปภาพของแบนเนอร์ประกอบที่ใช้กับโฆษณา |
VideoBumperInStreamAdInfo
การนําเสนอรูปแบบโฆษณาบัมเปอร์วิดีโอในสตรีม (โฆษณาวิดีโอในสตรีมแบบข้ามไม่ได้ที่มีความยาวสั้นมาก)
การแสดง JSON |
---|
{
"companionBanner": {
object ( |
ช่อง | |
---|---|
companionBanner |
ชิ้นงานรูปภาพของแบนเนอร์ประกอบที่ใช้กับโฆษณา |
actionButtonLabel |
ป้ายกำกับบนปุ่ม "คำกระตุ้นให้ดำเนินการ" ที่นําผู้ใช้ไปยัง URL สุดท้ายของโฆษณาวิดีโอ |
actionHeadline |
ข้อความเพิ่มเติมที่แสดงพร้อมกับปุ่ม CTA (คำกระตุ้นให้ดำเนินการ) เพื่อระบุบริบทและกระตุ้นให้คลิกปุ่ม |
VideoOutstreamAdInfo
การนําเสนอรูปแบบโฆษณาวิดีโอนอกสตรีม (โฆษณาที่แสดงควบคู่ไปกับฟีดที่เล่นอัตโนมัติโดยไม่มีเสียง)
การแสดง JSON |
---|
{ "headline": string, "description": string } |
ช่อง | |
---|---|
headline |
บรรทัดแรกของโฆษณา |
description |
บรรทัดรายละเอียด |
VideoNonSkippableInStreamAdInfo
การนําเสนอรูปแบบโฆษณาในสตรีมแบบข้ามไม่ได้ของวิดีโอ (โฆษณาวิดีโอในสตรีมแบบข้ามไม่ได้ความยาว 15 วินาที)
การแสดง JSON |
---|
{
"companionBanner": {
object ( |
ช่อง | |
---|---|
companionBanner |
ชิ้นงานรูปภาพของแบนเนอร์ประกอบที่ใช้กับโฆษณา |
actionButtonLabel |
ป้ายกำกับบนปุ่ม "คำกระตุ้นให้ดำเนินการ" ที่นําผู้ใช้ไปยัง URL สุดท้ายของโฆษณาวิดีโอ |
actionHeadline |
ข้อความเพิ่มเติมที่แสดงพร้อมกับปุ่ม "คำกระตุ้นให้ดำเนินการ" เพื่อระบุบริบทและกระตุ้นให้คลิกปุ่ม |
InFeedVideoAdInfo
การนําเสนอรูปแบบโฆษณาวิดีโอในฟีด
การแสดง JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
ช่อง | |
---|---|
headline |
บรรทัดแรกของโฆษณา |
description1 |
บรรทัดข้อความแรกสําหรับโฆษณา |
description2 |
บรรทัดข้อความที่ 2 สำหรับโฆษณา |
thumbnail |
รูปภาพขนาดย่อของวิดีโอที่จะใช้ |
VideoThumbnail
Enum ที่แสดงรายการประเภทของภาพปกวิดีโอที่เป็นไปได้
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุประเภท |
UNKNOWN |
ระบบไม่รู้จักค่าที่ได้รับในเวอร์ชันนี้ ค่านี้เป็นค่าตอบกลับเท่านั้น |
DEFAULT_THUMBNAIL |
ภาพปกเริ่มต้น สามารถสร้างโดยอัตโนมัติหรือผู้ใช้อัปโหลดก็ได้ |
THUMBNAIL_1 |
ภาพปก 1 ที่สร้างขึ้นจากวิดีโอ |
THUMBNAIL_2 |
ภาพปก 2 ที่สร้างขึ้นจากวิดีโอ |
THUMBNAIL_3 |
ภาพปก 3 ที่สร้างขึ้นจากวิดีโอ |
VideoResponsiveAdInfo
โฆษณาวิดีโอที่ปรับเปลี่ยนตามพื้นที่โฆษณา
การแสดง JSON |
---|
{ "headlines": [ { object ( |
ช่อง | |
---|---|
headlines[] |
รายการชิ้นงานข้อความที่ใช้สำหรับบรรทัดแรกแบบสั้น ปัจจุบันระบบรองรับเฉพาะค่าเดียวสำหรับบรรทัดแรกสั้นๆ |
longHeadlines[] |
รายการชิ้นงานข้อความที่ใช้สำหรับบรรทัดแรกแบบยาว ปัจจุบันระบบรองรับเฉพาะค่าเดียวสําหรับบรรทัดแรกแบบยาว |
descriptions[] |
รายการชิ้นงานข้อความที่ใช้สำหรับคำอธิบาย ปัจจุบันระบบรองรับคำอธิบายเพียงค่าเดียวเท่านั้น |
callToActions[] |
รายการชิ้นงานข้อความที่ใช้สำหรับปุ่ม เช่น ปุ่ม "คำกระตุ้นให้ดำเนินการ" ปัจจุบันระบบรองรับเฉพาะค่าเดียวสำหรับปุ่ม |
videos[] |
รายการชิ้นงานวิดีโอ YouTube ที่ใช้สําหรับโฆษณา ปัจจุบันระบบรองรับเฉพาะค่าเดียวสำหรับชิ้นงานวิดีโอ YouTube |
companionBanners[] |
รายการชิ้นงานรูปภาพที่ใช้สําหรับแบนเนอร์ที่แสดงร่วมกัน ปัจจุบันระบบรองรับเฉพาะค่าเดียวสำหรับชิ้นงานแบนเนอร์ประกอบ |
breadcrumb1 |
ส่วนแรกของข้อความที่ปรากฏในโฆษณาพร้อมกับ URL ที่แสดง |
breadcrumb2 |
ข้อความส่วนที่ 2 ที่ปรากฏในโฆษณาพร้อมกับ URL ที่แสดง |
ResponsiveSearchAdInfo
โฆษณา Search ที่ปรับเปลี่ยนตามบริบท
โฆษณา Search ที่ปรับเปลี่ยนตามบริบทช่วยให้คุณสร้างโฆษณาที่ปรับเปลี่ยนเพื่อแสดงข้อความให้มากขึ้นและส่งสารที่ตรงตามความต้องการของลูกค้ามากขึ้นด้วย กรอกบรรทัดแรกและคำอธิบายหลายรายการเมื่อสร้างโฆษณา Search ที่ปรับเปลี่ยนตามบริบท แล้วเมื่อเวลาผ่านไป Google Ads จะทดสอบบรรทัดแรกและคำอธิบายต่างๆ ผสมกันโดยอัตโนมัติเพื่อดูว่าส่วนผสมแบบใดทำงานเข้ากันได้ดีที่สุด โฆษณา Search ที่ปรับเปลี่ยนตามบริบทอาจช่วยปรับปรุงประสิทธิภาพแคมเปญของคุณได้โดยการปรับเปลี่ยนเนื้อหาของโฆษณาให้ใกล้เคียงกับข้อความค้นหาของผู้มีโอกาสเป็นลูกค้ามากขึ้น
ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/google-ads/answer/7684791
การแสดง JSON |
---|
{ "headlines": [ { object ( |
ช่อง | |
---|---|
headlines[] |
รายการชิ้นงานข้อความสำหรับบรรทัดแรก เมื่อโฆษณาแสดง ระบบจะเลือกบรรทัดแรกจากรายการนี้ |
descriptions[] |
รายการชิ้นงานข้อความสําหรับคําอธิบาย เมื่อโฆษณาแสดง ระบบจะเลือกคําอธิบายจากรายการนี้ |
path1 |
ส่วนแรกของข้อความที่ต่อท้าย URL ในโฆษณาได้ |
path2 |
ข้อความส่วนที่สองที่ต่อท้าย URL ในโฆษณาได้ ฟิลด์นี้จะตั้งค่าได้ก็ต่อเมื่อตั้งค่า |
LegacyResponsiveDisplayAdInfo
โฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณาเดิม โฆษณาประเภทนี้มีป้ายกํากับว่า "โฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณา" ใน UI ของ Google Ads
การแสดง JSON |
---|
{
"formatSetting": enum ( |
ช่อง | |
---|---|
formatSetting |
ระบุรูปแบบที่โฆษณาจะแสดง ค่าเริ่มต้นคือ ALL_FORMATS |
shortHeadline |
บรรทัดแรกของโฆษณาเวอร์ชันสั้น |
longHeadline |
บรรทัดแรกของโฆษณาเวอร์ชันยาว |
description |
คําอธิบายโฆษณา |
businessName |
ชื่อธุรกิจในโฆษณา |
allowFlexibleColor |
ความยินยอมของผู้ลงโฆษณาในการอนุญาตให้ใช้สีที่ปรับเปลี่ยนได้ เมื่อเป็น "จริง" โฆษณาอาจแสดงด้วยสีอื่นหากจําเป็น เมื่อเป็นเท็จ โฆษณาจะแสดงด้วยสีที่ระบุหรือสีกลาง ค่าเริ่มต้นคือ |
accentColor |
สีเฉพาะจุดของโฆษณาในรูปแบบเลขฐานสิบหก เช่น #ffffff สำหรับสีขาว หากตั้งค่า |
mainColor |
สีหลักของโฆษณาในรูปแบบเลขฐาน 16 เช่น #ffffff สำหรับสีขาว หากตั้งค่า |
callToActionText |
ข้อความกระตุ้นให้ดำเนินการ (Call-To-Action) สําหรับโฆษณา |
logoImage |
ชื่อทรัพยากร MediaFile ของรูปภาพโลโก้ที่ใช้ในโฆษณา |
squareLogoImage |
ชื่อทรัพยากร MediaFile ของรูปภาพโลโก้สี่เหลี่ยมจัตุรัสที่ใช้ในโฆษณา |
marketingImage |
ชื่อทรัพยากร MediaFile ของรูปภาพการตลาดที่ใช้ในโฆษณา |
squareMarketingImage |
ชื่อทรัพยากร MediaFile ของรูปภาพการตลาดสี่เหลี่ยมจัตุรัสที่ใช้ในโฆษณา |
pricePrefix |
คำนำหน้าก่อนราคา เช่น "ถูกสุดที่" |
promoText |
ข้อความโปรโมชันที่ใช้กับรูปแบบโฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณาแบบไดนามิก เช่น "จัดส่งฟรีภายใน 2 วัน" |
DisplayAdFormatSetting
แสดงรายการการตั้งค่ารูปแบบโฆษณา Display
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ค่านี้ไม่รู้จักในเวอร์ชันนี้ |
ALL_FORMATS |
รูปแบบข้อความ รูปภาพ และเนทีฟ |
NON_NATIVE |
รูปแบบข้อความและรูปภาพ |
NATIVE |
รูปแบบเนทีฟ เช่น ผู้เผยแพร่โฆษณาเป็นผู้ควบคุมการแสดงผลรูปแบบ ไม่ใช่ Google |
AppAdInfo
โฆษณาแอป
การแสดง JSON |
---|
{ "mandatoryAdText": { object ( |
ช่อง | |
---|---|
mandatoryAdText |
ข้อความโฆษณาที่ต้องใส่ |
headlines[] |
รายการชิ้นงานข้อความสำหรับบรรทัดแรก เมื่อโฆษณาแสดง ระบบจะเลือกบรรทัดแรกจากรายการนี้ |
descriptions[] |
รายการชิ้นงานข้อความสําหรับคําอธิบาย เมื่อโฆษณาแสดง ระบบจะเลือกคําอธิบายจากรายการนี้ |
images[] |
รายการชิ้นงานรูปภาพที่อาจแสดงพร้อมกับโฆษณา |
youtubeVideos[] |
รายการชิ้นงานวิดีโอ YouTube ที่อาจแสดงพร้อมกับโฆษณา |
html5MediaBundles[] |
รายการชิ้นงานกลุ่มสื่อที่อาจใช้กับโฆษณา |
appDeepLink |
ชิ้นงาน Deep Link ของแอปที่อาจใช้กับโฆษณา |
AdMediaBundleAsset
ชิ้นงานไฟล์ครีเอทีฟโฆษณาที่ใช้ภายในโฆษณา
การแสดง JSON |
---|
{ "asset": string } |
ช่อง | |
---|---|
asset |
ชื่อทรัพยากรชิ้นงานของไฟล์ครีเอทีฟโฆษณานี้ |
AdAppDeepLinkAsset
Deep Link ของแอปที่ใช้ภายในโฆษณา
การแสดง JSON |
---|
{ "asset": string } |
ช่อง | |
---|---|
asset |
ชื่อทรัพยากรของชิ้นงานของ Deep Link ของแอปนี้ |
LegacyAppInstallAdInfo
โฆษณาเพื่อการติดตั้งแอปเดิมที่ลูกค้าบางรายเท่านั้นที่ใช้ได้
การแสดง JSON |
---|
{
"appStore": enum ( |
ช่อง | |
---|---|
appStore |
App Store ที่แอปบนอุปกรณ์เคลื่อนที่พร้อมให้บริการ |
appId |
รหัสของแอปบนอุปกรณ์เคลื่อนที่ |
headline |
บรรทัดแรกของโฆษณา |
description1 |
บรรทัดคําอธิบายแรกของโฆษณา |
description2 |
บรรทัดรายละเอียดที่ 2 ของโฆษณา |
LegacyAppInstallAdAppStore
ประเภท App Store ในโฆษณาเพื่อการติดตั้งแอปรุ่นเดิม
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ใช้สำหรับค่าที่แสดงผลเท่านั้น แสดงค่าที่ไม่รู้จักในเวอร์ชันนี้ |
APPLE_APP_STORE |
Apple iTunes |
GOOGLE_PLAY |
Google Play |
WINDOWS_STORE |
Windows Store |
WINDOWS_PHONE_STORE |
Windows Phone Store |
CN_APP_STORE |
แอปโฮสต์อยู่ใน App Store ของจีน |
ResponsiveDisplayAdInfo
โฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
การแสดง JSON |
---|
{ "marketingImages": [ { object ( |
ช่อง | |
---|---|
marketingImages[] |
รูปภาพการตลาดที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 600x314 และสัดส่วนภาพต้องเป็น 1.91:1 (+-1%) ต้องมี |
squareMarketingImages[] |
รูปภาพการตลาดสี่เหลี่ยมจัตุรัสที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 300x300 และสัดส่วนภาพต้องเป็น 1:1 (+-1%) ต้องมีสี่เหลี่ยมจัตุรัส |
logoImages[] |
รูปภาพโลโก้ที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 512x128 และสัดส่วนภาพต้องเป็น 4:1 (+-1%) เมื่อรวมกับ |
squareLogoImages[] |
รูปภาพโลโก้สี่เหลี่ยมจัตุรัสที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 128x128 และสัดส่วนภาพต้องเท่ากับ 1:1 (+-1%) เมื่อรวมกับ |
headlines[] |
บรรทัดแรกรูปแบบสั้นสำหรับโฆษณา ความยาวสูงสุด 30 อักขระ ระบุบรรทัดแรกได้อย่างน้อย 1 รายการและสูงสุด 5 รายการ |
longHeadline |
บรรทัดแรกแบบยาวที่ต้องระบุ ความยาวสูงสุดคือ 90 อักขระ |
descriptions[] |
ข้อความอธิบายสำหรับโฆษณา ความยาวสูงสุดคือ 90 อักขระ ระบุบรรทัดแรกได้อย่างน้อย 1 รายการและสูงสุด 5 รายการ |
youtubeVideos[] |
วิดีโอ YouTube ที่ไม่บังคับสําหรับโฆษณา ระบุวิดีโอได้สูงสุด 5 รายการ |
formatSetting |
ระบุรูปแบบที่โฆษณาจะแสดง ค่าเริ่มต้นคือ ALL_FORMATS |
controlSpec |
ข้อกําหนดสําหรับการควบคุมครีเอทีฟโฆษณาต่างๆ |
businessName |
ชื่อผู้ลงโฆษณา/แบรนด์ ความกว้างสูงสุดของการแสดงผลคือ 25 |
mainColor |
สีหลักของโฆษณาในรูปแบบเลขฐาน 16 เช่น #ffffff สำหรับสีขาว หากตั้งค่า |
accentColor |
สีเฉพาะจุดของโฆษณาในรูปแบบเลขฐานสิบหก เช่น #ffffff สำหรับสีขาว หากตั้งค่า |
allowFlexibleColor |
ความยินยอมของผู้ลงโฆษณาในการอนุญาตให้ใช้สีที่ปรับเปลี่ยนได้ เมื่อเป็น "จริง" โฆษณาอาจแสดงด้วยสีอื่นหากจําเป็น เมื่อเป็นเท็จ โฆษณาจะแสดงด้วยสีที่ระบุหรือสีกลาง ค่าเริ่มต้นคือ |
callToActionText |
ข้อความกระตุ้นให้ดำเนินการ (Call-To-Action) สําหรับโฆษณา ความกว้างสูงสุดของการแสดงผลคือ 30 |
pricePrefix |
คำนำหน้าก่อนราคา เช่น "ถูกสุดที่" |
promoText |
ข้อความโปรโมชันที่ใช้กับรูปแบบโฆษณาที่ปรับเปลี่ยนตามพื้นที่โฆษณาแบบไดนามิก เช่น "จัดส่งฟรีภายใน 2 วัน" |
ResponsiveDisplayAdControlSpec
ข้อกําหนดสําหรับการควบคุมครีเอทีฟโฆษณาต่างๆ สําหรับโฆษณา Display ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
การแสดง JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
ช่อง | |
---|---|
enableAssetEnhancements |
ระบุว่าผู้ลงโฆษณาเลือกใช้ฟีเจอร์การเพิ่มประสิทธิภาพชิ้นงานหรือไม่ |
enableAutogenVideo |
ข้อมูลว่าผู้ลงโฆษณาเลือกใช้ฟีเจอร์สร้างวิดีโออัตโนมัติหรือไม่ |
LocalAdInfo
โฆษณาในพื้นที่
การแสดง JSON |
---|
{ "headlines": [ { object ( |
ช่อง | |
---|---|
headlines[] |
รายการชิ้นงานข้อความสำหรับบรรทัดแรก เมื่อโฆษณาแสดง ระบบจะเลือกบรรทัดแรกจากรายการนี้ ต้องระบุบรรทัดแรกอย่างน้อย 1 รายการ แต่ไม่เกิน 5 รายการ |
descriptions[] |
รายการชิ้นงานข้อความสําหรับคําอธิบาย เมื่อโฆษณาแสดง ระบบจะเลือกคําอธิบายจากรายการนี้ ต้องระบุคำอธิบายอย่างน้อย 1 รายการ แต่ไม่เกิน 5 รายการ |
callToActions[] |
รายการชิ้นงานข้อความสําหรับคำกระตุ้นให้ดำเนินการ เมื่อโฆษณาแสดง ระบบจะเลือกคำกระตุ้นให้ดำเนินการ (Call-To-Action) จากรายการนี้ ต้องระบุคำกระตุ้นให้ดำเนินการอย่างน้อย 1 รายการ แต่ไม่เกิน 5 รายการ |
marketingImages[] |
รายการชิ้นงานรูปภาพการตลาดที่อาจแสดงพร้อมกับโฆษณา รูปภาพต้องมีขนาด 314x600 พิกเซลหรือ 320x320 พิกเซล คุณต้องระบุชิ้นงานรูปภาพอย่างน้อย 1 รายการ แต่ไม่เกิน 20 รายการ |
logoImages[] |
รายการชิ้นงานรูปภาพโลโก้ที่อาจแสดงพร้อมกับโฆษณา รูปภาพต้องมีขนาด 128x128 พิกเซลและไม่เกิน 120 KB ต้องระบุชิ้นงานรูปภาพอย่างน้อย 1 รายการ แต่ไม่เกิน 5 รายการ |
videos[] |
รายการชิ้นงานวิดีโอ YouTube ที่อาจแสดงพร้อมกับโฆษณา ต้องระบุเนื้อหาวิดีโออย่างน้อย 1 รายการ แต่ไม่เกิน 20 รายการ |
path1 |
ส่วนแรกของข้อความที่ไม่บังคับซึ่งสามารถต่อท้าย URL ในโฆษณาได้ |
path2 |
ส่วนที่ 2 ของข้อความที่ไม่บังคับซึ่งสามารถต่อท้าย URL ในโฆษณาได้ ฟิลด์นี้จะตั้งค่าได้ก็ต่อเมื่อตั้งค่า |
DisplayUploadAdInfo
โฆษณา Display ประเภททั่วไป รูปแบบโฆษณาที่แน่นอนจะควบคุมโดยช่อง displayUploadProductType
ซึ่งจะกําหนดประเภทข้อมูลที่จําเป็นต้องรวมไว้ในโฆษณา
การแสดง JSON |
---|
{ "displayUploadProductType": enum ( |
ช่อง | |
---|---|
displayUploadProductType |
ประเภทผลิตภัณฑ์ของโฆษณานี้ ดูรายละเอียดได้ในความคิดเห็นเกี่ยวกับ enum |
ฟิลด์สหภาพ media_asset ข้อมูลชิ้นงานที่ประกอบขึ้นเป็นโฆษณา media_asset ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
mediaBundle |
ชิ้นงานไฟล์ครีเอทีฟโฆษณาที่จะใช้ในโฆษณา ดูข้อมูลเกี่ยวกับกลุ่มสื่อสําหรับ HTML5_UPLOAD_AD ได้ที่ https://support.google.com/google-ads/answer/1722096 กลุ่มสื่อที่เป็นส่วนหนึ่งของประเภทผลิตภัณฑ์แบบไดนามิกจะใช้รูปแบบพิเศษที่ต้องสร้างผ่าน Google Web Designer ดูข้อมูลเพิ่มเติมได้ที่ https://support.google.com/webdesigner/answer/7543898 |
DisplayUploadProductType
แสดงรายการประเภทผลิตภัณฑ์ที่อัปโหลดใน Display
Enum | |
---|---|
UNSPECIFIED |
ไม่ได้ระบุ |
UNKNOWN |
ค่านี้ไม่รู้จักในเวอร์ชันนี้ |
HTML5_UPLOAD_AD |
โฆษณาที่อัปโหลดแบบ HTML5 ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo |
DYNAMIC_HTML5_EDUCATION_AD |
โฆษณา HTML5 แบบไดนามิกเกี่ยวกับการศึกษา ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้ในแคมเปญด้านการศึกษาเท่านั้น |
DYNAMIC_HTML5_FLIGHT_AD |
โฆษณาเที่ยวบิน HTML5 แบบไดนามิก ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญเที่ยวบิน |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
โฆษณา HTML5 แบบไดนามิกเกี่ยวกับโรงแรมและที่พักให้เช่า ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญโรงแรมเท่านั้น |
DYNAMIC_HTML5_JOB_AD |
โฆษณางาน HTML5 แบบไดนามิก ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญงาน |
DYNAMIC_HTML5_LOCAL_AD |
โฆษณา HTML5 ในพื้นที่แบบไดนามิก ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้ในแคมเปญในพื้นที่เท่านั้น |
DYNAMIC_HTML5_REAL_ESTATE_AD |
โฆษณาอสังหาริมทรัพย์ HTML5 แบบไดนามิก ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญอสังหาริมทรัพย์ |
DYNAMIC_HTML5_CUSTOM_AD |
โฆษณา HTML5 ที่กำหนดเองแบบไดนามิก ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญที่กำหนดเอง |
DYNAMIC_HTML5_TRAVEL_AD |
โฆษณา HTML5 แบบไดนามิกเกี่ยวกับการเดินทาง ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญการเดินทาง |
DYNAMIC_HTML5_HOTEL_AD |
โฆษณาโรงแรม HTML5 แบบไดนามิก ประเภทผลิตภัณฑ์นี้กำหนดให้ต้องตั้งค่าฟิลด์ upload_media_bundle ใน DisplayUploadAdInfo ใช้ได้เฉพาะในแคมเปญโรงแรมเท่านั้น |
AppEngagementAdInfo
โฆษณาเพื่อการมีส่วนร่วมในแอปช่วยให้คุณเขียนข้อความกระตุ้นการกระทำในแอปได้ เช่น เช็คอิน ซื้อสินค้า หรือจองเที่ยวบิน เป็นต้น ซึ่งช่วยให้คุณส่งผู้ใช้ไปยังส่วนที่ต้องการในแอปเพื่อให้ผู้ใช้พบสิ่งที่ต้องการได้ง่ายและรวดเร็วขึ้น
การแสดง JSON |
---|
{ "headlines": [ { object ( |
ช่อง | |
---|---|
headlines[] |
รายการชิ้นงานข้อความสำหรับบรรทัดแรก เมื่อโฆษณาแสดง ระบบจะเลือกบรรทัดแรกจากรายการนี้ |
descriptions[] |
รายการชิ้นงานข้อความสําหรับคําอธิบาย เมื่อโฆษณาแสดง ระบบจะเลือกคําอธิบายจากรายการนี้ |
images[] |
รายการชิ้นงานรูปภาพที่อาจแสดงพร้อมกับโฆษณา |
videos[] |
รายการชิ้นงานวิดีโอที่อาจแสดงพร้อมกับโฆษณา |
ShoppingComparisonListingAdInfo
โฆษณาเปรียบเทียบสินค้าใน Shopping
การแสดง JSON |
---|
{ "headline": string } |
ช่อง | |
---|---|
headline |
บรรทัดแรกของโฆษณา ต้องระบุข้อมูลในช่องนี้ ความยาวที่อนุญาตคือ 25-45 อักขระ |
AppPreRegistrationAdInfo
โฆษณาการลงทะเบียนใช้แอปล่วงหน้าจะลิงก์กับข้อมูลแอปหรือเกมของคุณใน Google Play และแสดงใน Google Play, YouTube (ในสตรีมเท่านั้น) และภายในเว็บไซต์ในอุปกรณ์เคลื่อนที่และแอปอื่นๆ ในเครือข่าย Display ได้ ซึ่งจะช่วยดึงดูดให้ผู้ใช้สนใจแอปหรือเกม และสร้างฐานผู้ใช้งานที่จะติดตั้งแอปหรือเกมของคุณล่วงหน้าก่อนเปิดตัวจริง
การแสดง JSON |
---|
{ "headlines": [ { object ( |
ช่อง | |
---|---|
headlines[] |
รายการชิ้นงานข้อความสำหรับบรรทัดแรก เมื่อโฆษณาแสดง ระบบจะเลือกบรรทัดแรกจากรายการนี้ |
descriptions[] |
รายการชิ้นงานข้อความสําหรับคําอธิบาย เมื่อโฆษณาแสดง ระบบจะเลือกคําอธิบายจากรายการนี้ |
images[] |
รายการรหัสชิ้นงานรูปภาพที่รูปภาพอาจแสดงพร้อมกับโฆษณา |
youtubeVideos[] |
รายการรหัสเนื้อหาวิดีโอ YouTube ของวิดีโอที่อาจแสดงพร้อมกับโฆษณา |
DemandGenMultiAssetAdInfo
โฆษณา Demand Gen แบบหลายชิ้นงาน
การแสดง JSON |
---|
{ "marketingImages": [ { object ( |
ช่อง | |
---|---|
marketingImages[] |
ชิ้นงานรูปภาพการตลาดที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 600x314 และสัดส่วนภาพต้องเป็น 1.91:1 (+-1%) ต้องระบุหากไม่มี squareMarketingImages รวมกับ |
squareMarketingImages[] |
ชิ้นงานรูปภาพการตลาดสี่เหลี่ยมจัตุรัสที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 300x300 และสัดส่วนภาพต้องเป็น 1:1 (+-1%) ต้องระบุหากไม่มี marketingImages รวมกับ |
portraitMarketingImages[] |
ชิ้นงานรูปภาพการตลาดแนวตั้งที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 480x600 และสัดส่วนภาพต้องเป็น 4:5 (+-1%) รวมกับ |
tallPortraitMarketingImages[] |
ชิ้นงานรูปภาพการตลาดแนวตั้งแบบสูงที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 600x1067 และสัดส่วนภาพต้องเป็น 9:16 (+-1%) รวมกับ |
logoImages[] |
ชิ้นงานรูปภาพโลโก้ที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 128x128 และสัดส่วนภาพต้องเท่ากับ 1:1 (+-1%) ระบุรูปภาพโลโก้ได้อย่างน้อย 1 รูปและสูงสุด 5 รูป |
headlines[] |
ชิ้นงานข้อความบรรทัดแรกของโฆษณา ความกว้างสูงสุดของการแสดงผลคือ 30 ระบุบรรทัดแรกได้อย่างน้อย 1 รายการและสูงสุด 5 รายการ |
descriptions[] |
ข้อความที่สื่อความหมายของโฆษณา ความกว้างสูงสุดของการแสดงผลคือ 90 ระบุคำอธิบายได้อย่างน้อย 1 รายการแต่ไม่เกิน 5 รายการ |
businessName |
ชื่อผู้ลงโฆษณา/แบรนด์ ความกว้างสูงสุดของการแสดงผลคือ 25 ต้องระบุ |
callToActionText |
ข้อความกระตุ้นให้ดำเนินการ |
leadFormOnly |
ตัวเลือกบูลีนที่ระบุว่าโฆษณานี้ต้องแสดงพร้อมกับโฆษณาแบบกรอกฟอร์มหรือไม่ |
DemandGenCarouselAdInfo
โฆษณาแบบภาพสไลด์ Demand Gen
การแสดง JSON |
---|
{ "businessName": string, "logoImage": { object ( |
ช่อง | |
---|---|
businessName |
ต้องระบุ ชื่อผู้ลงโฆษณา/แบรนด์ |
logoImage |
ต้องระบุ รูปภาพโลโก้ที่จะใช้ในโฆษณา ขนาดขั้นต่ำคือ 128x128 และสัดส่วนภาพต้องเท่ากับ 1:1 (+-1%) |
headline |
ต้องระบุ บรรทัดแรกของโฆษณา |
description |
ต้องระบุ ข้อความที่สื่อความหมายของโฆษณา |
callToActionText |
ข้อความกระตุ้นให้ดำเนินการ |
carouselCards[] |
ต้องระบุ การ์ดภาพสไลด์ที่จะแสดงพร้อมกับโฆษณา ขั้นต่ำ 2 รายการ สูงสุด 10 รายการ |
AdDemandGenCarouselCardAsset
ชิ้นงานการ์ดภาพสไลด์ Demand Gen ที่ใช้ในโฆษณา
การแสดง JSON |
---|
{ "asset": string } |
ช่อง | |
---|---|
asset |
ชื่อทรัพยากรชิ้นงานของการ์ด Discovery แบบภาพสไลด์นี้ |
DemandGenVideoResponsiveAdInfo
โฆษณาวิดีโอ Demand Gen ที่ปรับเปลี่ยนตามพื้นที่โฆษณา
การแสดง JSON |
---|
{ "headlines": [ { object ( |
ช่อง | |
---|---|
headlines[] |
รายการชิ้นงานข้อความที่ใช้สำหรับบรรทัดแรกแบบสั้น |
longHeadlines[] |
รายการชิ้นงานข้อความที่ใช้สำหรับบรรทัดแรกแบบยาว |
descriptions[] |
รายการชิ้นงานข้อความที่ใช้สำหรับคำอธิบาย |
videos[] |
รายการชิ้นงานวิดีโอ YouTube ที่ใช้สําหรับโฆษณา |
logoImages[] |
รูปภาพโลโก้ที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 128x128 และสัดส่วนภาพต้องเท่ากับ 1:1 (+-1%) |
breadcrumb1 |
ส่วนแรกของข้อความที่ปรากฏในโฆษณาพร้อมกับ URL ที่แสดง |
breadcrumb2 |
ข้อความส่วนที่ 2 ที่ปรากฏในโฆษณาพร้อมกับ URL ที่แสดง |
businessName |
ต้องระบุ ชื่อผู้ลงโฆษณา/แบรนด์ |
callToActions[] |
ชิ้นงานประเภท CallToActionAsset ที่ใช้สำหรับปุ่ม "คำกระตุ้นให้ดำเนินการ" |
AdCallToActionAsset
ชิ้นงานคำกระตุ้นให้ดำเนินการ (Call-To-Action) ที่ใช้ในโฆษณา
การแสดง JSON |
---|
{ "asset": string } |
ช่อง | |
---|---|
asset |
ชื่อทรัพยากรชิ้นงานของชิ้นงานคำกระตุ้นให้ดำเนินการนี้ |
DemandGenProductAdInfo
โฆษณาผลิตภัณฑ์ Demand Gen
การแสดง JSON |
---|
{ "breadcrumb1": string, "breadcrumb2": string, "businessName": { object ( |
ช่อง | |
---|---|
breadcrumb1 |
ส่วนแรกของข้อความที่ปรากฏในโฆษณาพร้อมกับ URL ที่แสดง |
breadcrumb2 |
ข้อความส่วนที่ 2 ที่ปรากฏในโฆษณาพร้อมกับ URL ที่แสดง |
businessName |
ต้องระบุ ชื่อผู้ลงโฆษณา/แบรนด์ |
headline |
ต้องระบุ ชิ้นงานข้อความที่ใช้สำหรับบรรทัดแรกแบบสั้น |
description |
ต้องระบุ ชิ้นงานข้อความที่ใช้สำหรับคำอธิบาย |
logoImage |
ต้องระบุ รูปภาพโลโก้ที่จะใช้ในโฆษณา ประเภทรูปภาพที่ถูกต้องคือ GIF, JPEG และ PNG ขนาดขั้นต่ำคือ 128x128 และสัดส่วนภาพต้องเท่ากับ 1:1 (+-1%) |
callToAction |
ชิ้นงานประเภท CallToActionAsset ที่ใช้สำหรับปุ่ม "คำกระตุ้นให้ดำเนินการ" |
TravelAdInfo
ประเภทนี้ไม่มีช่อง
โฆษณาการท่องเที่ยว