REST Resource: customBiddingAlgorithms

উৎস: কাস্টমবিডিংঅ্যালগরিদম

একটি একক কাস্টম বিডিং অ্যালগরিদম।

JSON উপস্থাপনা 
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelDetails": [
    {
      object (CustomBiddingModelDetails)
    }
  ],
  "thirdPartyOptimizationPartner": enum (ThirdPartyOptimizationPartnerType),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "partnerId": string,
  "advertiserId": string
  // End of mutually exclusive fields.
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। কাস্টম বিডিং অ্যালগরিদমের রিসোর্স নাম।

customBiddingAlgorithmId

string ( int64 format)

শুধুমাত্র আউটপুট। কাস্টম বিডিং অ্যালগরিদমের অনন্য আইডি। সিস্টেম দ্বারা নির্ধারিত।

displayName

string

আবশ্যক। কাস্টম বিডিং অ্যালগরিদমের প্রদর্শিত নাম।

অবশ্যই UTF-8 এনকোড করা হতে হবে এবং এর সর্বোচ্চ আকার হবে ২৪০ বাইট।

entityStatus

enum ( EntityStatus )

কাস্টম বিডিং অ্যালগরিদমটি বিডিং কৌশল হিসেবে ব্যবহার করা যাবে কি না, তা নিয়ন্ত্রণ করে।

গ্রহণযোগ্য মানগুলো হলো:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum ( CustomBiddingAlgorithmType )

আবশ্যক। অপরিবর্তনীয়। কাস্টম বিডিং অ্যালগরিদমের ধরণ।

sharedAdvertiserIds[]

string ( int64 format)

যেসব বিজ্ঞাপনদাতার এই অ্যালগরিদমে প্রবেশাধিকার আছে, তাদের আইডি। যদি advertiserId সেট করা থাকে, তাহলে এই ফিল্ডটিতে শুধুমাত্র সেই মানটিই থাকবে।

যদি অ্যালগরিদমের owner একজন পার্টনার হন এবং তাকে কোনো অ্যাডভারটাইজার accessor ব্যবহার করে অ্যাক্সেস করা হয়, তাহলে এই ফিল্ডটি সেট করা হবে না।

modelDetails[]

object ( CustomBiddingModelDetails )

শুধুমাত্র আউটপুট। অ্যাক্সেস আছে এমন প্রত্যেক বিজ্ঞাপনদাতার জন্য কাস্টম বিডিং মডেলের বিবরণ।

এই ফিল্ডটিতে জিজ্ঞাসিত বিজ্ঞাপনদাতার বিবরণ শুধুমাত্র তখনই অন্তর্ভুক্ত করা যেতে পারে, যদি অ্যালগরিদমের owner একজন অংশীদার হন এবং একটি বিজ্ঞাপনদাতা accessor ব্যবহার করে তথ্যটি পুনরুদ্ধার করা হয়।

thirdPartyOptimizationPartner

enum ( ThirdPartyOptimizationPartnerType )

ঐচ্ছিক। অপরিবর্তনীয়। এই অ্যালগরিদমটি পরিচালনা করে এমন তৃতীয় পক্ষের অপ্টিমাইজেশন অংশীদারকে নির্দেশ করে।

কাস্টম বিডিং অ্যালগরিদমের মালিক DV360 সত্তাটিকে শনাক্ত করে। এটি একজন পার্টনার বা একজন বিজ্ঞাপনদাতা হতে পারে। নিম্নলিখিতটি হলো পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলির একটি তালিকা। একটি রেসপন্সে এই ফিল্ডগুলির মধ্যে সর্বাধিক একটি সেট করা থাকবে:
partnerId

string ( int64 format)

অপরিবর্তনীয়। কাস্টম বিডিং অ্যালগরিদমের মালিক অংশীদারের অনন্য আইডি।

advertiserId

string ( int64 format)

অপরিবর্তনীয়। কাস্টম বিডিং অ্যালগরিদমের মালিক বিজ্ঞাপনদাতার অনন্য আইডি।

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

কাস্টমবিডিংঅ্যালগরিদমটাইপ

কাস্টম বিডিং অ্যালগরিদমের সম্ভাব্য প্রকারভেদ।

এনাম
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED এই সংস্করণে অ্যালগরিদমের ধরণ নির্দিষ্ট করা নেই অথবা তা অজানা।
SCRIPT_BASED গ্রাহকের আপলোড করা কাস্টম বিডিং স্ক্রিপ্ট ফাইলের মাধ্যমে অ্যালগরিদমটি তৈরি করা হয়।
RULE_BASED

অ্যালগরিদমটি সংজ্ঞায়িত নিয়মের উপর ভিত্তি করে তৈরি। এই নিয়মগুলো API-তে AlgorithmRules অবজেক্ট ব্যবহার করে সংজ্ঞায়িত করা হয়।

এই অ্যালগরিদম প্রকারটি শুধুমাত্র অনুমোদিত গ্রাহকদের জন্য উপলব্ধ। অন্য গ্রাহকরা এই প্রকারটি ব্যবহার করার চেষ্টা করলে একটি ত্রুটি বার্তা পাবেন।

কাস্টমবিডিংমডেলের বিবরণ

একজন সাধারণ বিজ্ঞাপনদাতার জন্য একটি কাস্টম বিডিং অ্যালগরিদম মডেলের বিবরণ।

