REST Resource: customBiddingAlgorithms

সম্পদ: CustomBiddingAlgorithm

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

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

  // 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 ব্যবহার করে পুনরুদ্ধার করা হয়৷

modelReadiness[]

object ( CustomBiddingModelReadinessState )

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

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

customBiddingAlgorithmState

enum ( State )

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

ইউনিয়ন মাঠের 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-তে গোল নির্মাতার মাধ্যমে অ্যালগরিদম তৈরি করা হয়েছে।

CustomBiddingModelReadinessState

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

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

string ( int64 format)

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

readinessState

enum ( ReadinessState )

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

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

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

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

রাজ্য

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

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

পদ্ধতি

create

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

get

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

list

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

patch

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

uploadScript

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