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

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

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

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

בחירת הגדרות

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

• אפשר להגדיר את bidStrategy עם DemandGenBiddingStrategy כדי להגדיר ערך יעד שונה לקבוצת המודעות בהשוואה לפריט המרכזי, כשמשתמשים בשיטת בידינג לפי יעד עלות להמרה, יעד עלות לקליק או בידינג לפי יעד החזר על הוצאות הפרסום.
• אפשר להגדיר את adGroupInventoryControl כך שיבחר את מלאי שטחי הפרסום שקבוצת המודעות תגיש עליהם הצעות מחיר ושבהם המודעות יוצגו.
• targetingExpansion מאפשרת להפעיל אופטימיזציית טירגוט לקבוצת המודעות שמוגדר בה טירגוט לפי קהל. אופטימיזציית טירגוט מרחיבה את הצגת המודעות מעבר לטירגוט הדמוגרפי שהגדרתם. אפשר להגביל את ההחרגה לפי קבוצה דמוגרפית.

כשיוצרים קבוצת מודעות ליצירת ביקוש, צריך גם להגדיר את השדה adGroupFormat לערך AD_GROUP_FORMAT_DEMAND_GEN.

יצירת קבוצת מודעות

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

• שיטת בידינג שמבצעת אופטימיזציה לעלות ממוצעת של 12 $להמרה, ומקבלת בירושה שיטת בידינג לפי יעד עלות להמרה מפריט ההזמנה הראשי שלה.
• המערכת תגיש הצעות מחיר רק על מלאי שטחי פרסום של מודעות וידאו In-stream ומודעות ב-Shorts ב-YouTube.

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

Java

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