Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड

होटल, छुट्टियों में किराये पर उपलब्ध जगहों या 'क्या-क्या करें' के प्रॉडक्ट फ़ीड को Google Ads खाते से लिंक करने पर, Google Ads आपके मौजूदा सर्च कैंपेन को आपके फ़ीड से ली गई कीमतों और इमेज के साथ अपने-आप बेहतर बनाता है. इस सुविधा को Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड के नाम से जाना जाता है.

ग्राहक की सेटिंग और कैंपेन की सेटिंग के बीच इंटरैक्शन कैसे होता है

डिफ़ॉल्ट रूप से, कैंपेन CustomerAssetSet असोसिएशन के ज़रिए, ग्राहक लेवल से यात्रा के फ़ीड के लिंक (TRAVEL_FEED ऐसेट सेट) इनहेरिट करते हैं. किसी कैंपेन के लिए, ग्राहक-लेवल की सेटिंग को बदलने के लिए, आपको कैंपेन के excluded_parent_asset_set_types फ़ील्ड में TRAVEL_FEED जोड़ना होगा. साथ ही, CampaignAssetSet का इस्तेमाल करके, कैंपेन के हिसाब से लिंक मैनेज करने होंगे.

  • ग्राहक फ़ीड इनहेरिट करें (डिफ़ॉल्ट): ग्राहक-लेवल के CustomerAssetSet को लिंक रखें और पक्का करें कि Campaign.excluded_parent_asset_set_types में TRAVEL_FEED शामिल न हो.
  • ग्राहक लेवल पर ऑप्ट आउट करना: ग्राहक लेवल पर मौजूद CustomerAssetSet असोसिएशन को हटाएं और कैंपेन लेवल पर मौजूद CampaignAssetSet को लिंक न करें.
  • किसी कैंपेन को ऑप्ट आउट करना: TRAVEL_FEED को Campaign.excluded_parent_asset_set_types में जोड़ें और कैंपेन-लेवल के किसी भी CampaignAssetSet असोसिएशन को हटाएं.
  • सिर्फ़ किसी खास कैंपेन के लिए ऑप्ट इन करना: ग्राहक-लेवल का CustomerAssetSet असोसिएशन हटाएं. इसके बाद, उस कैंपेन के लिए कैंपेन-लेवल का CampaignAssetSet लिंक बनाएं.
  • कैंपेन के हिसाब से फ़ीड का इस्तेमाल करें, जबकि अन्य कैंपेन इनहेरिट करते रहें: कैंपेन के Campaign.excluded_parent_asset_set_types में TRAVEL_FEED जोड़ें. साथ ही, इसके लिए कैंपेन-लेवल का CampaignAssetSet लिंक बनाएं.

Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड से ऑप्ट आउट करना

अगर आपको इस सुविधा का इस्तेमाल नहीं करना है, तो Google Ads API का इस्तेमाल करके, ग्राहक और कैंपेन लेवल पर Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड दिखाने की सुविधा से ऑप्ट आउट किया जा सकता है.

ग्राहक लेवल पर ऑप्ट आउट करना

ग्राहक लेवल पर, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड दिखाने से ऑप्ट आउट करने के लिए, यह तरीका अपनाएं:

  1. customer_asset_set रिपोर्ट का इस्तेमाल करके, CustomerAssetSet टाइप वाले उन सभी लिंक के लिए customer_asset_set.resource_name और asset_set.resource_name पाएं जिनका टाइप TRAVEL_FEED है:

    SELECT
      customer_asset_set.resource_name,
      asset_set.resource_name,
      asset_set.name
    FROM customer_asset_set
    WHERE asset_set.type = 'TRAVEL_FEED'
    
  2. हर customer_asset_set.resource_name के लिए, एक CustomerAssetSetOperation बनाएं और remove को पिछले चरण में मिले customer_asset_set.resource_name पर सेट करें.

  3. बनाए गए CustomerAssetSetOperation ऑब्जेक्ट का इस्तेमाल करके, CustomerAssetSetService.MutateCustomerAssetSets को अनुरोध सबमिट करें.

