वर्टिकल विज्ञापनों के लिए कंट्रोल और इन्वेंट्री फ़िल्टर करने की सुविधा

वर्टिकल विज्ञापन, एआई मैक्स की सुविधा वाले Search Network में दिखने वाले विज्ञापनों के लिए खास सुविधाएं देते हैं. ये विज्ञापन, होटल जैसे वर्टिकल फ़ीड से लिंक होते हैं. आपके पास यह कंट्रोल करने का विकल्प होता है कि विज्ञापन ग्रुप के लेवल पर, वर्टिकल विज्ञापन के किन फ़ॉर्मैट को दिखाया जाए. साथ ही, वर्टिकल विज्ञापन के आइटम ग्रुप के नियमों का इस्तेमाल करके, यह भी कंट्रोल किया जा सकता है कि किन फ़ीड एंटिटी को टारगेट किया जाए.

खास जानकारी

इस गाइड में, वर्टिकल विज्ञापनों को मैनेज करने से जुड़ी दो मुख्य सुविधाओं के बारे में बताया गया है:

1. फ़ॉर्मैट कंट्रोल: विज्ञापन ग्रुप के लेवल पर, विज्ञापन के खास फ़ॉर्मैट (टेक्स्ट विज्ञापन, बुकिंग लिंक, और वर्टिकल प्रमोशन वाले विज्ञापन) के लिए ऑप्ट-इन करें या ऑप्ट-आउट करें.
2. वर्टिकल विज्ञापन के आइटम मैनेज करना: SharedSet और SharedCriterion का इस्तेमाल करने वाले नियम-आधारित सिस्टम की मदद से, लिंक किए गए वर्टिकल (जिसे पहले यात्रा फ़ीड कहा जाता था) से इन्वेंट्री को फ़िल्टर करें और उसे टारगेट करें.

ज़रूरी शर्तें

इन सुविधाओं को लागू करने से पहले, पक्का करें कि आपका कैंपेन इन ज़रूरी शर्तों को पूरा करता हो:

• कैंपेन का टाइप: यह Search Network में दिखने वाला विज्ञापन कैंपेन होना चाहिए.
• वर्टिकल फ़ीड: ग्राहक या कैंपेन लेवल पर, चालू वर्टिकल डेटा फ़ीड लिंक होना चाहिए. कैंपेन लेवल पर फ़ीड को लिंक करने के लिए, कैंपेन लेवल पर वर्टिकल डेटा फ़ीड का रेफ़रंस लिंक करें . वर्टिकल डेटा फ़ीड को लिंक करने पर, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड (टीएफ़एसए) की सुविधा चालू हो जाती है. साथ ही, कैंपेन के लिए वर्टिकल विज्ञापन के कंट्रोल भी चालू हो जाते हैं.
• एआई मैक्स: कैंपेन में, एआई मैक्स की सेटिंग चालू होनी चाहिए.

ध्यान दें: अगर एआई मैक्स की सुविधा वाले कैंपेन या चालू वर्टिकल डेटा फ़ीड के बिना, फ़ॉर्मैट कंट्रोल की सेटिंग में बदलाव करने की कोशिश की जाती है, तो गड़बड़ियां दिखेंगी.VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED इसी तरह, अगर ऐसे कैंपेन में आइटम मैनेजमेंट में बदलाव करने की कोशिश की जाती है, तो VERTICAL_ADS_ITEM_GROUP_RULE_LIST_NOT_SUPPORTED गड़बड़ियां दिखेंगी.

कैंपेन लेवल पर वर्टिकल डेटा फ़ीड लिंक करना

Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड (टीएफ़एसए) की सुविधा चालू करने और अपने कैंपेन में वर्टिकल विज्ञापन के कंट्रोल चालू करने के लिए, कैंपेन लेवल पर वर्टिकल डेटा फ़ीड के ऐसेट सेट को लिंक किया जा सकता है. इसके लिए, यहां दिया गया तरीका अपनाएं. इसके अलावा, अपने खाते में मौजूद सभी कैंपेन के लिए इन सुविधाओं को चालू करने के लिए, ग्राहक लेवल पर फ़ीड को लिंक किया जा सकता है. इसके लिए, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड की गाइड में, ग्राहक लेवल पर लिंक करने के निर्देश देखें.

