اجرای مناقصه سفارشی

می‌توانید از Display & Video 360 API برای مدیریت پیاده‌سازی‌های سفارشی پیشنهاد استفاده کنید. می‌توانید الگوریتم‌های پیشنهادی سفارشی ایجاد کنید، اسکریپت‌های فردی را آپلود و تأیید کنید، و الگوریتم خاصی را به عنوان استراتژی مناقصه به یک منبع اختصاص دهید.

این صفحه نحوه ایجاد، به‌روزرسانی و اختصاص الگوریتم‌های مناقصه سفارشی با Display & Video 360 API را شرح می‌دهد. هر بخش یک نمونه کد ارائه می دهد.

یک الگوریتم مناقصه سفارشی ایجاد کنید

یک شیء CustomBiddingAlgorithm نشان دهنده یک الگوریتم جداگانه است که می توانید به یک آیتم خطی برای استفاده در استراتژی پیشنهاد آن اختصاص دهید. این شی دارای جزئیاتی در مورد الگوریتم است، مانند customBiddingAlgorithmType ، entityStatus و customBiddingAlgorithmState . شما می توانید اشیاء CustomBiddingScript را به عنوان منابع فرزند برای الگوریتم ایجاد کنید.

در اینجا مثالی از نحوه ایجاد یک الگوریتم پیشنهادی سفارشی مبتنی بر اسکریپت آورده شده است:

پایتون 

# 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 را بدهید.

یک اسکریپت آپلود کنید

هنگامی که یک الگوریتم پیشنهادی سفارشی ایجاد کردید، یک اسکریپت برای استفاده از آن الگوریتم ایجاد کنید. الگوریتم‌های پیشنهادی سفارشی مبتنی بر اسکریپت از اسکریپت‌های ارائه‌شده توسط کاربر برای ارزیابی ارزش یک نمایش استفاده می‌کنند. نمونه‌هایی از اسکریپت‌های ساده و فهرستی از فیلدهای پیشرفته از طریق مرکز راهنمای Display & Video 360 در دسترس هستند.

بخش های زیر به شما آموزش می دهند که چگونه یک اسکریپت جدید یا به روز شده را به یک الگوریتم پیشنهاد قیمت سفارشی اضافه کنید.

یک مکان منبع اسکریپت را بازیابی کنید

ابتدا، با روش customBiddingAlgorithms.uploadScript ، یک مکان منبع موجود را تحت منبع الگوریتم پیشنهاد سفارشی بازیابی کنید. این درخواست یک شی CustomBiddingScriptRef را با نام منبع برمی گرداند. شما می توانید فایل اسکریپت خود را در مکانی که با نام منبع دیکته شده است آپلود کنید . سپس از شی مرجع اسکریپت پیشنهادی سفارشی برای ایجاد منبع اسکریپت خود استفاده کنید.

در اینجا مثالی از نحوه بازیابی مکان منبع موجود آورده شده است:

پایتون 

# 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}')

یک فایل اسکریپت را آپلود کنید

پس از بازیابی یک مکان منبع موجود، فایل اسکریپت خود را در آن مکان در سیستم Display & Video 360 با روش media.upload آپلود کنید. این روش از یک آپلود ساده که به پارامتر پرس و جو نیاز دارد uploadType=media پشتیبانی می کند.

در اینجا مثالی از نحوه آپلود یک فایل اسکریپت با توجه به یک شی مرجع اسکریپت پیشنهادی سفارشی بازیابی شده آورده شده است:

پایتون 

# 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 شامل شود. این فایل اسکریپت آپلود شده را با منبع اسکریپت جدید مرتبط می کند.

در اینجا مثالی از نحوه ایجاد یک فایل اسکریپت آورده شده است:

پایتون 

# 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}')

هنگامی که یک منبع اسکریپت مناقصه سفارشی ایجاد کردید، Display & Video 360 اسکریپت را پردازش می‌کند تا مطمئن شود که می‌تواند با موفقیت برای امتیاز دادن به نمایش‌ها استفاده شود. وضعیت این پردازش را از طریق فیلد state شی اسکریپت بازیابی کنید. هنگامی که اسکریپت جدید پذیرفته شد، الگوریتم مناقصه سفارشی شروع به استفاده از اسکریپت برای امتیاز دادن به مقادیر نمایش می کند. این بلافاصله اتفاق می افتد، بنابراین مطمئن شوید که می خواهید الگوریتم را قبل از ایجاد یک منبع اسکریپت جدید به روز کنید.

یک الگوریتم مناقصه سفارشی اختصاص دهید

پس از ایجاد یک الگوریتم مناقصه سفارشی، آپلود یک اسکریپت پذیرفته شده، و برآوردن شرایط لازم ، می توانید الگوریتم پیشنهاد قیمت سفارشی خود را به استراتژی پیشنهاد قیمت یک آیتم خطی یا سفارش درج اختصاص دهید.

می‌توانید با اختصاص دادن BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO و شناسه الگوریتم پیشنهاد سفارشی به ترتیب به فیلدهای performanceGoalType و customBiddingAlgorithmId ، از الگوریتم‌های مناقصه سفارشی برای به حداکثر رساندن هزینه‌ها و استراتژی‌های پیشنهاد عملکرد هدف استفاده کنید. بسته به استراتژی پیشنهاد، سایر پارامترهای پیشنهادی ممکن است در دسترس یا مورد نیاز باشند.

در اینجا نمونه‌ای از نحوه به‌روزرسانی یک آیتم خط برای استفاده از استراتژی پیشنهاد حداکثر هزینه با یک الگوریتم پیشنهادی سفارشی ارائه شده است:

پایتون 

# 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"]}.')