Menerapkan Bidding Kustom

Anda dapat menggunakan Display & Video 360 API untuk mengelola penerapan bidding kustom. Anda dapat membuat algoritma bidding kustom, mengupload dan memverifikasi setiap skrip, serta menetapkan algoritma tertentu ke resource sebagai strategi bidding-nya.

Halaman ini menjelaskan cara membuat, mengupdate, dan menetapkan algoritma bidding kustom dengan Display & Video 360 API. Setiap bagian memberikan contoh kode.

Membuat Algoritma Bidding Kustom

Objek CustomBiddingAlgorithm merepresentasikan algoritma individu yang dapat Anda tetapkan ke item baris untuk digunakan dalam strategi bidding-nya. Objek ini memiliki detail tentang algoritma seperti customBiddingAlgorithmType, entityStatus dan customBiddingAlgorithmState. Anda dapat membuat objek CustomBiddingScript sebagai resource turunan untuk digunakan algoritma.

Catatan: Panduan ini berfokus pada algoritma bidding kustom berbasis skrip. Algoritma yang dibuat di Ads Data Hub atau melalui alat Pembuat Sasaran UI Display & Video 360 dapat diambil dan ditetapkan, tetapi tidak dikelola sepenuhnya.

Berikut adalah contoh cara membuat algoritma bidding kustom berbasis skrip:

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

Mengelola akses algoritma

Algoritma bidding kustom dapat dimiliki oleh partner atau pengiklan. Algoritma yang dimiliki partner dapat diakses dan diubah oleh partner tersebut dan pengiklan turunan yang tercantum di kolom sharedAdvertiserIds. Algoritma yang dimiliki pengiklan dapat diakses dan diubah oleh pengiklan tersebut dan partner induknya, tetapi tidak dapat dibagikan kepada pengiklan lain.

Catatan: Saat membuat algoritma bidding kustom, Anda harus memiliki akses baca/tulis ke partner atau pengiklan yang Anda tetapkan sebagai pemilik.

Jika Anda hanya menggunakan algoritma untuk satu pengiklan, tetapkan pengiklan sebagai pemilik dengan kolom advertiserId. Jika tidak, tetapkan partner induk pengiklan sebagai pemilik dengan kolom partnerId, dan berikan akses pengiklan dengan kolom sharedAdvertiserIds.

Mengupload skrip

Setelah membuat algoritma bidding kustom, buat skrip untuk algoritma tersebut. Algoritma bidding kustom berbasis skrip menggunakan skrip yang disediakan pengguna untuk mengevaluasi nilai tayangan iklan. Contoh skrip sederhana dan daftar kolom lanjutan tersedia melalui Pusat Bantuan Display & Video 360.

Bagian berikut mengajarkan cara menambahkan skrip baru atau yang telah diupdate ke algoritma bidding kustom.

Mengambil lokasi resource skrip

Pertama, ambil lokasi resource yang tersedia di bawah resource algoritma bidding kustom dengan metode customBiddingAlgorithms.uploadScript. Permintaan ini menampilkan objek CustomBiddingScriptRef dengan nama resource. Anda dapat mengupload file skrip ke lokasi yang ditentukan oleh nama resource. Kemudian, gunakan objek referensi skrip bidding kustom untuk membuat resource skrip.

Berikut adalah contoh cara mengambil lokasi resource yang tersedia:

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

Mengupload file skrip

Setelah mengambil lokasi resource yang tersedia, upload file skrip Anda ke lokasi tersebut di sistem Display & Video 360 dengan metode media.upload. Metode ini mendukung upload sederhana yang memerlukan parameter kueri uploadType=media.

Peringatan: Ukuran file maksimum untuk skrip bidding kustom adalah 7 MB.

Berikut contoh cara mengupload file skrip dengan objek referensi skrip bidding kustom yang diambil:

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

Membuat objek skrip

Setelah file skrip diupload, buat resource skrip bidding kustom dengan metode customBiddingAlgorithms.scripts.create. Objek CustomBiddingScript yang diteruskan dalam permintaan hanya boleh mencakup objek CustomBiddingScriptRef sebagai nilai yang ditetapkan untuk kolom script. Tindakan ini mengaitkan file skrip yang diupload dengan resource skrip baru.

Peringatan: Jika file skrip yang Anda upload memiliki error sintaksis, permintaan customBiddingAlgorithms.scripts.create Anda akan gagal dan menampilkan detail tentang error sintaksis yang ditemukan. Untuk mengupload file skrip yang telah diperbaiki, Anda harus memulai ulang proses ini dengan mengambil lokasi resource skrip baru.

Berikut adalah contoh cara membuat file skrip:

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

Setelah Anda membuat resource skrip bidding kustom, Display & Video 360 akan memproses skrip untuk memastikan bahwa skrip tersebut dapat berhasil digunakan untuk memberi skor pada tayangan. Ambil status pemrosesan ini melalui kolom state objek skrip. Setelah skrip baru diterima, algoritma bidding kustom mulai menggunakan skrip untuk memberi skor pada nilai tayangan iklan. Tindakan ini akan segera terjadi, jadi pastikan Anda ingin mengupdate algoritma sebelum membuat resource skrip baru.

Menetapkan Algoritma Bidding Kustom

Setelah membuat algoritma bidding kustom, mengupload skrip yang diterima, dan memenuhi persyaratan yang diperlukan, Anda dapat menetapkan algoritma bidding kustom ke strategi bidding item baris atau perintah penyisipan.

Anda dapat menggunakan algoritma bidding kustom dalam strategi bidding maksimalkan pembelanjaan dan sasaran performa dengan menetapkan BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CUSTOM_ALGO dan ID algoritma bidding kustom ke kolom performanceGoalType dan customBiddingAlgorithmId. Bergantung pada strategi bidding, parameter bid lainnya mungkin tersedia atau diperlukan.

Berikut contoh cara memperbarui item baris untuk menggunakan strategi bidding maksimalkan pembelanjaan dengan algoritma bidding kustom tertentu:

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