1. `CampaignAssetSet` ऑब्जेक्ट बनाएं. इसमें `asset_set` को अपने वर्टिकल फ़ीड के ऐसेट सेट के संसाधन के नाम पर और `campaign` को अपने कैंपेन के संसाधन के नाम पर सेट करें.
2. बनाएं. इसमें को पर सेट करें.CampaignAssetSetOperationcreateCampaignAssetSet
3. CampaignAssetSetService.MutateCampaignAssetSets का इस्तेमाल करके, ऑपरेशन सबमिट करें.

बड़े पैमाने पर यात्रा के फ़ीड मैनेज करने के बारे में ज़्यादा जानने के लिए, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड से जुड़ा दस्तावेज़ देखें.

विज्ञापन ग्रुप के फ़ॉर्मैट कंट्रोल

अब यह कॉन्फ़िगर किया जा सकता है कि किसी खास विज्ञापन ग्रुप के लिए, वर्टिकल विज्ञापन के किन फ़ॉर्मैट को चालू रखा जाए. इसे AdGroup संसाधन के vertical_ads_format_setting फ़ील्ड से मैनेज किया जाता है.

उपलब्ध फ़ॉर्मैट

• टेक्स्ट विज्ञापन: डिफ़ॉल्ट रूप से चालू होते हैं. इन्हें बंद किया जा सकता है.
• बुकिंग लिंक: इनके लिए ऑप्ट-इन करना ज़रूरी है.
• वर्टिकल प्रमोशन वाले विज्ञापन: इनके लिए ऑप्ट-इन करना ज़रूरी है.

सत्यापन नियम

• किसी एक विज्ञापन ग्रुप के लिए, तीनों फ़ॉर्मैट से एक साथ ऑप्ट-आउट नहीं किया जा सकता.
• ये सेटिंग सिर्फ़ STANDARD और SEARCH_DYNAMIC_ADS टाइप के विज्ञापन ग्रुप पर लागू होती हैं.

उदाहरण: फ़ॉर्मैट की सेटिंग अपडेट करना

यहां दिए गए उदाहरण में बताया गया है कि किसी मौजूदा विज्ञापन ग्रुप के लिए, टेक्स्ट विज्ञापन कैसे बंद किए जाएं और वर्टिकल प्रमोशन वाले विज्ञापन कैसे चालू किए जाएं.

Java

// Assuming 'adGroup' is an existing AdGroup object.
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName()) // Example: "customers/{id}/adGroups/{id}"
    .setVerticalAdsFormatSetting(
        VerticalAdsFormatSetting.newBuilder()
            .setDisableTextAds(true)
            .setEnableBookingLinks(false)
            .setEnableVerticalPromotionAds(true)
    )
    .build();

AdGroupOperation operation = AdGroupOperation.newBuilder()
    .setUpdate(adGroupToUpdate)
    .setUpdateMask(FieldMasks.allSetFieldsOf(adGroupToUpdate))
    .build();

// Submit the operation using AdGroupService...

वर्टिकल विज्ञापन के आइटम मैनेज करना

अपने फ़ीड की इन्वेंट्री के किसी खास सबसेट को टारगेट करने के लिए, जैसे कि "बोस्टन में मौजूद होटल" या "एक स्टार वाले होटल शामिल न करें", आपको वर्टिकल विज्ञापन के आइटम ग्रुप के नियमों का इस्तेमाल करना होगा.

डेटा मॉडल के काम करने का तरीका

डेटा मॉडल, शेयर किए गए मानदंड के तरीके का इस्तेमाल करता है:

1. SharedSet: VERTICAL_ADS_ITEM_GROUP_RULE_LIST टाइप वाला SharedSet बनाएं.
2. SharedCriterion: इस सेट में नियम (मानदंड) जोड़ें. हर नियम में, शहर या होटल की क्लास जैसे डाइमेंशन और एक वैल्यू तय की जाती है. आइटम शामिल न करने के लिए, नेगेटिव मानदंड भी बनाए जा सकते हैं.
3. AdGroupCriterion: AdGroupCriterion का इस्तेमाल करके, SharedSet को अपने AdGroup से लिंक करें.

समर्थित डाइमेंशन

SharedCriterion में, इन डाइमेंशन के आधार पर एंटिटी को फ़िल्टर किया जा सकता है:

• item_code: लिस्टिंग का खास आईडी.
• city_criterion_id, region_criterion_id, country_criterion_id: भौगोलिक टारगेटिंग के कॉन्स्टैंट.
• brand_text: ब्रैंड का नाम.
• hotel_class: स्टार रेटिंग (1 से 5).

कोड का उदाहरण: नियम बनाना और उन्हें लिंक करना

इस उदाहरण में, "बोस्टन" या "सैन फ़्रांसिस्को" में मौजूद आइटम शामिल करने और "एक स्टार" और "दो स्टार" वाले होटल शामिल न करने का नियम बनाया गया है.

