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) को लिंक करना है उसके लिए, एक नया CustomerAssetSet बनाएं. इसमें asset_set को asset_set.resource_name पर सेट करें और 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_mask के हिसाब से update सेट करें.

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) के लिए ऑप्ट इन करना है उसके लिए, asset_set को asset_set.resource_name पर सेट करके एक नया CampaignAssetSet बनाएं. साथ ही, campaign को अपने कैंपेन के संसाधन के नाम पर सेट करें.
2. पिछले चरण में बनाए गए हर CampaignAssetSet के लिए, CampaignAssetSetOperation बनाएं. साथ ही, create को CampaignAssetSet पर सेट करें.
3. बनाए गए CampaignAssetSetOperation ऑब्जेक्ट का इस्तेमाल करके, CampaignAssetSetService.MutateCampaignAssetSets को अनुरोध सबमिट करें.

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

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

1. Campaign ऑब्जेक्ट बनाएं. इसमें सूची में excluded_parent_asset_set_types without TRAVEL_FEED और resource_name को अपने कैंपेन के संसाधन के नाम पर सेट करें.
2. CampaignOperation बनाएं और पहले से बनाए गए Campaign और update_mask के हिसाब से update सेट करें.
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 ज़रूरी हैं.

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

• संसाधन: AdGroupCriterion (ad_group_criterion)
• संसाधन के नाम का फ़ॉर्मैट: customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}
• मानदंड टाइप एनम: CriterionType.VERTICAL_ADS_ITEM_BID
• मैसेज: EntityBid (ad_group_criterion.entity_bid)

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

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

यहां दिए गए उदाहरणों में, 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"
    }
  ]
}

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

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

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