REST Resource: customBiddingAlgorithms

রিসোর্স: CustomBiddingAlgorithm

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

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)

পরিবর্তন করা যাবে না। কাস্টম বিডিং অ্যালগরিদমের মালিক বিজ্ঞাপনদাতার অনন্য আইডি।
মিউচুয়ালি এক্সক্লুসিভ ফিল্ডের শেষ।

CustomBiddingAlgorithmType

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

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

নির্দিষ্ট নিয়মের উপর ভিত্তি করে অ্যালগরিদম। এইসব নিয়ম API-তে AlgorithmRules অবজেক্ট ব্যবহার করে নির্ধারণ করা হয়।

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

CustomBiddingModelDetails

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

JSON উপস্থাপনা 
{
  "advertiserId": string,
  "readinessState": enum (ReadinessState),
  "suspensionState": enum (SuspensionState)
}
ফিল্ড
advertiserId

string (int64 format)

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

enum (ReadinessState)

কাস্টম বিডিং মডেলের প্রস্তুতি সংক্রান্ত স্ট্যাটাস।
suspensionState

enum (SuspensionState)

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

ReadinessState

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

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 সঠিক স্ক্রিপ্ট প্রদান করা হলেও মূল্যায়ন করা যায়নি। এটি সেইসব স্ক্রিপ্টের ক্ষেত্রে প্রযোজ্য যেগুলি বরাদ্দ সময়ের মধ্যে মূল্যায়ন করা যায়নি।

SuspensionState

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

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

ThirdPartyOptimizationPartnerType

সম্ভাব্য থার্ড-পার্টি অপ্টিমাইজেশন পার্টনারের ধরন।

Enums
UNKNOWN এই ভার্সনে টাইপ ভ্যালু উল্লেখ করা নেই বা অজানা।
SCIBIDS থার্ড-পার্টি ডেটা সায়েন্স পরিষেবা প্রদানকারী যার সাথে DV3 পার্টনার/বিজ্ঞাপনদাতারা পার্টনারশিপ করতে পারেন।
ADELAIDE থার্ড-পার্টি অ্যাটেনশন পরিমাপ পরিষেবা প্রদানকারী যার সাথে DV3 পার্টনার/বিজ্ঞাপনদাতারা পার্টনারশিপ করতে পারেন।

পদ্ধতি

create

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

get

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

list

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

patch

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

uploadRules

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

uploadScript

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