یک تبلیغ با قابلیت تولید تقاضا ایجاد کنید

یک تبلیغ Demand Gen، خلاقیتی را که پس از برنده شدن در مزایده تبلیغ به کاربر ارائه می‌شود، می‌سازد. منابع AdGroupAd گزینه‌های خلاقیت مربوطه را در زیر فیلد ad_details پیکربندی می‌کنند.

جزئیات تبلیغات را پیکربندی کنید

چهار نوع تبلیغات Demand Gen وجود دارد. هر منبع AdGroupAd فقط می‌تواند یک نوع باشد. هر نوع در فیلد جداگانه‌ای در زیر فیلد union ad_details پیکربندی می‌شود:

لینکی به الزامات مربوط به نوع تبلیغ در توضیحات هر فیلد موجود است. هنگام ایجاد یک منبع AdGroupAd ، فقط یکی از این فیلدها را می‌توان پر کرد.

الزامات ابعاد و وضوح تصویر بر اساس نوع

هر نوع تبلیغ به اندازه‌های مختلفی از تصاویر نیاز دارد.

جدول زیر انواع تصاویر و محدودیت‌های مربوط به فایل‌ها را فهرست می‌کند:

نوع تصویر
بنر همراه

حداکثر حجم فایل : ۱۵۰ کیلوبایت

ابعاد : ۳۰۰x۶۰

تصویر منظره

حداکثر حجم فایل : ۵۱۲۰ کیلوبایت

ابعاد پیشنهادی : ۱۲۰۰x۶۲۸، حداقل : ۶۰۰x۳۱۴

تصویر لوگو

حداکثر حجم فایل : ۵۱۲۰ کیلوبایت

ابعاد پیشنهادی : ۱۲۰۰x۱۲۰۰، حداقل : ۱۲۸x۱۲۸

تصویر پرتره

حداکثر حجم فایل : ۵۱۲۰ کیلوبایت

ابعاد پیشنهادی : ۹۶۰x۱۲۰۰، حداقل : ۴۸۰x۶۰۰

تصویر مربعی

حداکثر حجم فایل : ۵۱۲۰ کیلوبایت

ابعاد پیشنهادی : ۱۲۰۰x۱۲۰۰، حداقل : ۳۰۰x۳۰۰

ایجاد یک تبلیغ

در اینجا نحوه ایجاد یک تبلیغ ویدیویی Demand Gen آورده شده است:

جاوا

// 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());

پایتون

# 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.")

پی اچ پی

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