अगर आपको ग्राहक के लेवल पर इस सुविधा के लिए फिर से ऑप्ट इन करना है, तो:

  1. आपको जिस AssetSet (asset_set.resource_name) को लिंक करना है उसके लिए, asset_set को asset_set.resource_name पर सेट करके एक नया CustomerAssetSet बनाएं. साथ ही, customer को अपने ग्राहक के संसाधन के नाम पर सेट करें.
  2. पिछले चरण में बनाए गए हर CustomerAssetSet के लिए, CustomerAssetSetOperation बनाएं. साथ ही, create को CustomerAssetSet पर सेट करें.
  3. बनाए गए CustomerAssetSetOperation ऑब्जेक्ट का इस्तेमाल करके, CustomerAssetSetService.MutateCustomerAssetSets को अनुरोध सबमिट करें.

कैंपेन लेवल पर ऑप्ट आउट करना

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

  1. campaign रिपोर्ट का इस्तेमाल करके, excluded_parent_asset_set_types को वापस पाना:

    SELECT
      campaign.excluded_parent_asset_set_types
    FROM campaign
    WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'
    
  2. Campaign ऑब्जेक्ट बनाएं. इसमें excluded_parent_asset_set_types को पिछली वैल्यू प्लस TRAVEL_FEED पर सेट करें और resource_name को अपने कैंपेन के संसाधन के नाम पर सेट करें.

  3. CampaignOperation बनाएं और पहले से बनाए गए Campaign के लिए update सेट करें. साथ ही, इसके हिसाब से update_mask सेट करें.

  4. पिछले चरण में बनाए गए CampaignOperation का इस्तेमाल करके, CampaignService.MutateCampaigns को अनुरोध सबमिट करें.

इसके बाद, कैंपेन-लेवल पर यात्रा से जुड़े फ़ीड के सभी लिंक हटाएं:

  1. जिस कैंपेन के लिए ऑप्ट आउट करना है उसके लिए, campaign_asset_set रिपोर्ट का इस्तेमाल करके, CampaignAssetSet टाइप वाले उन सभी लिंक के लिए campaign_asset_set.resource_name और asset_set.resource_name पाएं जिनका टाइप TRAVEL_FEED है:

    SELECT
      campaign_asset_set.resource_name,
      asset_set.resource_name,
      asset_set.name
    FROM campaign_asset_set
    WHERE campaign_asset_set.campaign =
        'INSERT_YOUR_CAMPAIGN_RESOURCE_NAME'
      AND asset_set.type = 'TRAVEL_FEED'
    
  2. हर campaign_asset_set.resource_name के लिए, एक CampaignAssetSetOperation बनाएं और remove को पिछले चरण में वापस लाए गए campaign_asset_set.resource_name पर सेट करें.

  3. बनाए गए CampaignAssetSetOperation ऑब्जेक्ट का इस्तेमाल करके, CampaignAssetSetService.MutateCampaignAssetSets को अनुरोध सबमिट करें.

अगर आपको कैंपेन लेवल पर इस सुविधा के लिए फिर से ऑप्ट इन करना है, तो:

  1. हर उस AssetSet (asset_set.resource_name) के लिए जिसमें आपको शामिल होना है, एक नया CampaignAssetSet बनाएं. इसमें asset_set को asset_set.resource_name पर और campaign को अपने कैंपेन के संसाधन के नाम पर सेट करें.
  2. पिछले चरण में बनाए गए हर CampaignAssetSet के लिए, CampaignAssetSetOperation बनाएं. साथ ही, create को CampaignAssetSet पर सेट करें.
  3. बनाए गए CampaignAssetSetOperation ऑब्जेक्ट का इस्तेमाल करके, CampaignAssetSetService.MutateCampaignAssetSets को अनुरोध सबमिट करें.

किसी कैंपेन के लिए, ग्राहक-लेवल पर ऑप्ट-इन करने की स्थिति को पहले जैसा करना

