تنفيذ عروض الأسعار المخصصة

يمكنك استخدام شاشة العرض Video 360 API لإدارة عروض الأسعار المخصّصة وعمليات التنفيذ. يمكنك إنشاء خوارزميات عروض أسعار مخصّصة وتحميلها والتحقّق من صحتها. نصوص برمجية فردية، وتعيين خوارزمية محددة لمورد ما لتعرض له الاستراتيجية.

توضّح هذه الصفحة كيفية إنشاء خوارزميات عروض أسعار مخصّصة وتعديلها وتخصيصها. مع الشاشة Video 360 API: يوفر كل قسم عيّنة من التعليمات البرمجية.

إنشاء خوارزمية عروض أسعار مخصّصة

يمثّل الكائن CustomBiddingAlgorithm فردًا. التي يمكنك تخصيصها لعنصر لاستخدامه في استراتيجية عروض أسعاره. هذا النمط يحتوي على تفاصيل عن الخوارزمية مثل customBiddingAlgorithmType، entityStatus و customBiddingAlgorithmState يمكنك إنشاء عناصر CustomBiddingScript كموارد فرعية للخوارزمية للاستخدام.

في ما يلي مثال على كيفية إنشاء عروض أسعار مخصّصة مستندة إلى النص البرمجي الخوارزمية:

Python

# Create a custom bidding algorithm object.
custom_bidding_algorithm_obj = {
    'advertiserId': advertiser-id,
    'displayName': display-name,
    'entityStatus': 'ENTITY_STATUS_ACTIVE',
    'customBiddingAlgorithmType': 'SCRIPT_BASED'
}

# Create the custom bidding algorithm.
response = service.customBiddingAlgorithms().create(
    body=algorithm_obj
).execute()

# Display the new custom bidding algorithm.
print(f'The following Custom Bidding Algorithm was created: {response}')

إدارة الوصول إلى الخوارزمية

يمكن أن تكون خوارزميات عروض الأسعار المخصّصة تابعة لشريك أو معلِن. الخوارزميات يمكن لهذا الشريك أو أي طفل الوصول إليها وتعديلها المعلنين المدرجين في الحقل sharedAdvertiserIds. يمكن الوصول إلى الخوارزميات التي يملكها معلِن وتعديلها من خلال ذلك المعلن وشريكه الرئيسي، ولكن لا يمكن مشاركته مع المعلنين الآخرين.

إذا كنت تستخدم الخوارزمية لمعلِن واحد فقط، حدِّد المعلِن كمالك في الحقل advertiserId. وبخلاف ذلك، يجب تعيين الشريك الرئيسي للمعلنين بصفته المالك partnerId، وامنح المعلنين حق الوصول من خلال sharedAdvertiserIds.

تحميل نص برمجي

بعد إنشاء خوارزمية عروض أسعار مخصّصة، أنشئ نصًا برمجيًا لذلك. التي يجب استخدامها. خوارزميات عروض الأسعار المخصّصة المستندة إلى النصوص البرمجية تستخدم الإعلانات المقدَّمة من المستخدم النصوص لتقييم قيمة مرة الظهور. نماذج من النصوص البرمجية البسيطة وقائمة من الحقول المتقدمة متوفرة من خلال الشبكة الإعلانية مركز مساعدة "فيديو 360"

توضّح الأقسام التالية كيفية إضافة نص برمجي جديد أو معدَّل إلى نص برمجي مخصّص. خوارزمية عروض الأسعار.

استرداد موقع مورد النص البرمجي

أولاً، استرداد موقع موارد متوفر ضمن عروض الأسعار المخصّصة مورد الخوارزمية مع customBiddingAlgorithms.uploadScript. هذا النمط يعرض الطلب عنصر CustomBiddingScriptRef مع اسم المورد. يمكنك حمِّل ملف النص البرمجي إلى الموقع الذي تفرضه اسم المورد. بعد ذلك، استخدِم الكائن المرجعي للنص البرمجي لعرض الأسعار المخصّص إنشاء مورد النص البرمجي

في ما يلي مثال على كيفية استرداد أحد الموارد المتاحة الموقع:

Python

# Retrieve a usable custom bidding script reference
# object.
custom_bidding_script_ref = service.customBiddingAlgorithms().uploadScript(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id
).execute()

# Display the new custom bidding script reference object.
print('The following custom bidding script reference object was retrieved:'
      f'{custom_bidding_script_ref}')

