Conceptos básicos
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En esta página, se proporciona una descripción general de la arquitectura de la API de Google Ad Manager y se describen los términos y conceptos generales de Ad Manager.
La arquitectura de una API
A continuación, se muestra un diagrama simplificado de las clases principales de la API de Ad Manager y cómo se relacionan entre sí:
Pedidos
- Un objeto
Order contiene información general sobre el pedido, como la moneda o el vendedor, y contiene una o más instancias de LineItem. En el código, cada LineItem contiene el ID del Order que lo contiene, en lugar de que Order contenga una lista de objetos LineItem.
LineItem
- Un objeto
LineItem describe un conjunto de requisitos para que se muestre un anuncio, que incluye cómo y cuándo deben mostrarse, los tamaños de las creatividades que debe mostrar y el orden en que deben mostrarse (en orden, ponderado o según su rendimiento), la prioridad de estos anuncios y muchas propiedades que describen la estructura de costos. Una LineItem tiene un objeto InventoryTargeting que describe a qué objetos AdUnit y Placement se puede orientar, y objetos opcionales de subclase Targeting adicionales que representan criterios geográficos, personalizados y de otros tipos.
LineItemCreativeAssociation
- Un
LineItemCreativeAssociation (a menudo llamado LICA) vincula un LineItem con un Creative. Las líneas de pedido se pueden vincular a más de una creatividad y, según el tipo de cuenta, es posible que puedas vincular una creatividad a más de una línea de pedido. Cuando creas una LineItemCreativeAssociation, Ad Manager primero verifica si la creatividad y la línea de pedido son compatibles. Si los tamaños difieren, por ejemplo, recibirás un error cuando intentes crear o actualizar la asociación. Este objeto también te permite anular algunos valores en la etiqueta LineItem asociada, como las fechas de inicio y finalización, o el tamaño (si tienes una creatividad que no se ajusta del todo al tamaño especificado por la línea de pedido, pero quieres permitir que Ad Manager ajuste el tamaño de la creatividad para que se ajuste a la unidad de anuncios sobre la marcha). Las LICA no se exponen en la interfaz de usuario de Ad Manager; son una convención de API.
Creatividad
- Una
Creative representa el anuncio real. Si Ad Manager aloja el anuncio, este objeto contiene los bytes reales de la imagen, los archivos Flash o las etiquetas HTML personalizadas almacenadas en los servidores de Ad Manager; si la creatividad está alojada en un sitio de terceros, la creatividad es una URL o un fragmento HTML que realiza la solicitud desde el servidor de terceros.
Subclases InventoryTargeting y Targeting
- El objeto
InventoryTargeting muestra qué unidades de anuncios están asociadas con una LineItem específica. Puedes especificar criterios de segmentación opcionales adicionales con instancias adicionales de una subclase apropiada de Targeting.
Posición
- Un objeto
Placement es una colección de uno o más objetos AdUnit.
AdUnit
- Un elemento
AdUnit representa la ubicación de un anuncio en una o más páginas. Un AdUnit puede ser un destino de un objeto InventoryTargeting de LineItem o un objeto Placement. Los objetos AdUnit incluyen un tamaño, un ID y un nombre único. El ID se usa para identificar otros objetos AdUnit en la API. El nombre se usa como identificador único en las etiquetas HTML para identificar un objeto AdUnit específico y se envía de vuelta a Ad Manager como parte de la solicitud de la página.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-21 (UTC)
[null,null,["Última actualización: 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."]]
