Triển khai chiến lược Đặt giá thầu tuỳ chỉnh

Bạn có thể sử dụng thành phần Display & Video 360 API để quản lý chiến lược đặt giá thầu tuỳ chỉnh thực tế. Bạn có thể tạo thuật toán đặt giá thầu tuỳ chỉnh, tải lên và xác minh các tập lệnh riêng lẻ và chỉ định một thuật toán cụ thể cho một tài nguyên làm tài nguyên đặt giá thầu chiến lược.

Trang này mô tả cách tạo, cập nhật và chỉ định các thuật toán đặt giá thầu tuỳ chỉnh với giải pháp Display & API Video 360. Mỗi phần sẽ cung cấp một mã mẫu.

Tạo thuật toán đặt giá thầu tuỳ chỉnh

Đối tượng CustomBiddingAlgorithm đại diện cho một cá nhân mà bạn có thể chỉ định cho một mục hàng để sử dụng trong chiến lược giá thầu của mục hàng đó. Chiến dịch này Có thông tin chi tiết về thuật toán, chẳng hạn như customBiddingAlgorithmType! entityStatus và customBiddingAlgorithmState. Bạn có thể tạo Các đối tượng CustomBiddingScript dưới dạng tài nguyên con cho thuật toán để sử dụng.

Dưới đây là ví dụ về cách tạo chiến lược đặt giá thầu tuỳ chỉnh dựa trên tập lệnh thuật toán:

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

Quản lý quyền truy cập vào thuật toán

Các thuật toán đặt giá thầu tuỳ chỉnh có thể do đối tác hoặc nhà quảng cáo sở hữu. Các thuật toán thuộc sở hữu của đối tác đều có thể truy cập và sửa đổi mà đối tác đó cũng như bất kỳ trẻ em nào nhà quảng cáo có tên trong trường sharedAdvertiserIds. Nhà quảng cáo có thể truy cập và sửa đổi các thuật toán do nhà quảng cáo sở hữu nhà quảng cáo và đối tác mẹ của nhà quảng cáo đó, nhưng không thể chia sẻ với các nhà quảng cáo khác.

Nếu bạn chỉ sử dụng thuật toán cho một nhà quảng cáo, hãy chỉ định nhà quảng cáo làm chủ sở hữu với trường advertiserId. Nếu không, hãy chỉ định đối tác mẹ của nhà quảng cáo làm chủ sở hữu với partnerId rồi cấp cho nhà quảng cáo quyền truy cập vào sharedAdvertiserIds.

Tải tập lệnh lên

Sau khi bạn tạo thuật toán đặt giá thầu tùy chỉnh, hãy tạo tập lệnh cho thuật toán đó để sử dụng. Các thuật toán đặt giá thầu tuỳ chỉnh dựa trên tập lệnh sử dụng nội dung do người dùng cung cấp tập lệnh để đánh giá giá trị của một lượt hiển thị. Mẫu của các tập lệnh đơn giản và danh sách trường nâng cao có sẵn thông qua Hiển thị và Trung tâm trợ giúp Video 360.

Các phần sau đây hướng dẫn bạn cách thêm tập lệnh mới hoặc đã cập nhật vào một tập lệnh tuỳ chỉnh thuật toán đặt giá thầu.

Truy xuất vị trí tài nguyên tập lệnh

Trước tiên, hãy truy xuất vị trí tài nguyên có sẵn trong chiến lược đặt giá thầu tuỳ chỉnh thông qua thuật toán Phương thức customBiddingAlgorithms.uploadScript. Chiến dịch này yêu cầu trả về một đối tượng CustomBiddingScriptRef có tên tài nguyên. Bạn có thể tải tệp tập lệnh của bạn lên vị trí do lệnh tên tài nguyên. Sau đó, hãy sử dụng đối tượng tham chiếu tập lệnh đặt giá thầu tuỳ chỉnh để tạo tài nguyên tập lệnh.

Sau đây là ví dụ về cách truy xuất một tài nguyên có sẵn vị trí:

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

Tải một tệp tập lệnh lên

Sau khi truy xuất vị trí tài nguyên có sẵn, hãy tải tệp tập lệnh của bạn lên vị trí đó vị trí trong quảng cáo Hiển thị Hệ thống Video 360 với Phương thức media.upload. Phương thức này hỗ trợ một tải lên đơn giản yêu cầu tham số truy vấn uploadType=media.

Dưới đây là ví dụ về cách tải lên tệp tập lệnh cho trước đã truy xuất đối tượng tham chiếu tập lệnh đặt giá thầu tuỳ chỉnh:

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()

Tạo đối tượng tập lệnh

Sau khi tải tệp tập lệnh lên, hãy tạo một tài nguyên tập lệnh đặt giá thầu tuỳ chỉnh bằng phương thức customBiddingAlgorithms.scripts.create. Chiến lược phát hành đĩa đơn Đối tượng CustomBiddingScript được truyền trong yêu cầu chỉ nên bao gồm đối tượng CustomBiddingScriptRef dưới dạng thuộc tính được chỉ định giá trị của trường script. Thao tác này liên kết tệp đã tải lên tập lệnh cùng với tài nguyên tập lệnh mới.

Dưới đây là ví dụ về cách tạo tệp tập lệnh:

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

Sau khi tạo tài nguyên tập lệnh đặt giá thầu tuỳ chỉnh, chiến dịch Hiển thị và Video 360 sẽ xử lý để đảm bảo rằng tập lệnh đó có thể được sử dụng thành công để tính số lượt hiển thị. Truy xuất trạng thái của quá trình xử lý này thông qua đối tượng tập lệnh Trường state. Sau khi tập lệnh mới được chấp nhận, lệnh gọi tuỳ chỉnh thuật toán đặt giá thầu bắt đầu sử dụng tập lệnh để tính điểm giá trị lượt hiển thị. Chiến dịch này xảy ra ngay lập tức, do đó hãy đảm bảo rằng bạn muốn cập nhật thuật toán trước tạo tài nguyên tập lệnh mới.

Chỉ định thuật toán đặt giá thầu tuỳ chỉnh

Sau khi bạn tạo thuật toán đặt giá thầu tuỳ chỉnh, hãy tải một tập lệnh được chấp nhận lên và đáp ứng các yêu cầu cần thiết, bạn có thể gán thuật toán đặt giá thầu cho chiến lược đặt giá thầu của mục hàng hoặc đơn đặt hàng quảng cáo.

Bạn có thể sử dụng thuật toán đặt giá thầu tuỳ chỉnh trong tối đa hoá chi tiêu và chiến lược giá thầu mục tiêu hiệu suất bằng cách chỉ định BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO và mã thuật toán đặt giá thầu tuỳ chỉnh cho performanceGoalType và customBiddingAlgorithmId trường tương ứng. Tuỳ thuộc vào chiến lược giá thầu, bạn có thể sử dụng các thông số giá thầu khác hoặc là bắt buộc.

Dưới đây là ví dụ về cách cập nhật một mục hàng để sử dụng phóng to chiến lược giá thầu chi tiêu bằng một thuật toán đặt giá thầu tuỳ chỉnh nhất định:

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