สร้างโฆษณา Demand Gen

โฆษณา 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']);