יצירת מודעה ליצירת ביקוש

בטא: שליפה וניהול של נכסים בקמפיינים ליצירת ביקוש נמצאים בגרסת בטא. ההשקה של התכונה הזו לכל השותפים תתחיל ב-10 ביוני 2026, והיא תהיה זמינה לכל השותפים ב-24 ביוני 2026.

מודעה ליצירת ביקוש יוצרת את הקריאייטיב שמוצג למשתמש כשזוכים במכרז של מודעות. משאבי AdGroupAd מגדירים את אפשרויות הקריאייטיב הרלוונטיות בשדה האיחוד ad_details.

הגדרת פרטי המודעה

יש ארבעה סוגים של מודעות ליצירת ביקוש. כל משאב AdGroupAd יכול להיות רק מסוג אחד. כל סוג מוגדר בשדה נפרד בשדה האיחוד ad_details:

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

בתיאור של כל שדה מופיע קישור לדרישות הרלוונטיות לסוג המודעה. אפשר לאכלס רק אחד מהשדות האלה כשיוצרים משאב AdGroupAd.

דרישות לגבי מידות ורזולוציה של תמונות לפי סוג

לכל סוג מודעה נדרשים נכסי תמונה בגדלים שונים.

בטבלה הבאה מפורטים סוגי התמונות וההגבלות הרלוונטיות לגבי הקבצים:

סוג התמונה
Companion banner	גודל הקובץ המקסימלי: 150KB מידות: 300x60
תמונה לרוחב	גודל הקובץ המקסימלי: 5,120KB מידות מומלצות: ‎1200x628, מינימום: ‎600x314
תמונת לוגו	גודל הקובץ המקסימלי: 5,120KB מידות מומלצות: 1200x1200, מינימום: 128x128
תמונה לאורך	גודל הקובץ המקסימלי: 5,120KB מידות מומלצות: 960x1200, מינימום: 480x600
תמונה ריבועית	גודל הקובץ המקסימלי: 5,120KB מידות מומלצות: 1,200x1,200, מינימום: 300x300

יצירת מודעה

כך יוצרים מודעת וידאו ליצירת ביקוש:

הערה: בדוגמה הזו, יוצרים נכס מודעה במצב 'מושהה'. הפעולה הזו מתבצעת כאמצעי זהירות כדי לוודא שהמודעה לא תתחיל להופיע באופן מיידי לפני הבדיקה.

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']);