Menerapkan Bidding Kustom

Anda dapat menggunakan antarmuka Display & Video 360 API untuk mengelola bidding kustom implementasi yang tepat. Anda dapat membuat algoritma bidding kustom, mengupload, dan memverifikasi skrip individu, dan menetapkan algoritma tertentu ke sumber daya sebagai bidding-nya strategi.

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

Membuat Algoritma Bidding Kustom

Objek CustomBiddingAlgorithm mewakili individu yang dapat ditetapkan ke item baris untuk digunakan dalam strategi biddingnya. Ini memiliki detail tentang algoritma seperti objeknya customBiddingAlgorithmType, entityStatus dan customBiddingAlgorithmState. Anda dapat membuat Objek CustomBiddingScript sebagai resource turunan untuk algoritma untuk digunakan.

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

Berikut contoh cara membuat bidding kustom berbasis skrip algoritme:

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 anak mana pun pengiklan yang tercantum di kolom sharedAdvertiserIds. Algoritma yang dimiliki pengiklan dapat diakses dan diubah oleh pengiklan tersebut pengiklan dan partner induknya, tetapi tidak dapat dibagikan kepada pengiklan lain.

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

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

Upload skrip

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

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

Mengambil lokasi resource skrip

Pertama, ambil lokasi resource yang tersedia di bagian bidding kustom resource algoritma dengan Metode customBiddingAlgorithms.uploadScript. Ini menampilkan objek CustomBiddingScriptRef dengan nama resource. Anda dapat upload file skrip Anda ke lokasi yang ditentukan oleh nama resource. Lalu, gunakan objek referensi skrip bidding kustom untuk buat resource skrip.

Berikut adalah contoh cara mengambil resource yang tersedia lokasi:

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

Upload file skrip

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

Peringatan: Skrip bidding kustom memiliki ukuran file maksimum 7 MB.

Berikut adalah contoh cara mengupload file skrip yang diberikan mengambil objek referensi skrip bidding kustom:

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. Tujuan Objek CustomBiddingScript yang diteruskan dalam permintaan hanya boleh sertakan objek CustomBiddingScriptRef sebagai objek yang ditetapkan nilai kolom script. Hal ini mengaitkan file yang diupload file skrip dengan resource skrip baru.

Peringatan: Jika file skrip yang Anda upload mengalami error sintaksis, elemen Permintaan customBiddingAlgorithms.scripts.create akan gagal dan menampilkan detail tentang {i>error <i}pada {i>syntax<i} yang ditemukan. Untuk mengunggah file skrip tetap, 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 aset skrip bidding kustom, kampanye Display & Video 360 memproses untuk memastikan bahwa skrip itu berhasil digunakan untuk mencetak tayangan. Ambil status pemrosesan ini melalui metode Kolom state. Setelah skrip baru diterima, algoritma bidding mulai menggunakan skrip untuk menilai nilai tayangan. Ini terjadi seketika, jadi pastikan Anda ingin memperbarui algoritma sebelum membuat resource skrip baru.

Menetapkan Algoritma Bidding Kustom

Setelah membuat algoritma bidding kustom, upload skrip yang diterima, dan penuhi persyaratan yang diperlukan, Anda dapat menetapkan algoritma bidding ke strategi bidding item baris atau pesanan pemasangan iklan.

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

Berikut contoh cara memperbarui item baris untuk menggunakan fungsi strategi bidding 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"]}.')