होटल, छुट्टियों में किराये पर उपलब्ध जगहों या 'क्या-क्या करें' के प्रॉडक्ट फ़ीड को Google Ads खाते से लिंक करने पर, Google Ads आपके मौजूदा सर्च कैंपेन को आपके फ़ीड से ली गई कीमतों और इमेज के साथ अपने-आप बेहतर बना देता है. इस सुविधा को Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड के तौर पर जाना जाता है.
ग्राहक की सेटिंग और कैंपेन की सेटिंग के बीच इंटरैक्शन कैसे होता है
डिफ़ॉल्ट रूप से, कैंपेन को ग्राहक लेवल से यात्रा से जुड़े विज्ञापनों के फ़ीड के लिंक (TRAVEL_FEED ऐसेट सेट) मिलते हैं. इसके लिए, CustomerAssetSet असोसिएशन का इस्तेमाल किया जाता है. किसी कैंपेन के लिए ग्राहक-लेवल की सेटिंग को बदलने के लिए, आपको कैंपेन के 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 में दिखने वाले विज्ञापनों में यात्रा के फ़ीड दिखाने की सुविधा से ऑप्ट आउट करने के लिए, यह तरीका अपनाएं:
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'हर
customer_asset_set.resource_nameके लिए, एकCustomerAssetSetOperationबनाएं औरremoveको पिछले चरण में मिलेcustomer_asset_set.resource_nameपर सेट करें.बनाए गए
CustomerAssetSetOperationऑब्जेक्ट का इस्तेमाल करके,CustomerAssetSetService.MutateCustomerAssetSetsको अनुरोध सबमिट करें.
अगर आपको ग्राहक के लेवल पर इस सुविधा में फिर से शामिल होना है, तो:
- आपको जिस
AssetSet(asset_set.resource_name) को लिंक करना है उसके लिए, एक नयाCustomerAssetSetबनाएं. इसमेंasset_setकोasset_set.resource_nameपर औरcustomerको अपने ग्राहक के संसाधन के नाम पर सेट करें. - पिछले चरण में बनाए गए हर
CustomerAssetSetके लिए, एकCustomerAssetSetOperationबनाएं. साथ ही,createकोCustomerAssetSetपर सेट करें. - बनाए गए
CustomerAssetSetOperationऑब्जेक्ट का इस्तेमाल करके,CustomerAssetSetService.MutateCustomerAssetSetsको अनुरोध सबमिट करें.
कैंपेन लेवल पर ऑप्ट आउट करना
कैंपेन लेवल पर, Search Network में दिखने वाले विज्ञापनों में यात्रा के फ़ीड दिखाने की सुविधा से बाहर होने के लिए, आपको सबसे पहले ग्राहक लेवल पर, शामिल होने की स्थिति को हटाना होगा:
campaignरिपोर्ट का इस्तेमाल करके,excluded_parent_asset_set_typesको वापस पाना:SELECT campaign.excluded_parent_asset_set_types FROM campaign WHERE campaign.id = 'INSERT_YOUR_CAMPAIGN_ID'एक नया
Campaignऑब्जेक्ट बनाएं, जिसमेंexcluded_parent_asset_set_typesको पिछली वैल्यू के साथ-साथTRAVEL_FEEDपर सेट किया गया हो. साथ ही,resource_nameको आपके कैंपेन के रिसॉर्स नेम पर सेट किया गया हो.CampaignOperationबनाएं औरupdateको पहले से बनाए गएCampaignऔरupdate_maskके हिसाब से सेट करें.पिछले चरण में बनाए गए
CampaignOperationका इस्तेमाल करके,CampaignService.MutateCampaignsको अनुरोध सबमिट करें.
इसके बाद, कैंपेन-लेवल पर यात्रा से जुड़े फ़ीड के सभी असोसिएशन हटाएं:
जिस कैंपेन को ऑप्ट आउट करना है उसके लिए,
CampaignAssetSetके उन सभी लिंक के लिएcampaign_asset_set.resource_nameऔरasset_set.resource_name, दोनों को वापस पाएं जिनका टाइपTRAVEL_FEEDहै. इसके लिए,campaign_asset_setरिपोर्ट का इस्तेमाल करें: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'हर
campaign_asset_set.resource_nameके लिए, एकCampaignAssetSetOperationबनाएं औरremoveको पिछले चरण में मिलेcampaign_asset_set.resource_nameपर सेट करें.बनाए गए
CampaignAssetSetOperationऑब्जेक्ट का इस्तेमाल करके,CampaignAssetSetService.MutateCampaignAssetSetsको अनुरोध सबमिट करें.
अगर आपको कैंपेन लेवल पर इस सुविधा के लिए फिर से ऑप्ट इन करना है, तो:
- हर उस
AssetSet(asset_set.resource_name) के लिए जिसमें आपको शामिल होना है, एक नयाCampaignAssetSetबनाएं. इसमेंasset_setकोasset_set.resource_nameपर औरcampaignको अपने कैंपेन के संसाधन के नाम पर सेट करें. - पिछले चरण में बनाए गए हर
CampaignAssetSetके लिए, एकCampaignAssetSetOperationबनाएं. साथ ही,createकोCampaignAssetSetपर सेट करें. - बनाए गए
CampaignAssetSetOperationऑब्जेक्ट का इस्तेमाल करके,CampaignAssetSetService.MutateCampaignAssetSetsको अनुरोध सबमिट करें.
किसी कैंपेन के लिए, ग्राहक-लेवल पर शामिल होने की स्थिति को पहले जैसा करना
किसी कैंपेन के शामिल होने के स्टेटस को ग्राहक-लेवल की सेटिंग के मुताबिक फिर से सेट करने के लिए, यह तरीका अपनाएं:
- सूची में
excluded_parent_asset_set_typesके बिनाTRAVEL_FEEDके साथ नयाCampaignऑब्जेक्ट बनाएं. साथ ही,resource_nameको अपने कैंपेन के रिसॉर्स नेम पर सेट करें. CampaignOperationबनाएं औरupdateको पहले से बनाए गएCampaignऔरupdate_maskके हिसाब से सेट करें.- पिछले चरण में बनाए गए
CampaignOperationका इस्तेमाल करके,CampaignService.MutateCampaignsको अनुरोध सबमिट करें.
हर इकाई के लिए मैन्युअल सीपीसी बिडिंग
Google Ads API v25 से, यात्रा के लिए सर्च कैंपेन में होटलों के लिए, हर इकाई के हिसाब से मैन्युअल सीपीसी बिड ओवरराइड को कॉन्फ़िगर किया जा सकता है. इसके लिए, AdGroupCriterion रिसॉर्स का इस्तेमाल करें. साथ ही, शर्त के टाइप के तौर पर CriterionType.VERTICAL_ADS_ITEM_BID (ad_group_criterion.entity_bid) को चुनें. AdGroupBidModifier का इस्तेमाल करके, यात्रा की योजना के डाइमेंशन के हिसाब से, विज्ञापन ग्रुप की बिड में बदलाव करने के लिए, बिड मॉडिफ़ायर की मदद से बिड में बदलाव करना लेख पढ़ें.
ज़रूरी शर्तें और साथ काम करने से जुड़ी ज़रूरी शर्तें
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} - Criterion type enum:
CriterionType.VERTICAL_ADS_ITEM_BID - मैसेज:
EntityBid(ad_group_criterion.entity_bid)
| फ़ील्ड | टाइप | व्यवहार | ब्यौरा |
|---|---|---|---|
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).
v26 से, यात्रा की योजना के इन डाइमेंशन सेगमेंट के साथ-साथ, metrics.search_top_impression_share और metrics.search_click_share मेट्रिक के लिए क्वेरी की जा सकती है.
क्वेरी का उदाहरण
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,
metrics.search_top_impression_share,
metrics.search_click_share
FROM campaign
WHERE segments.date DURING LAST_30_DAYS