JSON উপস্থাপনা 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
ক্ষেত্র
advertiserId

string ( int64 format)

সংশ্লিষ্ট বিজ্ঞাপনদাতার অনন্য আইডি।

readinessState

enum ( ReadinessState )

কাস্টম বিডিং মডেলের প্রস্তুতি অবস্থা।

suspensionState

enum ( SuspensionState )

শুধুমাত্র আউটপুট। কাস্টম বিডিং মডেলের স্থগিত অবস্থা।

প্রস্তুতি অবস্থা

মডেলের প্রস্তুতির সম্ভাব্য অবস্থাগুলো।

এনাম
READINESS_STATE_UNSPECIFIED এই সংস্করণে অবস্থা নির্দিষ্ট করা নেই বা অজানা।
READINESS_STATE_ACTIVE মডেলটি প্রশিক্ষিত এবং পরিবেশনের জন্য প্রস্তুত।
READINESS_STATE_INSUFFICIENT_DATA সার্ভিং মডেলটিকে প্রশিক্ষণ দেওয়ার জন্য পর্যাপ্ত ডেটা নেই।
READINESS_STATE_TRAINING মডেলটি প্রশিক্ষণরত এবং পরিবেশনের জন্য প্রস্তুত নয়।
READINESS_STATE_NO_VALID_SCRIPT মডেলটিকে প্রশিক্ষণ দেওয়ার জন্য কোনো বৈধ কাস্টম বিডিং স্ক্রিপ্ট সরবরাহ করা হয়নি। এই অবস্থাটি শুধুমাত্র সেইসব অ্যালগরিদমের ক্ষেত্রে প্রযোজ্য হবে, যাদের customBiddingAlgorithmType হলো SCRIPT_BASED ।
READINESS_STATE_EVALUATION_FAILURE একটি বৈধ স্ক্রিপ্ট প্রদান করা হয়েছিল কিন্তু মূল্যায়নে ব্যর্থ হয়েছে। এটি সেইসব স্ক্রিপ্টের ক্ষেত্রে প্রযোজ্য যেগুলো নির্ধারিত সময়ের মধ্যে মূল্যায়ন করা যায়নি।

সাসপেনশনস্টেট

কাস্টম বিডিং মডেলের সম্ভাব্য স্থগিত অবস্থা।

এনাম
SUSPENSION_STATE_UNSPECIFIED এই সংস্করণে অবস্থা নির্দিষ্ট করা নেই বা অজানা।
SUSPENSION_STATE_ENABLED মডেলটি সক্রিয় আছে, যা সম্প্রতি ব্যবহৃত, বর্তমানে ব্যবহৃত অথবা ব্যবহারের জন্য নির্ধারিত। অ্যালগরিদমটি এই বিজ্ঞাপনদাতার জন্য ইম্প্রেশনগুলোকে সক্রিয়ভাবে স্কোর করছে।
SUSPENSION_STATE_DORMANT মডেলটি সম্প্রতি ব্যবহার করা হয়নি। যদিও মডেলটি এখনও সক্রিয় ENABLED অবস্থায় আছে, ব্যবহার না করা হলে এটি অবশেষে স্থগিত (suspended) হয়ে যাবে।
SUSPENSION_STATE_SUSPENDED মডেলটি ইম্প্রেশন স্কোর করা থেকে স্থগিত করা হয়েছে এবং পরিষেবা দিতে পারছে না। যদি অ্যালগরিদমটি এই বিজ্ঞাপনদাতার অধীনে কোনো লাইন আইটেমে বরাদ্দ করা হয় বা অন্য কোনোভাবে আপডেট করা হয়, তবে এটি আবার ENABLED অবস্থায় ফিরে যাবে এবং পরিষেবা দেওয়ার মডেলটি পুনরায় প্রস্তুত করতে সময় লাগবে।

থার্ডপার্টিঅপ্টিমাইজেশনপার্টনারটাইপ

সম্ভাব্য তৃতীয় পক্ষের অপ্টিমাইজেশন অংশীদারদের প্রকারভেদ।

এনাম
UNKNOWN এই সংস্করণে টাইপের মান নির্দিষ্ট করা নেই অথবা তা অজানা।
SCIBIDS তৃতীয় পক্ষের ডেটা সায়েন্স পরিষেবা প্রদানকারী, যার সাথে DV3 অংশীদার/বিজ্ঞাপনদাতারা অংশীদারিত্ব করতে পারেন।
ADELAIDE তৃতীয় পক্ষের মনোযোগ পরিমাপ পরিষেবা প্রদানকারী, যার সাথে DV3 অংশীদার/বিজ্ঞাপনদাতারা অংশীদারিত্ব করতে পারে।

পদ্ধতি

create

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

get

 একটি কাস্টম বিডিং অ্যালগরিদম পায়।

list

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

patch

 বিদ্যমান একটি কাস্টম বিডিং অ্যালগরিদম আপডেট করে।

uploadRules

 AlgorithmRules ফাইলের জন্য একটি রুলস রেফারেন্স অবজেক্ট তৈরি করে।

uploadScript

 একটি স্ক্রিপ্ট ফাইলের জন্য একটি কাস্টম বিডিং স্ক্রিপ্ট রেফারেন্স অবজেক্ট তৈরি করে।