मैन्युअल तरीके से बोली लगाना

आप Display &Video 360 के ज़रिए कस्टम बिडिंग को मैनेज करने के लिए Video 360 API लागू करना. कस्टम बिडिंग के एल्गोरिदम बनाए जा सकते हैं, उन्हें अपलोड किया जा सकता है, और उनकी पुष्टि की जा सकती है अलग-अलग स्क्रिप्ट बना सकता है और किसी संसाधन को उसकी बिडिंग के तौर पर एक खास एल्गोरिदम असाइन कर सकता है रणनीति.

इस पेज पर, कस्टम बिडिंग के लिए एल्गोरिदम बनाने, अपडेट करने, और असाइन करने का तरीका बताया गया है डिसप्ले और Video 360 API. हर सेक्शन में एक कोड सैंपल दिया गया है.

कस्टम बिडिंग का एल्गोरिदम बनाना

CustomBiddingAlgorithm ऑब्जेक्ट, किसी व्यक्ति की जानकारी देता है इस एल्गोरिदम को बिडिंग की रणनीति में इस्तेमाल करने के लिए, किसी लाइन आइटम को असाइन किया जा सकता है. यह ऑब्जेक्ट के एल्गोरिदम पर जानकारी होती है, जैसे कि customBiddingAlgorithmType entityStatus और customBiddingAlgorithmState. आप बना सकते हैं एल्गोरिदम के लिए, चाइल्ड रिसॉर्स के तौर पर CustomBiddingScript ऑब्जेक्ट इस्तेमाल करें.

ध्यान दें: यह गाइड, स्क्रिप्ट-आधारित कस्टम बिडिंग एल्गोरिदम पर फ़ोकस करती है. एल्गोरिदम को Display & Video 360 के ज़रिए या फिर Display & Video 360 के ज़रिए बनाया गया Video 360 यूज़र इंटरफ़ेस (यूआई) लक्ष्य बिल्डर टूल ये काम कर सकता है फिर से हासिल और असाइन किया जाना चाहिए, लेकिन पूरी तरह से मैनेज नहीं किया जाता.

स्क्रिप्ट-आधारित कस्टम बिडिंग बनाने के तरीके का एक उदाहरण यहां दिया गया है एल्गोरिदम:

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 फ़ील्ड.

स्क्रिप्ट अपलोड करें

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

चेतावनी: कस्टम बिडिंग स्क्रिप्ट की फ़ाइल का साइज़ 7 एमबी से ज़्यादा नहीं होना चाहिए.

यहां स्क्रिप्ट फ़ाइल को अपलोड करने का एक उदाहरण दिया गया है. कस्टम बिडिंग स्क्रिप्ट रेफ़रंस ऑब्जेक्ट वापस मिला:

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 ऑब्जेक्ट सिर्फ़ असाइन किए गए के तौर पर CustomBiddingScriptRef ऑब्जेक्ट को शामिल करें script फ़ील्ड की वैल्यू डालें. इससे, अपलोड की गई फ़ाइल को जोड़ा जाता है नए स्क्रिप्ट संसाधन वाली स्क्रिप्ट फ़ाइल.

चेतावनी: अगर आपकी अपलोड की गई स्क्रिप्ट फ़ाइल में सिंटैक्स की कोई गड़बड़ी है, तो customBiddingAlgorithms.scripts.create अनुरोध पूरा नहीं हो पाएगा और सिंटैक्स में गड़बड़ी की जानकारी दें. पहले से तय स्क्रिप्ट फ़ाइल अपलोड करने के लिए, को यह प्रोसेस इतनी देर पहले शुरू करनी होगी स्क्रिप्ट पर संसाधन की नई जगह पाना.

यहां स्क्रिप्ट फ़ाइल बनाने का एक उदाहरण दिया गया है:

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 फ़ील्ड. नई स्क्रिप्ट स्वीकार होने के बाद, कस्टम बिडिंग एल्गोरिदम, इंप्रेशन वैल्यू इकट्ठा करने के लिए स्क्रिप्ट का इस्तेमाल करना शुरू करता है. यह की प्रक्रिया तुरंत हो जाती है, इसलिए आप इस प्रक्रिया से पहले एल्गोरिदम को अपडेट करना न भूलें कोई नया स्क्रिप्ट संसाधन बनाकर.

कस्टम बिडिंग का एल्गोरिदम असाइन करना

कस्टम बिडिंग वाला एल्गोरिदम बनाने के बाद, स्वीकार की जाने वाली स्क्रिप्ट अपलोड करें और ज़रूरी शर्तों को पूरा करना होगा, तो आप अपने कस्टम किसी लाइन आइटम या इंसर्शन ऑर्डर की बिडिंग की रणनीति के लिए बिडिंग एल्गोरिदम.

कस्टम बिडिंग वाले एल्गोरिदम का इस्तेमाल इन कामों में किया जा सकता है खर्च को बढ़ाएं और BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO असाइन करके, परफ़ॉर्मेंस लक्ष्य बिडिंग की रणनीतियां और कस्टम बिडिंग एल्गोरिदम आईडी को performanceGoalType और customBiddingAlgorithmId फ़ील्ड. बिडिंग की रणनीति के आधार पर, अन्य बिड पैरामीटर उपलब्ध हो सकते हैं या आवश्यक.

यहां उदाहरण के तौर पर, किसी लाइन आइटम को अपडेट करने के लिए, उसे बड़े करने की सुविधा का इस्तेमाल करने का तरीका बताया गया है बिडिंग की रणनीति को, दिए गए कस्टम बिडिंग एल्गोरिदम की मदद से खर्च करना:

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"]}.')