REST Resource: customBiddingAlgorithms

সম্পদ: CustomBiddingAlgorithm

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

JSON প্রতিনিধিত্ব
{
  "name": string,
  "customBiddingAlgorithmId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "customBiddingAlgorithmType": enum (CustomBiddingAlgorithmType),
  "sharedAdvertiserIds": [
    string
  ],
  "modelDetails": [
    {
      object (CustomBiddingModelDetails)
    }
  ],

  // Union field owner can be only one of the following:
  "partnerId": string,
  "advertiserId": string
  // End of list of possible types for union field owner.
}
ক্ষেত্র
name

string

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

customBiddingAlgorithmId

string ( int64 format)

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

displayName

string

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

UTF-8 সর্বাধিক 240 বাইটের আকারের সাথে এনকোড করা আবশ্যক৷

entityStatus

enum ( EntityStatus )

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

গৃহীত মান হল:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
customBiddingAlgorithmType

enum ( CustomBiddingAlgorithmType )

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

sharedAdvertiserIds[]

string ( int64 format)

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

এই ক্ষেত্রটি সেট করা হবে না যদি অ্যালগরিদমের owner একজন অংশীদার হয় এবং একটি বিজ্ঞাপনদাতা accessor ব্যবহার করে পুনরুদ্ধার করা হয়৷

modelDetails[]

object ( CustomBiddingModelDetails )

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

এই ক্ষেত্রটি শুধুমাত্র জিজ্ঞাসা করা বিজ্ঞাপনদাতার বিশদ অন্তর্ভুক্ত করতে পারে যদি অ্যালগরিদমের owner একজন অংশীদার হয় এবং একটি বিজ্ঞাপনদাতা accessor ব্যবহার করে পুনরুদ্ধার করা হয়৷

ইউনিয়ন মাঠের owner . কাস্টম বিডিং অ্যালগরিদমের মালিক DV360 সত্তাকে শনাক্ত করে৷ এটি একটি অংশীদার বা একটি বিজ্ঞাপনদাতা হতে পারে. owner নিম্নলিখিতগুলির মধ্যে একজন হতে পারে:
partnerId

string ( int64 format)

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

advertiserId

string ( int64 format)

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

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

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

Enums
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED এই সংস্করণে অ্যালগরিদমের ধরন নির্দিষ্ট করা নেই বা অজানা।
SCRIPT_BASED গ্রাহক-আপলোড করা কাস্টম বিডিং স্ক্রিপ্ট ফাইলের মাধ্যমে অ্যালগরিদম তৈরি করা হয়েছে।
ADS_DATA_HUB_BASED Ads Data Hub পণ্যের মাধ্যমে তৈরি অ্যালগরিদম।
GOAL_BUILDER_BASED DV3 UI-তে গোল নির্মাতার মাধ্যমে অ্যালগরিদম তৈরি করা হয়েছে।
RULE_BASED

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

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

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

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

JSON প্রতিনিধিত্ব
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
ক্ষেত্র
advertiserId

string ( int64 format)

প্রাসঙ্গিক বিজ্ঞাপনদাতার অনন্য আইডি।

readinessState

enum ( ReadinessState )

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

suspensionState

enum ( SuspensionState )

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

রেডিনেস স্টেট

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

Enums
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 একটি বৈধ স্ক্রিপ্ট প্রদান করা হয়েছে কিন্তু মূল্যায়ন ব্যর্থ হয়েছে. এটি সেই স্ক্রিপ্টগুলির জন্য প্রযোজ্য যা বরাদ্দকৃত সময়ে মূল্যায়ন করা যায়নি।

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

কাস্টম বিডিং মডেলের সম্ভাব্য সাসপেনশন স্টেট।

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

পদ্ধতি

create

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

get

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

list

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

patch

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

uploadRules

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

uploadScript

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