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

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

खास जानकारी देने वाला बटन

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

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

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

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

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

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

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

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

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

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

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

सत्यापन नियम

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

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

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

// Assuming 'adGroup' is an existing AdGroup object.
// Example resource name: "customers/{customer_id}/adGroups/{ad_group_id}"
AdGroup adGroupToUpdate = AdGroup.newBuilder()
    .setResourceName(adGroup.getResourceName())
    .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 (vertical_ads_item_group_rule_list) का इस्तेमाल करके, SharedSet को अपने AdGroup से लिंक करें.

समर्थित आयाम

SharedCriterion (VerticalAdsItemGroupRuleInfo) में मौजूद इन डाइमेंशन के आधार पर, इकाइयों को फ़िल्टर किया जा सकता है:

  • item_code: खास लिस्टिंग आईडी.
  • city_criterion_id, region_criterion_id, country_criterion_id: जियो टारगेट कॉन्स्टेंट के संसाधन के नाम (geoTargetConstants/{id}).
  • hotel_class: स्टार रेटिंग (1 से 5).
  • user_rating, venue, event_participant_display_name (v24 से शुरू हो रहा है): इवेंट और वर्टिकल लिस्टिंग की रेटिंग, जगह, और हिस्सा लेने वाले का नाम फ़िल्टर करने की सुविधा.

इस Python उदाहरण में, "बोस्टन" या "सैन फ़्रांसिस्को" में मौजूद होटल को शामिल करने और "1-स्टार" और "2-स्टार" होटल को बाहर रखने का नियम बनाया गया है:

# 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
)
shared_set_service = client.get_service("SharedSetService")
shared_set_response = shared_set_service.mutate_shared_sets(
    customer_id=customer_id, operations=[shared_set_operation]
)
shared_set_resource_name = shared_set_response.results[0].resource_name

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

# Rule A: Include Boston and SF
geo_target_constant_service = client.get_service("GeoTargetConstantService")
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 = (
      geo_target_constant_service.geo_target_constant_path(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
ad_group_service = client.get_service("AdGroupService")
ad_group_resource_name = ad_group_service.ad_group_path(
    customer_id, ad_group_id
)
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 तरीकों का इस्तेमाल करके, वर्टिकल विज्ञापनों की परफ़ॉर्मेंस मेट्रिक को वापस पाया जा सकता है.

वर्टिकल विज्ञापनों के सेगमेंट

  • segments.vertical_ads_hotel_class: पूर्णांक वैल्यू (1 से 5 स्टार तक). इससे होटल की लिस्टिंग के लिए क्लास रेटिंग तय की जाती है.
  • segments.vertical_ads_listing: किसी वर्टिकल विज्ञापन लिस्टिंग का आइडेंटिफ़ायर.
  • segments.vertical_ads_listing_brand: वर्टिकल विज्ञापन लिस्टिंग से जुड़ा ब्रैंड.
  • segments.vertical_ads_listing_city: लिस्टिंग से जुड़ा शहर.
  • segments.vertical_ads_listing_country: वह देश जहां यह लिस्टिंग उपलब्ध है.
  • segments.vertical_ads_listing_region: वह देश/इलाका जहां के लिए लिस्टिंग की गई है.
  • segments.vertical_ads_partner_account: Partner Center (उदाहरण के लिए, Hotel Center) में मौजूद पार्टनर खाता, जो इन्वेंट्री फ़ीड का डेटा उपलब्ध कराता है.
  • segments.vertical_ads_vertical: वर्टिकल टाइप, जैसे कि होटल या किराये की कार.
  • segments.vertical_ads_event_participant_display_names (v24 से शुरू हो रहा है): इवेंट की लिस्टिंग में हिस्सा लेने वाले लोगों के डिसप्ले नेम, जैसे कि परफ़ॉर्मर, स्पीकर या टीमें.
  • segments.vertical_ads_listing_user_rating (v24 से शुरू): पूर्णांक वैल्यू (1 से 5), जो वर्टिकल विज्ञापन की लिस्टिंग के लिए उपयोगकर्ता रेटिंग के बारे में बताती है.
  • segments.vertical_ads_listing_venue (v24 से शुरू हो रहा है): वर्टिकल विज्ञापनों की लिस्टिंग के लिए जगह का नाम (उदाहरण के लिए, कॉन्सर्ट की जगह).
  • segments.vertical_ads_price_tier (v25 से शुरू): होटल लिस्टिंग के लिए, कीमत की तुलना से जुड़ी परफ़ॉर्मेंस बकेट.
  • segments.vertical_ads_rate_rule_id (v25 से शुरू): यह स्ट्रिंग आइडेंटिफ़ायर, बिड या इंप्रेशन पर लागू होने वाले निजी या शर्तों के साथ तय किए गए दर के नियमों से मेल खाता है.
  • segments.vertical_ads_rate_type (v25 से शुरू): सार्वजनिक, निजी या खास किराये के टाइप का कैटगरी के हिसाब से बंटवारा.

यात्रा की योजना के डाइमेंशन सेगमेंट

v25 से, यात्रा और ठहरने की जगह के फ़ीड से लिंक किए गए वर्टिकल विज्ञापनों के लिए, यात्रा की योजना के डाइमेंशन का इस्तेमाल करके परफ़ॉर्मेंस रिपोर्ट को सेगमेंट किया जा सकता है:

  • segments.advance_booking_window: यात्रा की योजना के लिए, बुकिंग करने की विंडो (दिनों में).
  • segments.length_of_booking: यात्रा की योजना के लिए बुकिंग की अवधि, दिनों में.
  • segments.start_date: बुकिंग के शुरू होने की तारीख. इसे yyyy-MM-dd के तौर पर फ़ॉर्मैट किया जाता है.
  • segments.start_day_of_week: बुकिंग शुरू होने का हफ़्ते का दिन.
  • segments.user_set_dates: इससे पता चलता है कि उपयोगकर्ता की ओर से तय की गई तारीखें चुनी गई हैं या नहीं (USER_SELECTED या DEFAULT_SELECTION).

वर्टिकल विज्ञापनों की मेट्रिक

v25 से, वर्टिकल वीडियो विज्ञापनों की इन मेट्रिक को वापस पाया जा सकता है:

  • metrics.vertical_ads_potential_impressions: संभावित इंप्रेशन, क्वेरी के कॉन्टेक्स्ट में उपलब्ध, व्यू कैपिंग की ज़रूरी शर्तें पूरी करने वाले इंप्रेशन की कुल संख्या दिखाते हैं.
  • metrics.vertical_ads_average_booking_value_micros: ठहरने की कुल अवधि के लिए, टैक्स और शुल्क के साथ हर दिन का औसत किराया. यह किराया, क्लिक के हिसाब से तय किया जाता है.
  • metrics.vertical_ads_price_difference_percentage: विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से ऑफ़र किए गए किराये की तुलना, उसी प्रॉपर्टी के लिए विज्ञापन देने वाले अन्य लोगों या कंपनियों के सबसे कम किराये से करने पर मिलने वाला अंतर.

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

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  metrics.impressions,
  metrics.vertical_ads_potential_impressions,
  metrics.clicks,
  metrics.all_conversions_value,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

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

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

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