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

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

खास जानकारी

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

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

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

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

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

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

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

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

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

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

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

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

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

सत्यापन नियम

• किसी एक विज्ञापन ग्रुप के लिए, तीनों फ़ॉर्मैट से एक साथ ऑप्ट आउट नहीं किया जा सकता.
• enable_booking_links को सिर्फ़ तब true पर सेट किया जा सकता है, जब कैंपेन का चालू वर्टिकल फ़ीड HOTELS या THINGS_TO_DO हो.
• ये सेटिंग, सिर्फ़ 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(
        AdGroup.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) में, इन डाइमेंशन के आधार पर इकाइयों को फ़िल्टर किया जा सकता है. हालांकि, यह SharedSet के vertical_ads_item_vertical_type पर निर्भर करता है:

• item_code: खास लिस्टिंग आईडी (सभी वर्टिकल टाइप के लिए काम करता है).
• city_criterion_id, region_criterion_id, country_criterion_id: इलाके के हिसाब से टारगेट करने के लिए कॉन्स्टेंट रिसॉर्स के नाम (geoTargetConstants/{id}; FLIGHTS को छोड़कर, सभी वर्टिकल टाइप के लिए काम करता है).
• hotel_class: 1 से 5 तक की स्टार रेटिंग (सिर्फ़ HOTELS).
• user_rating (v24 से शुरू): 1 से 5 के बीच की उपयोगकर्ता रेटिंग को राउंड डाउन करके दिखाया जाता है (सिर्फ़ THINGS_TO_DO के लिए).
• venue, event_participant_display_name (v24 से शुरू): इवेंट की जगह और हिस्सा लेने वाले व्यक्ति के डिसप्ले नेम के फ़िल्टर (सिर्फ़ EVENTS).

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

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...

हर इकाई के लिए मैन्युअल सीपीसी बिडिंग

v25 से, यात्रा के लिए सर्च कैंपेन (सर्च कैंपेन के लिए एआई मैक्स की सुविधा वाले सर्च कैंपेन और लिंक किए गए होटल फ़ीड) के लिए, मैन्युअल सीपीसी (BiddingStrategyType.MANUAL_CPC) बिडिंग की रणनीति का इस्तेमाल किया जा सकता है. इसके लिए, EntityBid (ad_group_criterion.entity_bid) शर्त के साथ CriterionType.VERTICAL_ADS_ITEM_BID और entity_bid.item_code का इस्तेमाल करके, होटल फ़ीड के अलग-अलग आइटम के लिए मैन्युअल सीपीसी बिड ओवरराइड (cpc_bid_micros) सेट किए जा सकते हैं.

VERTICAL_ADS_ITEM_BID के लिए, नेगेटिव क्राइटेरिया (negative = true), सर्च कैंपेन के अलावा अन्य कैंपेन, और ऑटोमेटेड बिडिंग या स्मार्ट बिडिंग की रणनीतियां काम नहीं करतीं. साथ ही, ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT गड़बड़ी दिखती है. परफ़ॉर्मेंस मेट्रिक, VERTICAL_ADS_ITEM_BID की शर्तों के हिसाब से नहीं भरी जाती हैं. स्कीमा की पूरी जानकारी, GAQL क्वेरी, और म्यूटेट पेलोड के उदाहरणों के लिए, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड की गाइड में, हर इकाई के लिए मैन्युअल सीपीसी बिडिंग देखें. AdGroupBidModifier का इस्तेमाल करके, होटल विज्ञापनों के लिए यात्रा की योजना के डाइमेंशन के हिसाब से, विज्ञापन ग्रुप के लिए बिड घटाने या बढ़ाने की सेटिंग को सेट करने के लिए, बिड मॉडिफ़ायर की मदद से बिड घटाएं या बढ़ाएं देखें.

परफ़ॉर्मेंस रिपोर्ट

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: इवेंट लिस्टिंग में हिस्सा लेने वाले लोगों के डिसप्ले नेम. जैसे, परफ़ॉर्मर, स्पीकर या टीमें.
• 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: विज्ञापन देने वाले व्यक्ति या कंपनी के ऑफ़र किए गए किराये और उसी प्रॉपर्टी के लिए, विज्ञापन देने वाले किसी अन्य व्यक्ति या कंपनी के ऑफ़र किए गए सबसे कम किराये के बीच का अंतर प्रतिशत में.

v26 से, metrics.search_top_impression_share और metrics.search_click_share मेट्रिक को भी क्वेरी किया जा सकता है. इसके लिए, segments.vertical_ads_* सेगमेंट और यात्रा की योजना के डाइमेंशन सेगमेंट, दोनों का इस्तेमाल किया जा सकता है.

• metrics.vertical_ads_* मेट्रिक को यात्रा की योजना के डाइमेंशन सेगमेंट (segments.advance_booking_window, segments.length_of_booking, segments.start_date, segments.start_day_of_week, और segments.user_set_dates) के साथ नहीं चुना जा सकता.
• यात्रा की योजना के डाइमेंशन सेगमेंट, सिर्फ़ लिस्टिंग-लेवल और पार्टनर-लेवल के वर्टिकल विज्ञापन सेगमेंट के साथ काम करते हैं. जैसे, (segments.vertical_ads_hotel_class, 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, और segments.vertical_ads_vertical).
• किराये और इवेंट के हिसाब से वर्टिकल विज्ञापनों के सेगमेंट (segments.vertical_ads_price_tier, segments.vertical_ads_rate_rule_id, segments.vertical_ads_rate_type, segments.vertical_ads_event_participant_display_names, segments.vertical_ads_listing_user_rating, और segments.vertical_ads_listing_venue) को यात्रा की योजना के डाइमेंशन सेगमेंट के साथ नहीं जोड़ा जा सकता.

GAQL क्वेरी के सैंपल

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

SELECT
  campaign.id,
  ad_group.id,
  segments.vertical_ads_listing_city,
  segments.vertical_ads_price_tier,
  segments.vertical_ads_rate_type,
  metrics.vertical_ads_potential_impressions,
  metrics.vertical_ads_average_booking_value_micros,
  metrics.vertical_ads_price_difference_percentage,
  metrics.search_top_impression_share,
  metrics.search_click_share
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

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

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.clicks,
  metrics.all_conversions_value,
  metrics.search_top_impression_share,
  metrics.search_click_share
FROM
  ad_group
WHERE
  segments.date DURING LAST_30_DAYS

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

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