Konsep Dasar

Halaman ini menyediakan ringkasan arsitektur Google Ad Manager API serta menjelaskan konsep dan istilah umum dalam Ad Manager.

Arsitektur API

Berikut adalah diagram sederhana dari class utama di Ad Manager API, dan kaitannya satu sama lain:

Pesan

Objek Order menyimpan informasi umum tentang pesanan seperti mata uang atau staf penjualan, dan berisi satu atau beberapa instance LineItem. Dalam kode, setiap LineItem menyimpan ID Order yang memuatnya, bukan Order yang menyimpan daftar objek LineItem.

LineItem

Objek LineItem menjelaskan serangkaian persyaratan bagi iklan untuk ditampilkan, termasuk bagaimana dan kapan iklan harus ditampilkan, ukuran materi iklan yang harus ditampilkan, dan urutan kemunculannya (berurutan, berbobot, atau sesuai dengan performanya), prioritas iklan tersebut, dan berbagai properti yang menjelaskan struktur biayanya. LineItem memiliki satu objek InventoryTargeting yang menjelaskan objek AdUnit dan Placement yang dapat ditargetkan, dan objek subclass Targeting tambahan opsional yang mewakili kriteria geografis, kustom, atau kriteria lainnya.

LineItemCreativeAssociation

LineItemCreativeAssociation (sering disebut LICA) menautkan satu LineItem ke satu Creative. Item baris dapat ditautkan ke lebih dari satu materi iklan, dan bergantung pada jenis akun, Anda mungkin dapat menautkan materi iklan ke lebih dari satu item baris. Saat Anda membuat LineItemCreativeAssociation, Ad Manager akan memeriksa terlebih dahulu apakah materi iklan dan item baris kompatibel; jika ukurannya berbeda, misalnya, Anda akan mendapatkan error saat mencoba membuat atau memperbarui pengaitan. Objek ini juga memungkinkan Anda mengganti beberapa nilai dalam LineItem terkait, seperti tanggal mulai/berakhir, atau ukuran (jika Anda memiliki materi iklan yang tidak cukup sesuai dengan ukuran yang ditentukan oleh item baris, tetapi Anda mengizinkan Ad Manager menyesuaikan ukuran materi iklan agar sesuai dengan unit iklan dengan cepat). LICA tidak ditampilkan di antarmuka pengguna Ad Manager; merupakan konvensi API.

Materi Iklan

Creative mewakili iklan yang sebenarnya. Jika iklan dihosting oleh Ad Manager, objek ini menyimpan byte gambar, file flash, atau tag HTML kustom sebenarnya yang disimpan di server Ad Manager; jika materi iklan dihosting di situs pihak ketiga, materi iklan adalah cuplikan URL atau HTML yang membuat permintaan dari server pihak ketiga.

Subclass InventoryTargeting dan Penargetan

Objek InventoryTargeting mencantumkan unit iklan mana yang terkait dengan LineItem tertentu. Anda dapat menentukan kriteria penargetan opsional tambahan menggunakan instance tambahan dari subclass Targeting yang sesuai.

Penempatan

Objek Placement adalah kumpulan dari satu atau beberapa objek AdUnit.

AdUnit

AdUnit mewakili lokasi iklan di satu atau beberapa halaman. AdUnit dapat berupa target objek InventoryTargeting LineItem atau objek Placement. Objek AdUnit mencakup ukuran, ID, dan nama unik. ID digunakan untuk mengidentifikasi objek AdUnit lainnya dalam API; nama ini digunakan sebagai ID unik di tag HTML untuk mengidentifikasi objek AdUnit tertentu, dan dikirim kembali ke Ad Manager sebagai bagian dari permintaan halaman.