- المورد: خوارزمية عروض الأسعار المخصّصة
- CustomBiddingAlgorithmType
- CustomBiddingModelReadinessState
- ReadinessState
- الولاية
- الطُرق
المرجع: خوارزمية عروض الأسعار المخصّصة
خوارزمية عروض أسعار مخصّصة واحدة
تمثيل JSON |
---|
{ "name": string, "customBiddingAlgorithmId": string, "displayName": string, "entityStatus": enum ( |
الحقول | |
---|---|
name |
النتائج فقط. اسم المورد لخوارزمية عروض الأسعار المخصّصة. |
customBiddingAlgorithmId |
النتائج فقط. رقم التعريف الفريد لخوارزمية عروض الأسعار المخصّصة. تم تعيينه من قِبل النظام. |
displayName |
مطلوبة. الاسم المعروض لخوارزمية عروض الأسعار المخصّصة. يجب ترميزها باستخدام UTF-8 بحيث يبلغ الحد الأقصى للحجم 240 بايت. |
entityStatus |
تتحكّم هذه السمة في ما إذا كان يمكن استخدام خوارزمية عروض الأسعار المخصّصة كاستراتيجية عروض أسعار. القيم المقبولة هي:
|
customBiddingAlgorithmType |
مطلوبة. غير قابل للتغيير. نوع خوارزمية عروض الأسعار المخصّصة. |
sharedAdvertiserIds[] |
أرقام تعريف المعلِنين الذين لديهم إذن بالوصول إلى هذه الخوارزمية. وإذا تم ضبط لن يتم ضبط هذا الحقل إذا كانت الخوارزمية |
modelReadiness[] |
النتائج فقط. حالة جاهزية نموذج عروض الأسعار المخصّصة لكل معلِن لديه الإذن بالوصول إليه قد يتضمّن هذا الحقل حالة المعلِن الذي تم طلب البحث عنه فقط إذا كانت الخوارزمية |
customBiddingAlgorithmState |
النتائج فقط. حالة خوارزمية عروض الأسعار المخصّصة. |
حقل الاتحاد owner يحدد كيان "مساحة العرض والفيديو 360" الذي يملك خوارزمية عروض الأسعار المخصّصة. ويمكن أن يكون إما شريكًا أو معلنًا. يمكن أن تكون السمة "owner " واحدة فقط مما يلي: |
|
partnerId |
غير قابل للتغيير. رقم التعريف الفريد للشريك الذي يملك خوارزمية عروض الأسعار المخصّصة. |
advertiserId |
غير قابل للتغيير. المعرّف الفريد للمعلِن الذي يملك خوارزمية عروض الأسعار المخصّصة. |
CustomBiddingAlgorithmType
الأنواع المحتملة من خوارزميات عروض الأسعار المخصّصة.
عمليات التعداد | |
---|---|
CUSTOM_BIDDING_ALGORITHM_TYPE_UNSPECIFIED |
نوع الخوارزمية غير محدد أو غير معروف في هذا الإصدار. |
SCRIPT_BASED |
الخوارزمية التي تم إنشاؤها من خلال ملفات النصوص البرمجية لعروض الأسعار المخصّصة التي يحمّلها العميل |
ADS_DATA_HUB_BASED |
خوارزمية تم إنشاؤها من خلال منتج Ads Data Hub |
GOAL_BUILDER_BASED |
خوارزمية تم إنشاؤها من خلال أداة إنشاء الأهداف في واجهة مستخدم "مساحة العرض والفيديو 360" |
CustomBiddingModelReadinessState
حالة جاهزية نموذج خوارزمية عروض الأسعار المخصّصة لمعلِن مشترك واحد.
تمثيل JSON |
---|
{
"advertiserId": string,
"readinessState": enum ( |
الحقول | |
---|---|
advertiserId |
المعرّف الفريد للمعلن المعني. |
readinessState |
حالة جاهزية نموذج عروض الأسعار المخصّصة |
ReadinessState
الحالات المحتملة لمدى جاهزية النموذج.
عمليات التعداد | |
---|---|
READINESS_STATE_UNSPECIFIED |
لم يتم تحديد الولاية أو أنها غير معروفة في هذا الإصدار. |
READINESS_STATE_ACTIVE |
تم تدريب النموذج وأصبح جاهزًا للعرض. |
READINESS_STATE_INSUFFICIENT_DATA |
لا تتوفّر بيانات كافية لتدريب نموذج العرض. |
READINESS_STATE_TRAINING |
النموذج قيد التدريب وغير جاهز للعرض. |
READINESS_STATE_NO_VALID_SCRIPT |
لم يتم توفير نص برمجي صالح لعروض الأسعار المخصّصة لتدريب النموذج. لن يتم تطبيق هذه الحالة إلا على الخوارزميات التي يكون الخاص بها SCRIPT_BASED . |
الحالة
الحالات المحتملة لخوارزميات عروض الأسعار المخصّصة.
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
لم يتم تحديد الولاية أو أنها غير معروفة في هذا الإصدار. |
ENABLED |
الخوارزمية مفعَّلة، سواء كانت مستخدَمة مؤخرًا أو مستخدَمة حاليًا أو تمت جدولتها لاستخدامها. الخوارزمية تسجّل مرات الظهور بفاعلية. |
DORMANT |
لم يتم استخدام الخوارزمية مؤخرًا. وعلى الرغم من أنّ الخوارزمية لا تزال تعمل باسم ENABLED ، سيتم تعليقها في النهاية في حال عدم استخدامها. |
SUSPENDED |
يتم استخدام الخوارزمية من تسجيل مرات الظهور ولا يتوفّر لها نموذج عرض مدرَّب. في حال تخصيص الخوارزمية لعنصر أو تعديلها بطريقة أخرى، سيتم التبديل مرة أخرى إلى حالة ENABLED وستتطلّب بعض الوقت لإعداد نموذج العرض مرّة أخرى. |
الطُرق |
|
---|---|
|
تُنشئ خوارزمية عروض أسعار مخصّصة جديدة. |
|
الحصول على خوارزمية عروض أسعار مخصّصة |
|
يسرد خوارزميات عروض الأسعار المخصّصة التي يمكن للمستخدِم الحالي الوصول إليها ويمكن استخدامها في استراتيجيات عروض الأسعار. |
|
تعديل خوارزمية حالية لعروض الأسعار المخصّصة |
|
تُنشئ كائنًا مرجعيًا لنص برمجي لعروض الأسعار مخصّصًا لملف نص برمجي. |