किसी कैंपेन के ऑप्ट-इन स्टेटस को ग्राहक-लेवल की सेटिंग के मुताबिक फिर से सेट करने के लिए, यह तरीका अपनाएं:

  1. excluded_parent_asset_set_types के बिना TRAVEL_FEED को सूची में शामिल करके और resource_name को अपने कैंपेन के रिसॉर्स नेम पर सेट करके, एक नया Campaign ऑब्जेक्ट बनाएं.
  2. CampaignOperation बनाएं और पहले से बनाए गए Campaign के लिए update सेट करें. साथ ही, इसके हिसाब से update_mask सेट करें.
  3. पिछले चरण में बनाए गए CampaignOperation का इस्तेमाल करके, CampaignService.MutateCampaigns को अनुरोध सबमिट करें.

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

Google Ads API v25 से, यात्रा से जुड़े सर्च कैंपेन में मौजूद होटलों के लिए, हर इकाई के हिसाब से मैन्युअल सीपीसी बिड ओवरराइड कॉन्फ़िगर किए जा सकते हैं. इसके लिए, आपको मानदंड टाइप CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid) के साथ AdGroupCriterion संसाधन का इस्तेमाल करना होगा.

ज़रूरी शर्तें और वर्शन के साथ काम करने से जुड़ी ज़रूरी शर्तें

VERTICAL_ADS_ITEM_BID मानदंड बनाने और उन्हें मैनेज करने के लिए, ये शर्तें पूरी होनी चाहिए:

  • कैंपेन टाइप: यात्रा के लिए सर्च कैंपेन (सर्च कैंपेन, AdvertisingChannelType.SEARCH, जिनमें सर्च कैंपेन के लिए एआई मैक्स की सुविधा चालू हो Campaign.ai_max_setting.enable_ai_max और होटल फ़ीड [TRAVEL_FEED ऐसेट सेट] जुड़ा हो; सिर्फ़ होटल फ़ीड काम करते हैं).
  • बिडिंग की रणनीति: सिर्फ़ मैन्युअल सीपीसी (BiddingStrategyType.MANUAL_CPC) का इस्तेमाल किया जाता है.
    • यह सुविधा, ऑटोमैटिक या स्मार्ट बिडिंग की रणनीतियों के साथ काम नहीं करती. जैसे, कन्वर्ज़न बढ़ाएं, कन्वर्ज़न वैल्यू बढ़ाएं, टारगेट सीपीए या टारगेट आरओएएस.
  • सिर्फ़ पॉज़िटिव क्राइटेरिया: negative को false पर सेट करना ज़रूरी है. नेगेटिव इकाई वाली बिड का इस्तेमाल नहीं किया जा सकता.
  • इकाई का आइडेंटिफ़ायर और बिड ज़रूरी है: इकाई के लिए बिड की शर्त बनाते समय, entity_bid.item_code और cpc_bid_micros ज़रूरी हैं.

स्कीमा और फ़ील्ड की परिभाषाएं

फ़ील्ड टाइप व्यवहार ब्यौरा
entity_bid EntityBid IMMUTABLE किसी एक आइटम के लिए, मैन्युअल बिड ओवरराइड को दिखाने वाली शर्त.
entity_bid.item_code string IMMUTABLE में जानकारी भरना ज़रूरी है किसी पार्टनर होटल इकाई (होटल लिस्टिंग आईडी) की जानकारी देने वाला आईडी या कोड, जो पार्टनर के होटल फ़ीड से मैच करता हो. इसमें 1 से 256 वर्ण हो सकते हैं.
cpc_bid_micros int64 पढ़ने/लिखने की अनुमति मैन्युअल सीपीसी बिडिंग की रकम, माइक्रो में (उदाहरण के लिए, 1000000 बराबर है $1.00).
negative bool IMMUTABLE false होना चाहिए.

इस्तेमाल की जा सकने वाली सेवाएं और कार्रवाइयां

सेवा तरीका कौनसी कार्रवाइयां की जा सकती हैं
AdGroupCriterionService MutateAdGroupCriteria create, update (cpc_bid_micros), remove
GoogleAdsService Search / SearchStream क्वेरी की शर्तों के एट्रिब्यूट, आइटम कोड, और बिड वैल्यू

कोड और पेलोड के उदाहरण

यहां दिए गए उदाहरणों में, VERTICAL_ADS_ITEM_BID की शर्तों को पढ़ने, बनाने, अपडेट करने, और हटाने का तरीका बताया गया है.