تحميل ملف نص برمجي

بعد استرداد موقع مورد متاح، حمّل ملف النص البرمجي إليه الموقع الجغرافي في الشاشة نظام فيديو 360 مع media.upload. تدعم هذه الطريقة عملية تحميل بسيطة تتطلّب استخدام مَعلمة طلب البحث uploadType=media

إليك مثال على كيفية تحميل ملف نص برمجي عنصر مرجعي للنص البرمجي لعروض الأسعار المخصّصة:

Python

# Create a media upload object.
media = MediaFileUpload(script-path)

# Create upload request.
upload_request = service.media().upload(
    resourceName=resource-name, media_body=media)

# Override response handler to expect null response.
upload_request.postproc = HttpRequest.null_postproc

# Upload script to resource location given in retrieved custom bidding
# script reference object.
upload_request.execute()

إنشاء كائن نص برمجي

بعد تحميل ملف النص البرمجي، أنشئ موردًا نصيًا مخصّصًا لعروض الأسعار يستند إلى الطريقة customBiddingAlgorithms.scripts.create. تشير رسالة الأشكال البيانية يجب تمرير عنصر CustomBiddingScript في الطلب فقط تضمين الكائن CustomBiddingScriptRef على أنّه العنصر المخصّص للحقل script. يؤدي هذا إلى ربط الملف الذي تم تحميله ملف البرنامج النصي مع مورد البرنامج النصي الجديد.

إليك مثال على كيفية إنشاء ملف نص برمجي:

Python

# Create a custom bidding script object.
script_obj = {
    'script': custom-bidding-script-ref
}

# Create the custom bidding script.
response = service.customBiddingAlgorithms().scripts().create(
    customBiddingAlgorithmId=custom-bidding-algorithm-id,
    advertiserId=advertiser-id,
    body=script_obj).execute()

# Display the new custom bidding script object.
print(f'The following custom bidding script was created: {response}')

بعد إنشاء مورد نص برمجي مخصّص لعروض الأسعار، ستظهر لك يعالج "فيديو 360" البرنامج النصي للتأكد من إمكانية استخدامه بنجاح لتسجيل مرات الظهور. استرداد حالة هذه المعالجة من خلال كائن النص البرمجي state. بعد قبول النص البرمجي الجديد، سيتم حساب تبدأ خوارزمية عروض الأسعار في استخدام النص البرمجي لتسجيل قيم مرّات الظهور. هذا النمط يحدث على الفور، لذا تأكد من أنك تريد تحديث الخوارزمية قبل إنشاء مورد نص برمجي جديد.

تعيين خوارزمية عروض أسعار مخصّصة

بعد إنشاء خوارزمية عروض أسعار مخصّصة، حمِّل نصًا برمجيًا مقبولاً وحقِّق المتطلبات اللازمة، يمكنك تعيين خوارزمية عروض الأسعار إلى استراتيجية عروض الأسعار لعنصر أو طلب إدراج.

يمكنك استخدام خوارزميات عروض الأسعار المخصّصة زيادة الإنفاق استراتيجيات عروض أسعار هدف الأداء من خلال تحديد BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO ورقم تعريف خوارزمية عروض الأسعار المخصّصة performanceGoalType و customBiddingAlgorithmId، على التوالي. اعتمادًا على استراتيجية عروض الأسعار، قد تتوفّر مَعلمات عروض أسعار أخرى أو مطلوبة.

في ما يلي مثال على كيفية تعديل تفاصيل الإعلان لاستخدام طريقة زيادة استراتيجية عروض أسعار للإنفاق باستخدام خوارزمية عروض أسعار مخصّصة معيّنة:

Python

# Create the new bid strategy object.
bidding_strategy = {
    'maximizeSpendAutoBid': {
        'performanceGoalType':
            'BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO',
        'customBiddingAlgorithmId': custom-bidding-algorithm-id
    }
}

# Create a line item object assigning the new bid strategy.
line_item_obj = {'bidStrategy': bidding_strategy}

# Update the line item with a new bid strategy.
response = service.advertisers().lineItems().patch(
    advertiserId=advertiser-id,
    lineItemId=line-item-id,
    updateMask='bidStrategy',
    body=line_item_obj).execute()

# Display the line item's new bid strategy
print(f'Line Item {response["name"]} is now using the following bid'
     f' strategy: {response["bidStrategy"]}.')