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

কাস্টম বিডিং বাস্তবায়ন পরিচালনা করতে আপনি Display & Video 360 API ব্যবহার করতে পারেন। আপনি কাস্টম বিডিং অ্যালগরিদম তৈরি করতে পারেন, স্বতন্ত্র স্ক্রিপ্ট আপলোড এবং যাচাই করতে পারেন, এবং বিডিং কৌশল হিসাবে একটি সংস্থানে একটি নির্দিষ্ট অ্যালগরিদম বরাদ্দ করতে পারেন৷

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 আইডি ফিল্ডের সাথে অ্যাক্সেস দিন।

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

একবার আপনি একটি কাস্টম বিডিং অ্যালগরিদম তৈরি করলে, সেই অ্যালগরিদম ব্যবহারের জন্য একটি স্ক্রিপ্ট তৈরি করুন৷ স্ক্রিপ্ট-ভিত্তিক কাস্টম বিডিং অ্যালগরিদমগুলি একটি ইম্প্রেশনের মূল্য মূল্যায়ন করার জন্য ব্যবহারকারী-প্রদত্ত স্ক্রিপ্টগুলি নিয়োগ করে৷ সরল স্ক্রিপ্টের নমুনা এবং উন্নত ক্ষেত্রগুলির একটি তালিকা Display & Video 360 সহায়তা কেন্দ্রের মাধ্যমে উপলব্ধ।

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

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

প্রথমে, 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 অবজেক্টে শুধুমাত্র CustomBiddingScriptRef অবজেক্টকে script ক্ষেত্রের নির্ধারিত মান হিসেবে অন্তর্ভুক্ত করা উচিত। এটি আপলোড করা স্ক্রিপ্ট ফাইলটিকে নতুন স্ক্রিপ্ট সম্পদের সাথে সংযুক্ত করে।

এখানে একটি স্ক্রিপ্ট ফাইল কিভাবে তৈরি করতে হয় তার একটি উদাহরণ:

পাইথন 

# 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 এবং কাস্টম বিডিং অ্যালগরিদম আইডি বরাদ্দ করে ব্যয় এবং কর্মক্ষমতা লক্ষ্য বিড কৌশলগুলিকে সর্বাধিক করার জন্য কাস্টম বিডিং অ্যালগরিদমগুলি ব্যবহার করতে পারেন৷ বিড কৌশলের উপর নির্ভর করে, অন্যান্য বিড প্যারামিটার উপলব্ধ বা প্রয়োজন হতে পারে।

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

পাইথন 

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