إنشاء مجموعة إعلانية في "حملة زيادة الطلب"

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

توفّر المجموعة الإعلانية في "الحملات لزيادة الطلب" تحكّمًا دقيقًا في عروض الأسعار وعرض الإعلانات ضمنها. يتم ضبط ذلك في موارد AdGroup من خلال استراتيجية عروض الأسعار وإعدادات المستودع والاستهداف.

تتضمّن المجموعات الإعلانية موارد ثانوية تُعرف باسم الإعلانات، وهي التصاميم الإعلانية التي يتم عرضها بعد الفوز بمزاد.

اختيار الإعدادات

قبل إنشاء مجموعة إعلانية في "الحملات لزيادة الطلب"، ننصحك بمراعاة هذه الإعدادات الاختيارية لتفعيل المزيد من التحكّم في عرض الإعلانات:

• bidStrategy يمكن ضبطه باستخدام DemandGenBiddingStrategy لتعيين قيمة مستهدَفة مختلفة للمجموعة الإعلانية مقارنةً بسطر العرض الرئيسي عند استخدام استراتيجية عروض أسعار "التكلفة المستهدَفة للإجراء" أو "التكلفة المستهدَفة للنقرة" أو "عائد الإنفاق الإعلاني المستهدَف".
• adGroupInventoryControl يمكن ضبطه لاختيار المستودعات التي ستعرض المجموعة الإعلانية عروض أسعار عليها وسيتم عرض الإعلانات فيها.
• targetingExpansion تتيح لك تفعيل الاستهداف المحسّن للمجموعة الإعلانية التي تستخدِم استهداف الجمهور. يوسّع الاستهداف المحسّن نطاق عرض الإعلانات خارج نطاق استهداف الفئة الديمغرافية الذي ضبطته. يمكنك حصر ذلك من خلال استبعاد توسيع نطاق الفئات الديمغرافية.

عند إنشاء مجموعة إعلانية في "الحملات لزيادة الطلب"، يجب أيضًا ضبط الحقل adGroupFormat على AD_GROUP_FORMAT_DEMAND_GEN.

إنشاء مجموعة إعلانية

إليك كيفية إنشاء مجموعة إعلانية في "الحملات لزيادة الطلب" باستخدام الإعدادات التالية:

• استراتيجية عروض أسعار يتم تحسينها لتحقيق متوسّط تكلفة يبلغ 12 دولارًا أمريكيًا لكل إحالة ناجحة، مع وراثة استراتيجية عروض أسعار "التكلفة المستهدَفة للإجراء" من سطر العرض الرئيسي.
• لن يتم عرض عروض أسعار إلا على مستودع الإعلانات أثناء عرض الفيديو وفيديوهات Shorts على YouTube.

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

جافا

// Provide the ID of the parent advertiser.
long advertiserId = advertiser-id;

// Provide the ID of the parent line item.
long lineItemId = line-item-id;

// Provide the display name of the ad group.
String displayName = display-name;

// Create the ad group structure.
AdGroup adGroup =
    new AdGroup()
        .setLineItemId(lineItemId)
        .setDisplayName(displayName)
        .setAdGroupFormat("AD_GROUP_FORMAT_DEMAND_GEN")
        .setEntityStatus("ENTITY_STATUS_PAUSED");

// Create and set the bidding strategy.
BiddingStrategy biddingStrategy =
    new BiddingStrategy()
        .setDemandGenBid(new DemandGenBiddingStrategy().setValue(12000000L));
adGroup.setBidStrategy(biddingStrategy);

// Create and set inventory controls.
AdGroupInventoryControl inventoryControl = new AdGroupInventoryControl();
SelectedInventories selectedInventories =
    new SelectedInventories()
        .setAllowYoutubeStream(true)
        .setAllowYoutubeShorts(true);
inventoryControl.setSelectedInventories(selectedInventories);
adGroup.setAdGroupInventoryControl(inventoryControl);

// Configure the create request.
AdGroups.Create request =
    service.advertisers().adGroups().create(advertiserId, adGroup);

// Create the ad group.
AdGroup response = request.execute();

// Display the new ad group.
System.out.printf("Demand Gen ad group %s was created.", response.getName());

Python

# Provide the ID of the parent advertiser.
advertiser_id = advertiser-id

# Provide the ID of the parent line item.
line_item_id = line-item-id

# Provide the display name of the ad group.
display_name = display-name

# Create an ad group object with example values.
ad_group_obj = {
    "lineItemId": line_item_id,
    "displayName": display_name,
    "entityStatus": "ENTITY_STATUS_PAUSED",
    "adGroupFormat": "AD_GROUP_FORMAT_DEMAND_GEN",
    "bidStrategy": {
        "demandGenBid": {
            "value": "12000000"
        }
    },
    "adGroupInventoryControl": {
        "selectedInventories": {
            "allowYoutubeStream": True,
            "allowYoutubeShorts": True,
        }
    }
}

# Build and execute request.
response = (
    service.advertisers()
    .adGroups()
    .create(advertiserId=advertiser_id, body=ad_group_obj)
    .execute()
)

# Display the new ad group.
print(f"Demand Gen ad group {response['name']} was created.")

PHP

// Provide the ID of the parent advertiser.
$advertiserId = advertiser-id;

// Provide the ID of the parent line item.
$lineItemId = line-item-id;

// Provide the display name of the ad group.
$displayName = display-name;

// Create the Demand Gen ad group structure.
$adGroup = new Google_Service_DisplayVideo_AdGroup();
$adGroup->setLineItemId($lineItemId);
$adGroup->setDisplayName($displayName);
$adGroup->setAdGroupFormat('AD_GROUP_FORMAT_DEMAND_GEN');
$adGroup->setEntityStatus('ENTITY_STATUS_PAUSED');

// Create and set the bidding strategy.
$demandGenBidStrategy =
    new Google_Service_DisplayVideo_DemandGenBiddingStrategy();
$demandGenBidStrategy->setValue(12000000);
$biddingStrategy = new Google_Service_DisplayVideo_BiddingStrategy();
$biddingStrategy->setDemandGenBid($demandGenBidStrategy);
$adGroup->setBidStrategy($biddingStrategy);

// Create and set the inventory control.
$selectedInventories =
    new Google_Service_DisplayVideo_SelectedInventories();
$selectedInventories->setAllowYoutubeStream(true);
$selectedInventories->setAllowYoutubeShorts(true);
$inventoryControl =
    new Google_Service_DisplayVideo_AdGroupInventoryControl();
$inventoryControl->setSelectedInventories($selectedInventories);
$adGroup->setAdGroupInventoryControl($inventoryControl);

// Call the API, creating the ad group under the advertiser and
// line item given.
try {
    $result = $this->service->advertisers_adGroups->create(
        $advertiserId,
        $adGroup
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Display the new ad group.
printf('<p>Demand Gen Ad Group %s was created.</p>', $result['name']);