কাস্টম বিডিং বাস্তবায়ন করুন

আপনি কাস্টম বিডিং বাস্তবায়ন পরিচালনা করতে ডিসপ্লে ও ভিডিও ৩৬০ এপিআই ব্যবহার করতে পারেন। আপনি কাস্টম বিডিং অ্যালগরিদম তৈরি করতে, স্বতন্ত্র স্ক্রিপ্ট আপলোড ও যাচাই করতে এবং কোনো রিসোর্সের বিডিং কৌশল হিসেবে একটি নির্দিষ্ট অ্যালগরিদম নির্ধারণ করতে পারেন।

এই পৃষ্ঠায় Display & Video 360 API ব্যবহার করে কীভাবে কাস্টম বিডিং অ্যালগরিদম তৈরি, আপডেট এবং নির্ধারণ করতে হয়, তা বর্ণনা করা হয়েছে। প্রতিটি বিভাগে একটি কোড নমুনা দেওয়া আছে।

একটি কাস্টম বিডিং অ্যালগরিদম তৈরি করুন

একটি CustomBiddingAlgorithm অবজেক্ট একটি স্বতন্ত্র অ্যালগরিদমকে প্রতিনিধিত্ব করে, যা আপনি কোনো লাইন আইটেমের বিড স্ট্র্যাটেজিতে ব্যবহারের জন্য নির্ধারণ করতে পারেন। এই অবজেক্টটিতে অ্যালগরিদমটির customBiddingAlgorithmType , entityStatus এবং customBiddingAlgorithmState এর মতো বিবরণ থাকে। অ্যালগরিদমটির ব্যবহারের জন্য আপনি চাইল্ড রিসোর্স হিসেবে CustomBiddingScript অবজেক্ট তৈরি করতে পারেন।

স্ক্রিপ্ট-ভিত্তিক কাস্টম বিডিং অ্যালগরিদম তৈরি করার একটি উদাহরণ নিচে দেওয়া হলো:

পাইথন 

# 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 ফিল্ডের মাধ্যমে বিজ্ঞাপনদাতাদের অ্যাক্সেস দিন।

একটি স্ক্রিপ্ট আপলোড করুন

একবার আপনি একটি কাস্টম বিডিং অ্যালগরিদম তৈরি করে ফেললে, সেই অ্যালগরিদমটি ব্যবহারের জন্য একটি স্ক্রিপ্ট তৈরি করুন। স্ক্রিপ্ট-ভিত্তিক কাস্টম বিডিং অ্যালগরিদমগুলো একটি ইম্প্রেশনের মূল্য মূল্যায়ন করার জন্য ব্যবহারকারীর দেওয়া স্ক্রিপ্ট ব্যবহার করে। সহজ স্ক্রিপ্টের নমুনা এবং উন্নত ফিল্ডগুলোর একটি তালিকা ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ হেল্প সেন্টারের মাধ্যমে পাওয়া যায়।

নিম্নলিখিত বিভাগগুলিতে শেখানো হবে কীভাবে একটি কাস্টম বিডিং অ্যালগরিদমে নতুন বা আপডেট করা স্ক্রিপ্ট যুক্ত করতে হয়।

একটি স্ক্রিপ্ট রিসোর্স অবস্থান পুনরুদ্ধার করুন

প্রথমে, customBiddingAlgorithms.uploadScript মেথড ব্যবহার করে কাস্টম বিডিং অ্যালগরিদম রিসোর্সের অধীনে একটি উপলব্ধ রিসোর্স লোকেশন পুনরুদ্ধার করুন। এই অনুরোধটি একটি রিসোর্স নাম সহ একটি CustomBiddingScriptRef অবজেক্ট রিটার্ন করে। আপনি রিসোর্স নামটি দ্বারা নির্ধারিত লোকেশনে আপনার স্ক্রিপ্ট ফাইলটি আপলোড করতে পারেন। তারপর, আপনার স্ক্রিপ্ট রিসোর্স তৈরি করতে কাস্টম বিডিং স্ক্রিপ্ট রেফারেন্স অবজেক্টটি ব্যবহার করুন।

একটি উপলব্ধ রিসোর্স লোকেশন পুনরুদ্ধার করার একটি উদাহরণ এখানে দেওয়া হলো:

পাইথন 

# 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}')

একটি স্ক্রিপ্ট ফাইল আপলোড করুন

একটি উপলব্ধ রিসোর্স লোকেশন খুঁজে পাওয়ার পর, media.upload মেথড ব্যবহার করে Display & Video 360 সিস্টেমের সেই লোকেশনে আপনার স্ক্রিপ্ট ফাইলটি আপলোড করুন। এই মেথডটি একটি সাধারণ আপলোড সমর্থন করে, যার জন্য uploadType=media কোয়েরি প্যারামিটারটি প্রয়োজন।

প্রাপ্ত কাস্টম বিডিং স্ক্রিপ্ট রেফারেন্স অবজেক্ট ব্যবহার করে কীভাবে একটি স্ক্রিপ্ট ফাইল আপলোড করতে হয়, তার একটি উদাহরণ নিচে দেওয়া হলো:

পাইথন 

# 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 অবজেক্টটি অন্তর্ভুক্ত থাকতে হবে। এর মাধ্যমে আপলোড করা স্ক্রিপ্ট ফাইলটি নতুন স্ক্রিপ্ট রিসোর্সটির সাথে যুক্ত হয়ে যায়।

স্ক্রিপ্ট ফাইল তৈরি করার একটি উদাহরণ নিচে দেওয়া হলো:

পাইথন 

# 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 এবং কাস্টম বিডিং অ্যালগরিদম আইডি নির্ধারণ করে `maximize spend` এবং `performance goal` বিড স্ট্র্যাটেজিতে কাস্টম বিডিং অ্যালগরিদম ব্যবহার করতে পারেন। বিড স্ট্র্যাটেজির উপর নির্ভর করে, অন্যান্য বিড প্যারামিটার উপলব্ধ বা প্রয়োজনীয় হতে পারে।

একটি প্রদত্ত কাস্টম বিডিং অ্যালগরিদম ব্যবহার করে 'সর্বাধিক ব্যয়' বিড কৌশল প্রয়োগের জন্য কীভাবে একটি লাইন আইটেম আপডেট করতে হয়, তার একটি উদাহরণ এখানে দেওয়া হলো:

পাইথন 

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