โฆษณา Demand Gen จะสร้างครีเอทีฟโฆษณาที่แสดงต่อผู้ใช้เมื่อชนะการประมูลเพื่อแสดงโฆษณา
AdGroupAd จะกำหนดค่าตัวเลือกครีเอทีฟโฆษณาที่เกี่ยวข้องภายใต้
ฟิลด์สหภาพ ad_details
กำหนดค่ารายละเอียดโฆษณา
โฆษณา Demand Gen มี 4 ประเภท ทรัพยากร AdGroupAd แต่ละรายการจะเป็นได้เพียงประเภทเดียว โดยจะกำหนดค่าแต่ละประเภทในฟิลด์แต่ละรายการภายใต้ฟิลด์รวม ad_details ดังนี้
ลิงก์ไปยังข้อกำหนดของประเภทโฆษณาที่เกี่ยวข้องจะอยู่ในคำอธิบายของแต่ละฟิลด์
คุณจะป้อนข้อมูลในช่องเหล่านี้ได้เพียงช่องเดียวเมื่อสร้างทรัพยากร
AdGroupAd
ข้อกำหนดด้านขนาดและความละเอียดของรูปภาพตามประเภท
โฆษณาแต่ละประเภทต้องใช้ชิ้นงานรูปภาพขนาดต่างๆ
ตารางต่อไปนี้แสดงประเภทรูปภาพและข้อจำกัดของไฟล์ที่เกี่ยวข้อง
| ประเภทรูปภาพ | |
|---|---|
| แบนเนอร์ที่แสดงร่วมกัน |
ขนาดไฟล์สูงสุด: 150 KB ขนาด: 300x60 |
| รูปภาพแนวนอน |
ขนาดไฟล์สูงสุด: 5120 KB ขนาดที่แนะนำ: 1200x628, ขั้นต่ำ: 600x314 |
| รูปภาพโลโก้ |
ขนาดไฟล์สูงสุด: 5120 KB ขนาดที่แนะนำ: 1200x1200, ขั้นต่ำ: 128x128 |
| รูปภาพแนวตั้ง |
ขนาดไฟล์สูงสุด: 5120 KB ขนาดที่แนะนำ: 960x1200, ขั้นต่ำ: 480x600 |
| รูปภาพสี่เหลี่ยมจัตุรัส |
ขนาดไฟล์สูงสุด: 5120 KB ขนาดที่แนะนํา: 1200x1200, ขั้นต่ำ: 300x300 |
สร้างโฆษณา
วิธีสร้างโฆษณาวิดีโอ Demand Gen มีดังนี้
Java
// Provide the ID of the parent advertiser. long advertiserId = advertiser-id; // Provide the ID of the parent ad group. long adGroupId = ad-group-id; // Provide the display name of the ad. String displayName = display-name; // Provide the information for the ad creative. String finalAdUrl = final-ad-url; String callToAction = call-to-action; String headline = headline; String longHeadline = long-headline; String description = description; String businessName = business-name; long youtubeAssetId = youtube-video-asset-id; long logoAssetId = logo-asset-id; // Create the ad structure. AdGroupAd ad = new AdGroupAd() .setAdGroupId(adGroupId) .setDisplayName(displayName) .setEntityStatus("ENTITY_STATUS_PAUSED") .setDemandGenVideoAd( new DemandGenVideoAd() .setFinalUrl(finalAdUrl) .setCallToAction(callToAction) .setHeadlines(Arrays.asList(headline)) .setLongHeadlines(Arrays.asList(longHeadline)) .setDescriptions(Arrays.asList(description)) .setBusinessName(businessName) .setVideos( Arrays.asList( new YoutubeVideoDetails() .setVideoAssetId(youtubeAssetId))) .setLogo(new ImageAsset().setAssetId(logoAssetId))); // Configure the create request. AdGroupAds.Create request = service.advertisers().adGroupAds().create(advertiserId, ad); // Create the ad group. AdGroupAd response = request.execute(); // Display the new ad. System.out.printf("Demand Gen ad %s was created.", response.getName());
Python
# Provide the ID of the parent advertiser. advertiser_id = advertiser-id # Provide the ID of the parent ad group. ad_group_id = ad-group-id # Provide the display name of the ad. display_name = display-name # Provide the information for the ad creative. final_ad_url = final-ad-url call_to_action = call-to-action headline = headline long_headline = long-headline description = description business_name = business-name youtube_asset_id = youtube-video-asset-id logo_asset_id = logo-asset-id # Create the ad object. ad_obj = { "adGroupId": ad_group_id, "displayName": display_name, "entityStatus": "ENTITY_STATUS_PAUSED", "demandGenVideoAd": { "finalUrl": final_ad_url, "callToAction": call_to_action, "headlines": [headline], "longHeadlines": [long_headline], "descriptions": [description], "businessName": business_name, "videos": [{"videoAssetId": youtube_asset_id}], "logo": {"assetId": logo_asset_id} } } # Build and execute request. response = ( service.advertisers() .adGroupAds() .create(advertiserId=advertiser_id, body=ad_obj) .execute() ) # Display the new ad. print(f"Demand Gen ad {response['name']} was created.")
PHP
// Provide the ID of the parent advertiser. $advertiserId = advertiser-id; // Provide the ID of the parent ad group. $adGroupId = ad-group-id; // Provide the display name of the ad. $displayName = display-name; // Provide the information for the ad creative. $finalAdUrl = final-ad-url; $callToAction = call-to-action; $headline = headline; $longHeadline = long-headline; $description = description; $businessName = business-name; $youtubeAssetId = youtube-video-asset-id; $logoAssetId = logo-asset-id; // Create the ad structure. $ad = new Google_Service_DisplayVideo_AdGroupAd(); $ad->setAdGroupId($adGroupId); $ad->setDisplayName($displayName); $ad->setEntityStatus('ENTITY_STATUS_PAUSED'); // Create the Demand Gen video ad creative. $demandGenVideoAd = new Google_Service_DisplayVideo_DemandGenVideoAd(); $demandGenVideoAd->setFinalUrl($finalAdUrl); $demandGenVideoAd->setCallToAction($callToAction); $demandGenVideoAd->setHeadlines(array($headline)); $demandGenVideoAd->setLongHeadlines(array($longHeadline)); $demandGenVideoAd->setDescriptions(array($description)); $demandGenVideoAd->setBusinessName($businessName); // Assign the video asset to the ad creative. $youtubeVideoAsset = new Google_Service_DisplayVideo_YoutubeVideoDetails(); $youtubeVideoAsset->setVideoAssetId($youtubeAssetId); $demandGenVideoAd->setVideos(array($youtubeVideoAsset)); // Assign the logo asset to the ad creative. $imageAsset = new Google_Service_DisplayVideo_ImageAsset(); $imageAsset->setAssetId($logoAssetId); $demandGenVideoAd->setLogo($imageAsset); // Assign the Demand Gen video ad to the ad. $ad->setDemandGenVideoAd($demandGenVideoAd); // Call the API, creating the ad under the advertiser and ad group given. try { $result = $this->service->advertisers_adGroupAds->create( $advertiserId, $ad ); } catch (\Exception $e) { $this->renderError($e); return; } // Display the new ad. printf('<p>Ad %s was created.</p>', $result['name']);