Konsep Dasar
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 2025-08-21 UTC."],[[["\u003cp\u003eThe Google Ad Manager API uses objects like Orders, Line Items, and Creatives to structure and manage ad campaigns.\u003c/p\u003e\n"],["\u003cp\u003eLine Items define ad requirements, targeting criteria, and cost structures, and are linked to Creatives via LineItemCreativeAssociations.\u003c/p\u003e\n"],["\u003cp\u003eCreatives represent the actual ads, which can be hosted by Ad Manager or a third-party server.\u003c/p\u003e\n"],["\u003cp\u003eAd Units represent ad locations on web pages and are targeted by Line Items or Placements, which are collections of Ad Units.\u003c/p\u003e\n"],["\u003cp\u003eInventory Targeting specifies which Ad Units are associated with a Line Item, while Targeting subclasses allow for additional criteria like geography or custom attributes.\u003c/p\u003e\n"]]],["The Google Ad Manager API's core components include `Order`, `LineItem`, `LineItemCreativeAssociation` (LICA), `Creative`, `InventoryTargeting`, `Placement`, and `AdUnit`. An `Order` contains `LineItem` instances, which define ad display requirements. A LICA links a `LineItem` to a `Creative`. `InventoryTargeting` links ad units to `LineItem`. `Placement` is a collection of `AdUnit`, representing ad locations. `Creative` is the actual ad content. AdUnits can be used to identify other adUnits.\n"],null,["# Basic Concepts\n\nThis page provides an overview\nof the architecture of the Google Ad Manager API and describes general concepts and terms in Ad Manager.\n\nAPI Architecture\n----------------\n\nHere is a simplified diagram of the main classes in the Ad Manager API, and how they relate to each other:\n\nOrder\n-----\n\n: An [Order](/ad-manager/api/reference/latest/OrderService.Order) object holds general information about the order such as the currency or salesperson, and contains one or more `LineItem` instances. In code, each `LineItem` holds the ID of its containing `Order`, rather than the `Order` holding a list of `LineItem` objects.\n\nLineItem\n--------\n\n: A [LineItem](/ad-manager/api/reference/latest/LineItemService.LineItem) object describes a set of requirements for an ad to show, including how\n and when the ads should be shown, the sizes of the creatives it should show and\n the order in which to show them (in order, weighted, or according to their performance),\n the priority of these ads, and many properties describing the cost structure. A\n `LineItem` has one `InventoryTargeting` object that describes which `AdUnit` and `Placement` objects it can target, and optional additional `Targeting` subclass objects that represent geographical, custom, or other criteria.\n\nLineItemCreativeAssociation\n---------------------------\n\n: A [LineItemCreativeAssociation](/ad-manager/api/reference/latest/LineItemCreativeAssociationService.LineItemCreativeAssociation) (often called a LICA) links one `LineItem` to\n one `Creative`. Line items can be linked to more than one creative, and depending on your account type, you might be able to link a creative to more than one line item. When you create a `LineItemCreativeAssociation`,\n Ad Manager first checks whether both the creative and the line item are compatible;\n if the sizes differ, for instance, you'll get an error when you try to create\n or update the association. This object also lets you override some values in the associated `LineItem`,\n such as start/end dates, or size (if you have a creative that doesn't\n quite fit the size specified by the line item, but you are willing to let Ad Manager\n adjust the size of the creative to fit the ad unit on the fly). LICAs are not exposed in the Ad Manager user interface; they are an API convention.\n\nCreative\n--------\n\n: A [Creative](/ad-manager/api/reference/latest/CreativeService.Creative) represents the actual ad. If the ad is hosted by Ad Manager,\n this object holds the actual image bytes, flash files, or custom HTML tags stored\n on Ad Manager's servers; if the creative is hosted on a\n third-party site, the creative is a URL or HTML snippet that makes the\n request from the third-party server.\n\nInventoryTargeting and Targeting subclasses\n-------------------------------------------\n\n: The [InventoryTargeting](/ad-manager/api/reference/latest/LineItemService.InventoryTargeting) object lists which ad units are associated with a specific `LineItem`. You can specify additional, optional targeting criteria using additional instances of an appropriate subclass of [`Targeting`](/ad-manager/api/reference/latest/LineItemService.Targeting).\n\nPlacement\n---------\n\n: A [Placement](/ad-manager/api/reference/latest/PlacementService.Placement) object is a collection of one or more `AdUnit` objects.\n\nAdUnit\n------\n\n: An [AdUnit](/ad-manager/api/reference/latest/InventoryService.AdUnit) represents an ad location on one or more pages. An `AdUnit` can be a target of either a `LineItem`'s `InventoryTargeting` object or a `Placement` object. An `AdUnit` object includes a size, an ID, and a unique name. The ID is used to identify other `AdUnit` objects within the API; the name is used as a unique identifier in the HTML tags to identify a specific `AdUnit` object, and is sent back to Ad Manager as part of the page request."]]
