- Resource: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Platform
- Metode
Resource: LineItem
Satu item baris.
Representasi JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Kolom | |
---|---|
name |
Hanya output. Nama resource item baris. |
advertiserId |
Hanya output. ID unik pengiklan yang memiliki item baris. |
campaignId |
Hanya output. ID unik kampanye yang memiliki item baris. |
insertionOrderId |
Wajib. Tidak dapat diubah. ID unik perjanjian pemasangan iklan yang memiliki item baris. |
lineItemId |
Hanya output. ID unik item baris. Ditetapkan oleh sistem. |
displayName |
Wajib. Nama tampilan item baris. Harus dienkode UTF-8 dengan ukuran maksimum 240 byte. |
lineItemType |
Wajib. Tidak dapat diubah. Jenis item baris. |
entityStatus |
Wajib. Mengontrol apakah item baris dapat membelanjakan anggarannya dan mengajukan bid untuk inventaris.
|
updateTime |
Hanya output. Stempel waktu saat item baris terakhir diperbarui. Ditetapkan oleh sistem. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
partnerCosts[] |
Biaya partner yang terkait dengan item baris. Jika tidak ada atau kosong dalam metode |
flight |
Wajib. Waktu mulai dan berakhir penayangan item baris. |
budget |
Wajib. Setelan alokasi anggaran item baris. |
pacing |
Wajib. Setelan kecepatan pembelanjaan anggaran untuk item baris. |
frequencyCap |
Wajib. Setelan batas frekuensi tayangan item baris. Kolom |
partnerRevenueModel |
Wajib. Setelan model pendapatan partner item baris. |
conversionCounting |
Setelan tracking konversi item baris. |
creativeIds[] |
ID materi iklan yang terkait dengan item baris. |
bidStrategy |
Wajib. Strategi bidding item baris. |
integrationDetails |
Detail integrasi item baris. |
inventorySourceIds[] |
ID sumber inventaris pribadi yang ditetapkan ke item baris. |
targetingExpansion |
Setelan penargetan yang dioptimalkan untuk item baris. Konfigurasi ini hanya berlaku untuk item baris display, video, atau audio yang menggunakan bidding otomatis dan secara positif menargetkan daftar audiens yang memenuhi syarat. |
warningMessages[] |
Hanya output. Pesan peringatan yang dibuat oleh item baris. Peringatan ini tidak memblokir penyimpanan item baris, tetapi beberapa peringatan mungkin memblokir penyimpanan item baris. |
mobileApp |
Aplikasi seluler yang dipromosikan oleh item baris. Hal ini hanya berlaku jika |
reservationType |
Hanya output. Jenis reservasi item baris. |
excludeNewExchanges |
Apakah akan mengecualikan bursa baru agar tidak otomatis ditargetkan oleh item baris. Kolom ini bernilai false secara default. |
LineItemType
Kemungkinan jenis item baris.
Jenis item baris menentukan setelan dan opsi yang berlaku, seperti format iklan atau opsi penargetan.
Enum | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED |
Nilai jenis tidak ditentukan atau tidak diketahui pada versi ini. Item baris jenis ini beserta penargetannya tidak dapat dibuat atau diperbarui menggunakan API. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
Iklan gambar, HTML5, native, atau multimedia. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
Iklan Display yang mendorong penginstalan aplikasi. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
Iklan video dijual berdasarkan CPM untuk berbagai lingkungan. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
Iklan video yang mendorong penginstalan aplikasi. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
Iklan Display yang ditayangkan di inventaris aplikasi seluler. Item baris jenis ini beserta penargetannya tidak dapat dibuat atau diperbarui menggunakan API. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
Iklan video yang ditayangkan di inventaris aplikasi seluler. Item baris jenis ini beserta penargetannya tidak dapat dibuat atau diperbarui menggunakan API. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
Iklan Audio RTB yang dijual untuk berbagai lingkungan. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
Iklan over-the-top ada di pesanan pemasangan iklan OTT. Jenis ini hanya berlaku untuk item baris dengan perjanjian pemasangan iklan insertionOrderType OVER_THE_TOP . |
LineItemFlight
Setelan yang mengontrol durasi aktif item baris.
Representasi JSON |
---|
{ "flightDateType": enum ( |
Kolom | |
---|---|
flightDateType |
Wajib. Jenis tanggal penayangan item baris. |
dateRange |
Tanggal mulai dan akhir penerbangan item baris. Penyesuaian ini diselesaikan sesuai dengan zona waktu pengiklan induk.
|
triggerId |
ID pemicu manual yang dikaitkan dengan item baris.
Peringatan: Item Baris yang menggunakan pemicu manual tidak lagi ditayangkan di Display & Video 360. Kolom ini akan dihentikan pada 1 Agustus 2023. Baca pengumuman penghentian fitur kami untuk mengetahui informasi selengkapnya. |
LineItemFlightDateType
Kemungkinan jenis tanggal penayangan item baris.
Enum | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
Nilai jenis tidak ditentukan atau tidak diketahui pada versi ini. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
Tanggal penayangan item baris diwariskan dari perjanjian pemasangan iklan induknya. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
Item baris menggunakan tanggal penayangan khususnya sendiri. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
Item baris menggunakan pemicu. Peringatan: Item Baris yang menggunakan pemicu manual tidak lagi ditayangkan di Display & Video 360. Nilai ini akan dihentikan pada 1 Agustus 2023. Baca pengumuman penghentian fitur kami untuk mengetahui informasi selengkapnya. |
LineItemBudget
Setelan yang mengontrol cara anggaran dialokasikan.
Representasi JSON |
---|
{ "budgetAllocationType": enum ( |
Kolom | |
---|---|
budgetAllocationType |
Wajib. Jenis alokasi anggaran.
|
budgetUnit |
Hanya output. Unit anggaran menentukan apakah anggaran berbasis mata uang atau tayangan. Nilai ini diwarisi dari perjanjian pemasangan iklan induk. |
maxAmount |
Jumlah anggaran maksimum yang akan dibelanjakan item baris. Harus lebih besar dari 0. Jika
|
LineItemBudgetAllocationType
Kemungkinan jenis alokasi anggaran.
Enum | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED |
Nilai jenis tidak ditentukan atau tidak diketahui pada versi ini. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
Alokasi anggaran otomatis diaktifkan untuk item baris. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
Jumlah anggaran maks. tetap dialokasikan untuk item baris. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
Tidak ada batas anggaran yang diterapkan ke item baris. |
PartnerRevenueModel
Setelan yang mengontrol cara penghitungan pendapatan partner.
Representasi JSON |
---|
{
"markupType": enum ( |
Kolom | |
---|---|
markupType |
Wajib. Jenis markup model pendapatan partner. |
markupAmount |
Wajib. Jumlah markup model pendapatan partner. Harus lebih besar atau sama dengan 0.
|
PartnerRevenueModelMarkupType
Kemungkinan jenis markup model pendapatan partner.
Enum | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
Nilai jenis tidak ditentukan atau tidak diketahui pada versi ini. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
Hitung pendapatan partner berdasarkan CPM tetap. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
Hitung pendapatan partner berdasarkan persentase tambahan biaya medianya. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
Hitung pendapatan partner berdasarkan persentase tambahan dari biaya media totalnya, yang mencakup semua biaya partner dan biaya data. |
ConversionCountingConfig
Setelan yang mengontrol cara penghitungan konversi.
Semua konversi pascaklik akan dihitung. Nilai persentase dapat ditetapkan untuk penghitungan konversi pascatayang.
Representasi JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Kolom | |
---|---|
postViewCountPercentageMillis |
Persentase konversi pasca-penayangan yang akan dihitung, dalam ribuan (1/1.000 dari persen). Harus antara 0 dan 100000 inklusif. Misalnya, untuk melacak 50% konversi pascaklik, tetapkan nilai 50.000. |
floodlightActivityConfigs[] |
Konfigurasi aktivitas Floodlight yang digunakan untuk melacak konversi. Jumlah konversi yang dihitung adalah jumlah semua konversi yang dihitung oleh semua ID aktivitas Floodlight yang ditentukan dalam kolom ini. |
TrackingFloodlightActivityConfig
Setelan yang mengontrol perilaku konfigurasi aktivitas Floodlight tunggal.
Representasi JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Kolom | |
---|---|
floodlightActivityId |
Wajib. ID aktivitas Floodlight. |
postClickLookbackWindowDays |
Wajib. Jumlah hari setelah iklan diklik yang dapat menghitung konversi. Harus antara 0 dan 90 inklusif. |
postViewLookbackWindowDays |
Wajib. Jumlah hari setelah iklan dilihat untuk menghitung konversi. Harus antara 0 dan 90 inklusif. |
TargetingExpansionConfig
Setelan yang mengontrol setelan penargetan yang dioptimalkan untuk item baris.
Representasi JSON |
---|
{
"targetingExpansionLevel": enum ( |
Kolom | |
---|---|
targetingExpansionLevel |
Wajib. Apakah penargetan yang dioptimalkan diaktifkan. Kolom ini mendukung nilai berikut:
Jika kolom ini ditetapkan ke nilai lain, kolom tersebut akan otomatis ditetapkan ke
|
excludeFirstPartyAudience |
Apakah akan mengecualikan audiens pihak pertama agar tidak digunakan dalam perluasan penargetan atau tidak. Kolom ini tidak digunakan lagi dengan diluncurkannya penargetan yang dioptimalkan. Kolom ini akan ditetapkan ke |
TargetingExpansionLevel
Setelan Penargetan yang dioptimalkan.
Enum | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
Setelan penargetan yang dioptimalkan tidak ditentukan atau tidak dikenal dalam versi ini. |
NO_EXPANSION |
Penargetan yang dioptimalkan nonaktif. |
LEAST_EXPANSION |
Penargetan yang dioptimalkan aktif. |
SOME_EXPANSION |
Jika digunakan, akan otomatis ditetapkan ke |
BALANCED_EXPANSION |
Jika digunakan, akan otomatis ditetapkan ke |
MORE_EXPANSION |
Jika digunakan, akan otomatis ditetapkan ke |
MOST_EXPANSION |
Jika digunakan, akan otomatis ditetapkan ke |
LineItemWarningMessage
Pesan peringatan yang dibuat oleh item baris. Jenis peringatan ini tidak memblokir penyimpanan item baris, tetapi dapat memblokir eksekusi item baris.
Enum | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
Tidak ditentukan atau tidak diketahui. |
INVALID_FLIGHT_DATES |
Item baris ini memiliki tanggal periode tayang yang tidak valid. Item baris tidak akan dijalankan. |
EXPIRED |
Tanggal akhir item baris ini sudah berlalu. |
PENDING_FLIGHT |
Item baris ini akan mulai berjalan di masa mendatang. |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
Semua bursa yang diaktifkan partner ditargetkan secara negatif. Item baris tidak akan dijalankan. |
INVALID_INVENTORY_SOURCE |
Sumber inventaris aktif tidak ditargetkan. Item baris tidak akan dijalankan. |
APP_INVENTORY_INVALID_SITE_TARGETING |
Penargetan Aplikasi & URL item baris ini tidak menyertakan aplikasi seluler mana pun. Jenis item baris ini mengharuskan Anda menyertakan aplikasi seluler dalam penargetan saluran, daftar situs, atau aplikasi. Item baris tidak akan dijalankan. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Item baris ini tidak menargetkan pengguna seluler mana pun. Jenis item baris ini mengharuskan Anda menargetkan daftar pengguna dengan pengguna seluler. Item baris tidak akan dijalankan. |
NO_VALID_CREATIVE |
Item baris ini tidak berisi materi iklan yang valid. Item baris tidak akan dijalankan. |
PARENT_INSERTION_ORDER_PAUSED |
Perjanjian pemasangan iklan untuk item baris ini dijeda. Item baris tidak akan dijalankan. |
PARENT_INSERTION_ORDER_EXPIRED |
Tanggal akhir perjanjian pemasangan iklan item baris ini ditetapkan ke tanggal yang sudah berlalu. Item baris tidak akan dijalankan. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Item baris ini tidak menargetkan daftar audiens, yang dapat menyebabkan anggaran Anda dibelanjakan terlalu cepat. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Item baris penginstalan aplikasi belum memiliki penyiapan piksel konversi. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Item baris ini menargetkan satu atau beberapa daftar pengguna yang tidak lagi tersedia. Ke depannya, hal ini akan mencegah penayangan item baris, jadi pertimbangkan untuk menghapus daftar ini dari penargetan Anda. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Item baris penginstalan aplikasi tidak memiliki strategi bidding yang optimal. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
Transaksi yang ditargetkan oleh item baris ini menyetujui ukuran materi iklan yang tidak sedang digunakan. Ini dapat membatasi penayangan atau performa item baris. |
NO_CREATIVE_FOR_TARGETED_DEALS |
Item baris ini tidak berisi materi iklan untuk transaksi yang ditargetkan. |
TARGETING_DEPRECATED_GEO_TARGET |
Item baris ini menargetkan target geografis yang sudah tidak digunakan lagi. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Item baris ini menggunakan setelan Perbarui integrasi API Anda untuk mengecualikan secara langsung audiens pihak pertama yang menggunakan penargetan audiens sebelum 25 Maret 2023 untuk memperhitungkan penghentian kolom |
MobileApp
Aplikasi seluler yang dipromosikan oleh item baris penginstalan aplikasi seluler.
Representasi JSON |
---|
{
"appId": string,
"platform": enum ( |
Kolom | |
---|---|
appId |
Wajib. ID aplikasi yang disediakan oleh platform store. Aplikasi Android diidentifikasi dengan ID paket yang digunakan oleh Play Store Android, seperti Aplikasi iOS diidentifikasi dengan ID aplikasi sembilan digit yang digunakan oleh App store Apple, seperti |
platform |
Hanya output. Platform aplikasi. |
displayName |
Hanya output. Nama aplikasi. |
publisher |
Hanya output. Penerbit aplikasi. |
Platform
Kemungkinan platform aplikasi seluler.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Platform belum ditentukan. |
IOS |
Platform iOS. |
ANDROID |
Platform Android. |
Metode |
|
---|---|
|
Mengedit opsi penargetan secara massal pada satu item baris. |
|
Mencantumkan opsi penargetan item baris yang ditetapkan di seluruh jenis penargetan. |
|
Membuat item baris baru. |
|
Menghapus item baris. |
|
Membuat item baris baru dengan setelan (termasuk penargetan) yang diwarisi dari perjanjian pemasangan iklan dan ENTITY_STATUS_DRAFT entity_status . |
|
Mendapatkan item baris. |
|
Mencantumkan item baris di pengiklan. |
|
Memperbarui item baris yang ada. |