कस्टम बिडिंग लागू करने की सुविधा को मैनेज करने के लिए, Display & Video 360 API का इस्तेमाल किया जा सकता है. इसकी मदद से, कस्टम बिडिंग के एल्गोरिदम बनाए जा सकते हैं. साथ ही, अलग-अलग स्क्रिप्ट अपलोड और उनकी पुष्टि की जा सकती है. इसके अलावा, किसी संसाधन को उसकी बिडिंग की रणनीति के तौर पर कोई खास एल्गोरिदम असाइन किया जा सकता है.
इस पेज पर, Display &Video 360 API की मदद से, कस्टम बिडिंग के एल्गोरिदम बनाने, उन्हें अपडेट करने, और असाइन करने का तरीका बताया गया है. हर सेक्शन में, कोड का एक सैंपल दिया गया है.
कस्टम बिडिंग का एल्गोरिदम बनाना
एक CustomBiddingAlgorithm ऑब्जेक्ट, एक ऐसे
एल्गोरिदम को दिखाता है जिसे लाइन आइटम को असाइन किया जा सकता है. इससे लाइन आइटम की बिडिंग की रणनीति तय की जा सकती है. इस
ऑब्जेक्ट में, एल्गोरिदम के बारे में जानकारी होती है. जैसे,
customBiddingAlgorithmType,
entityStatus और
customBiddingAlgorithmState. एल्गोरिदम
के लिए, चाइल्ड रिसॉर्स के तौर पर
CustomBiddingScript ऑब्जेक्ट बनाए जा सकते हैं.
स्क्रिप्ट पर आधारित कस्टम बिडिंग एल्गोरिदम बनाने का तरीका यहां दिया गया है:
Python
# Create a custom bidding algorithm object. custom_bidding_algorithm_obj = { 'advertiserId': advertiser-id, 'displayName': display-name, 'entityStatus': 'ENTITY_STATUS_ACTIVE', 'customBiddingAlgorithmType': 'SCRIPT_BASED' } # Create the custom bidding algorithm. response = service.customBiddingAlgorithms().create( body=algorithm_obj ).execute() # Display the new custom bidding algorithm. print(f'The following Custom Bidding Algorithm was created: {response}')
एल्गोरिदम का ऐक्सेस मैनेज करना
कस्टम बिडिंग के एल्गोरिदम का मालिकाना हक, किसी पार्टनर या विज्ञापन देने वाले व्यक्ति या कंपनी के पास हो सकता है. पार्टनर के मालिकाना हक वाले एल्गोरिदम को, वह पार्टनर और कोई भी चाइल्ड विज्ञापन देने वाला व्यक्ति या कंपनी ऐक्सेस और उसमें बदलाव कर सकती है.sharedAdvertiserIds
विज्ञापन देने वाले व्यक्ति या कंपनी के मालिकाना हक वाले एल्गोरिदम को, वह विज्ञापन देने वाला व्यक्ति या कंपनी और उसका पैरंट पार्टनर ऐक्सेस और उसमें बदलाव कर सकता है. हालांकि, इसे दूसरे विज्ञापन देने वाले लोगों या कंपनियों के साथ शेयर नहीं किया जा सकता.
अगर एल्गोरिदम का इस्तेमाल सिर्फ़ एक विज्ञापन देने वाले व्यक्ति या कंपनी के लिए किया जा रहा है, तो
विज्ञापन देने वाले व्यक्ति या कंपनी को advertiserId फ़ील्ड की मदद से, मालिक के तौर पर असाइन करें.
इसके अलावा,
partnerId फ़ील्ड की मदद से, विज्ञापन देने वाले लोगों या कंपनियों के पैरंट पार्टनर को मालिक के तौर पर असाइन करें. साथ ही,
sharedAdvertiserIds फ़ील्ड की मदद से, विज्ञापन देने वाले लोगों या कंपनियों को ऐक्सेस दें.
कोई स्क्रिप्ट अपलोड करना
कस्टम बिडिंग का एल्गोरिदम बनाने के बाद, उस एल्गोरिदम के लिए कोई स्क्रिप्ट बनाएं. स्क्रिप्ट पर आधारित कस्टम बिडिंग एल्गोरिदम, इंप्रेशन की वैल्यू का आकलन करने के लिए, उपयोगकर्ता की दी गई स्क्रिप्ट का इस्तेमाल करते हैं. सामान्य स्क्रिप्ट के सैंपल और बेहतर फ़ील्ड की सूची Display & Video 360 के सहायता केंद्र में उपलब्ध है.
यहां दिए गए सेक्शन में, कस्टम बिडिंग के एल्गोरिदम में नई या अपडेट की गई स्क्रिप्ट जोड़ने का तरीका बताया गया है.
स्क्रिप्ट रिसॉर्स की जगह की जानकारी पाना
सबसे पहले, कस्टम बिडिंग
एल्गोरिदम रिसॉर्स के तहत उपलब्ध रिसॉर्स की जगह की जानकारी पाएं.customBiddingAlgorithms.uploadScript इस
अनुरोध से, CustomBiddingScriptRef ऑब्जेक्ट मिलता है, जिसमें
रिसॉर्स का नाम होता है. स्क्रिप्ट की फ़ाइल को, रिसॉर्स के नाम से तय की गई जगह पर अपलोड किया जा सकता है. इसके बाद, स्क्रिप्ट रिसॉर्स बनाने के लिए, कस्टम बिडिंग स्क्रिप्ट रेफ़रंस ऑब्जेक्ट का इस्तेमाल करें
अपनी स्क्रिप्ट का रिसॉर्स बनाएं.
उपलब्ध रिसॉर्स की जगह की जानकारी पाने का तरीका यहां दिया गया है:
Python
# Retrieve a usable custom bidding script reference # object. custom_bidding_script_ref = service.customBiddingAlgorithms().uploadScript( customBiddingAlgorithmId=custom-bidding-algorithm-id, advertiserId=advertiser-id ).execute() # Display the new custom bidding script reference object. print('The following custom bidding script reference object was retrieved:' f'{custom_bidding_script_ref}')
स्क्रिप्ट की फ़ाइल अपलोड करना
उपलब्ध रिसॉर्स की जगह की जानकारी पाने के बाद, स्क्रिप्ट की फ़ाइल को Display & Video 360 सिस्टम में उस
जगह पर
media.upload तरीके का इस्तेमाल करके अपलोड करें. यह तरीका, सामान्य अपलोड की सुविधा के साथ काम करता है. इसके लिए, क्वेरी पैरामीटर
uploadType=media की ज़रूरत होती है.
यहां, पाए गए कस्टम बिडिंग स्क्रिप्ट रेफ़रंस ऑब्जेक्ट की मदद से, स्क्रिप्ट की फ़ाइल अपलोड करने का तरीका बताया गया है:
Python
# Create a media upload object. media = MediaFileUpload(script-path) # Create upload request. upload_request = service.media().upload( resourceName=resource-name, media_body=media) # Override response handler to expect null response. upload_request.postproc = HttpRequest.null_postproc # Upload script to resource location given in retrieved custom bidding # script reference object. upload_request.execute()
स्क्रिप्ट ऑब्जेक्ट बनाना
स्क्रिप्ट की फ़ाइल अपलोड हो जाने के बाद, कस्टम बिडिंग स्क्रिप्ट रिसॉर्स बनाने के लिए
customBiddingAlgorithms.scripts.create तरीके का इस्तेमाल करें. अनुरोध में पास किए गए
CustomBiddingScript ऑब्जेक्ट में, script फ़ील्ड की असाइन की गई
वैल्यू के तौर पर सिर्फ़
CustomBiddingScriptRef ऑब्जेक्ट शामिल होना चाहिए. इससे, अपलोड की गई स्क्रिप्ट की फ़ाइल, नए स्क्रिप्ट रिसॉर्स से जुड़ जाती है.
स्क्रिप्ट की फ़ाइल बनाने का तरीका यहां दिया गया है:
Python
# Create a custom bidding script object. script_obj = { 'script': custom-bidding-script-ref } # Create the custom bidding script. response = service.customBiddingAlgorithms().scripts().create( customBiddingAlgorithmId=custom-bidding-algorithm-id, advertiserId=advertiser-id, body=script_obj).execute() # Display the new custom bidding script object. print(f'The following custom bidding script was created: {response}')
कस्टम बिडिंग स्क्रिप्ट रिसॉर्स बनाने के बाद, Display &Video 360 स्क्रिप्ट को प्रोसेस करता है, ताकि यह पक्का किया जा सके कि इसका इस्तेमाल, इंप्रेशन की वैल्यू तय करने के लिए किया जा सकता है.
स्क्रिप्ट ऑब्जेक्ट के
state फ़ील्ड की मदद से, इस प्रोसेसिंग की स्थिति की जानकारी पाएं. नई स्क्रिप्ट स्वीकार किए जाने के बाद, कस्टम बिडिंग एल्गोरिदम, इंप्रेशन की वैल्यू तय करने के लिए स्क्रिप्ट का इस्तेमाल करना शुरू कर देता है. यह तुरंत होता है. इसलिए, स्क्रिप्ट का नया रिसॉर्स बनाने से पहले पक्का करें कि आपको एल्गोरिदम अपडेट करना है.
कस्टम बिडिंग का एल्गोरिदम असाइन करना
कस्टम बिडिंग का एल्गोरिदम बनाने, स्वीकार की गई स्क्रिप्ट अपलोड करने, और ज़रूरी शर्तें पूरी करने के बाद, कस्टम बिडिंग के एल्गोरिदम को लाइन आइटम या इंसर्शन ऑर्डर की बिडिंग की रणनीति के तौर पर असाइन किया जा सकता है.
ज़्यादा से ज़्यादा खर्च और परफ़ॉर्मेंस के लक्ष्य वाली बिड की रणनीतियों में, कस्टम बिडिंग के एल्गोरिदम का इस्तेमाल किया जा सकता है. इसके लिए,
performanceGoalType और
customBiddingAlgorithmId फ़ील्ड को क्रमशः BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO
और कस्टम बिडिंग एल्गोरिदम आईडी असाइन करें.
बिड की रणनीति के हिसाब से, बिड के अन्य पैरामीटर उपलब्ध हो सकते हैं या ज़रूरी हो सकते हैं.
यहां, किसी दिए गए कस्टम बिडिंग एल्गोरिदम के साथ, ज़्यादा से ज़्यादा खर्च वाली बिड की रणनीति का इस्तेमाल करने के लिए, लाइन आइटम को अपडेट करने का तरीका बताया गया है:
Python
# Create the new bid strategy object. bidding_strategy = { 'maximizeSpendAutoBid': { 'performanceGoalType': 'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO', 'customBiddingAlgorithmId': custom-bidding-algorithm-id } } # Create a line item object assigning the new bid strategy. line_item_obj = {'bidStrategy': bidding_strategy} # Update the line item with a new bid strategy. response = service.advertisers().lineItems().patch( advertiserId=advertiser-id, lineItemId=line-item-id, updateMask='bidStrategy', body=line_item_obj).execute() # Display the line item's new bid strategy print(f'Line Item {response["name"]} is now using the following bid' f' strategy: {response["bidStrategy"]}.')