إنشاء إعلان لزيادة الطلب

الإصدار التجريبي: يتوفّر حاليًا إصدار تجريبي من ميزة استرداد موارد "حملات زيادة الطلب" وإدارتها. سنبدأ بطرح هذه الميزة لجميع الشركاء في 10 يونيو 2026، وستكون متاحة لجميع الشركاء في 24 يونيو 2026.

تنشئ "إعلانات زيادة الطلب" المواد الإبداعية التي يتم عرضها للمستخدم عندما يتم الفوز بمزاد الإعلان. تضبط موارد AdGroupAd خيارات المواد الإبداعية ذات الصلة ضمن حقل الاتحاد ad_details.

ضبط تفاصيل الإعلان

هناك أربعة أنواع من "إعلانات زيادة الطلب". يمكن أن يكون كل مرجع AdGroupAd من نوع واحد فقط. يتم ضبط كل نوع في حقل فردي ضمن حقل الاتحاد ad_details:

• demandGenVideoAd
• demandGenImageAd
• demandGenCarouselAd
• demandGenProductAd

يتوفّر رابط يؤدي إلى متطلبات نوع الإعلان ذي الصلة في وصف كل حقل. يمكن تعبئة حقل واحد فقط من هذه الحقول عند إنشاء مرجع AdGroupAd.

متطلبات أبعاد الصورة ودرجة دقتها حسب النوع

يتطلّب كل نوع من أنواع الإعلانات أحجامًا مختلفة من مواد عرض الصور.

يسرد الجدول التالي أنواع الصور وقيود الملفات ذات الصلة:

نوع الصورة
إعلان بانر مصاحب	الحد الأقصى لحجم الملف: 150 كيلوبايت الأبعاد: 300×60
صورة أفقية	الحدّ الأقصى لحجم الملف: 5120 كيلوبايت الأبعاد المقترَحة: 1200x628، الحد الأدنى: 600x314
صورة الشعار	الحدّ الأقصى لحجم الملف: 5120 كيلوبايت الأبعاد المُقترَحة: 1200x1200، الحدّ الأدنى: 128x128
الصورة العمودية	الحدّ الأقصى لحجم الملف: 5120 كيلوبايت الأبعاد المُقترَحة: 960x1200، الحد الأدنى: 480x600
الصورة المربّعة	الحدّ الأقصى لحجم الملف: 5120 كيلوبايت الأبعاد المقترَحة: 1200x1200، الحد الأدنى: 300x300

إنشاء إعلان

إليك كيفية إنشاء إعلان فيديو لزيادة الطلب:

ملاحظة: في هذا المثال، يمكنك إنشاء مرجع إعلان بالحالة "متوقّف مؤقّتًا". يتم ذلك كإجراء احترازي لضمان عدم بدء عرض الإعلان على الفور قبل مراجعته.

جافا

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