GAQL का इस्तेमाल करके, इकाई के लिए बिड पढ़ना

VERTICAL_ADS_ITEM_BID की शर्तों के बारे में क्वेरी करने के लिए, GoogleAdsService.Search या GoogleAdsService.SearchStream का इस्तेमाल करें:

SELECT
  ad_group_criterion.resource_name,
  ad_group_criterion.ad_group,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.cpc_bid_micros,
  ad_group_criterion.entity_bid.item_code
FROM ad_group_criterion
WHERE ad_group_criterion.type = 'VERTICAL_ADS_ITEM_BID'

इकाई के लिए बिड बनाना

AdGroupCriterionService.MutateAdGroupCriteria को create ऑपरेशन भेजें:

{
  "customerId": "1234567890",
  "operations": [
    {
      "create": {
        "adGroup": "customers/1234567890/adGroups/987654321",
        "negative": false,
        "cpcBidMicros": "1500000",
        "entityBid": {
          "itemCode": "hotel_nyc_12345"
        }
      }
    }
  ]
}

किसी मौजूदा इकाई के लिए बिड की रकम अपडेट करना

AdGroupCriterionService.MutateAdGroupCriteria पर updateMask के साथ update ऑपरेशन भेजें:

{
  "customerId": "1234567890",
  "operations": [
    {
      "updateMask": "cpcBidMicros",
      "update": {
        "resourceName": "customers/1234567890/adGroupCriteria/987654321~555444333",
        "cpcBidMicros": "2000000"
      }
    }
  ]
}

इकाई की बिड हटाना

AdGroupCriterionService.MutateAdGroupCriteria को remove ऑपरेशन भेजें:

{
  "customerId": "1234567890",
  "operations": [
    {
      "remove": "customers/1234567890/adGroupCriteria/987654321~555444333"
    }
  ]
}

पुष्टि करने के नियम और गड़बड़ी ठीक करना

स्थिति ट्रिगर / शर्त गड़बड़ी का कोड मिला
नॉन-मैन्युअल सीपीसी कैंपेन ऑटोमेटेड बिडिंग या स्मार्ट बिडिंग की सुविधा वाले कैंपेन में, इकाई के लिए बिड बनाने की कोशिश की जा रही है. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
अमान्य अभियान प्रकार किसी गैर-सर्च कैंपेन (उदाहरण के लिए, डिसप्ले कैंपेन) में इकाई के लिए बिड जोड़ना. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
नेगेटिव क्राइटेरिया VERTICAL_ADS_ITEM_BID के लिए negative = true सेट अप किया जा रहा है. ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT
आइटम कोड या बिड मौजूद नहीं है item_code या cpc_bid_micros दिए बिना entity_bid बनाने की कोशिश करना. RequestError.REQUIRED_FIELD_MISSING / FieldError.REQUIRED
आइटम का कोड बदलना किसी मौजूदा मानदंड के लिए entity_bid.item_code अपडेट करने की कोशिश की जा रही है. FieldError.IMMUTABLE_FIELD में से RequestError.IMMUTABLE_FIELD चरण

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

ClickType.TRAVEL_ASSETS का इस्तेमाल करके, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड के तौर पर दिखाए जाने वाले विज्ञापनों का परफ़ॉर्मेंस डेटा देखा जा सकता है. जैसे, अपने सभी कैंपेन के विज्ञापनों का परफ़ॉर्मेंस डेटा फ़ेच करना:

SELECT
  campaign.name,
  segments.click_type,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.click_type = 'TRAVEL_ASSETS'

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

यात्रा के फ़ीड से लिंक किए गए कैंपेन की परफ़ॉर्मेंस रिपोर्ट को यात्रा की योजना के डाइमेंशन के हिसाब से भी सेगमेंट में बांटा जा सकता है.

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

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

SELECT
  campaign.name,
  segments.advance_booking_window,
  segments.length_of_booking,
  segments.start_date,
  segments.start_day_of_week,
  segments.user_set_dates,
  metrics.impressions,
  metrics.clicks
FROM campaign
WHERE segments.date DURING LAST_30_DAYS