Python

# 1. Create the SharedSet
shared_set_operation = client.get_type("SharedSetOperation")
shared_set = shared_set_operation.create
shared_set.name = "Boston/SF Premium Hotels"
shared_set.type_ = client.enums.SharedSetTypeEnum.VERTICAL_ADS_ITEM_GROUP_RULE_LIST
shared_set.vertical_ads_item_vertical_type = client.enums.VerticalAdsItemVerticalTypeEnum.HOTELS
# Submit SharedSetOperation...

# 2. Add Criteria (Rules) to the SharedSet
shared_criteria_operations = []

# Rule A: Include Boston and SF
included_city_ids = [1006543, 1014221] # Geo Target Constant IDs
for city_id in included_city_ids:
    op = client.get_type("SharedCriterionOperation")
    criterion = op.create
    criterion.shared_set = shared_set_resource_name
    criterion.vertical_ads_item_group_rule.city_criterion_id = city_id
    shared_criteria_operations.append(op)

# Rule B: Exclude 1 and 2 Star Hotels
excluded_stars = [1, 2]
for star_rating in excluded_stars:
    op = client.get_type("SharedCriterionOperation")
    criterion = op.create
    criterion.shared_set = shared_set_resource_name
    criterion.vertical_ads_item_group_rule.hotel_class = star_rating
    criterion.negative = True # Mark as exclusion
    shared_criteria_operations.append(op)

# Submit SharedCriterionOperations...

# 3. Link to AdGroup
agc_operation = client.get_type("AdGroupCriterionOperation")
agc = agc_operation.create
agc.ad_group = ad_group_resource_name
agc.status = client.enums.AdGroupCriterionStatusEnum.ENABLED
agc.vertical_ads_item_group_rule_list.shared_set = shared_set_resource_name

# Submit AdGroupCriterionOperation...

रिपोर्टिंग

GoogleAdsService.SearchStream या GoogleAdsService.Search तरीकों का इस्तेमाल करके, वर्टिकल विज्ञापनों की परफ़ॉर्मेंस मेट्रिक देखी जा सकती हैं. Google Ads API के v23 में, ज़्यादा जानकारी वाली रिपोर्टिंग के लिए खास सेगमेंट जोड़े गए हैं.

नए सेगमेंट

• segments.vertical_ads_listing_city: लिस्टिंग से जुड़ा शहर.
• segments.vertical_ads_vertical_type: वर्टिकल का टाइप, जैसे कि होटल या किराये पर दी जाने वाली कार.

GAQL क्वेरी का उदाहरण

SQL

SELECT
  segments.vertical_ads_listing_city,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.impressions
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

गड़बड़ी ठीक करना

वर्टिकल विज्ञापन कॉन्फ़िगर करते समय, ये आम गड़बड़ियां दिख सकती हैं.

गड़बड़ी का कोड	वजह	सुझाई गई कार्रवाई
INVALID_VERTICAL_ADS_FORMAT_SETTING	विज्ञापन के तीनों फ़ॉर्मैट (टेक्स्ट, बुकिंग लिंक, प्रमोशन वाले विज्ञापन) एक साथ बंद कर दिए गए.	पक्का करें कि VerticalAdsFormatSetting में कम से कम एक फ़ॉर्मैट चालू हो (ट्रू पर सेट हो).
VERTICAL_ADS_FORMAT_SETTING_NOT_SUPPORTED_...	कैंपेन में, एआई मैक्स की सुविधा चालू नहीं है या उसमें चालू वर्टिकल फ़ीड नहीं है.	कैंपेन की सेटिंग में, एआई मैक्स की सुविधा चालू करें और पक्का करें कि कोई मान्य वर्टिकल फ़ीड लिंक हो.
VERTICAL_ADS_ITEM_GROUP_RULE_LIST_DOES_NOT_EXIST	AdGroupCriterion में दिया गया SharedSet संसाधन का नाम मौजूद नहीं है.	पक्का करें कि shared_set संसाधन का नाम, बनाए गए सेट से मेल खाता हो.
VERTICAL_ADS_ITEM_GROUP_RULE_IS_NOT_SUPPORTED...	इस्तेमाल किया गया मानदंड टाइप, खास वर्टिकल के लिए काम नहीं करता. जैसे, कार रेंटल के लिए होटल की क्लास.	देखें कि vertical_ads_item_group_rule डाइमेंशन, आपके वर्टिकल टाइप से मेल खाता है या नहीं.