기본 개념
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 Google Ad Manager API의 아키텍처에 대한
개요를 제공하고 Ad Manager의 일반적인 개념과 용어를 설명합니다.
API 아키텍처
다음은 Ad Manager API의 기본 클래스 및 상호 연관성을 간략하게 나타낸 다이어그램입니다.
주문
Order 객체는 통화, 영업 담당자 등 주문에 대한 일반적인 정보를 포함하며 LineItem 인스턴스를 하나 이상 포함합니다. 코드에서 각 LineItem는 LineItem 객체 목록을 보유하는 Order가 아니라 이를 포함하는 Order의 ID를 보유합니다.LineItem
LineItem 객체는 광고를 표시하는 방법 및 시점, 광고를 표시해야 하는 광고 소재의 크기, 광고 게재 순서 (순서, 가중치 적용 또는 실적에 따른 순서), 이러한 광고의 우선순위, 비용 구조를 설명하는 여러 속성을 포함하여 광고를 게재하기 위한 요구사항을 설명합니다. LineItem에는 타겟팅할 수 있는 AdUnit 및 Placement 객체를 설명하는 하나의 InventoryTargeting 객체와 지역, 맞춤 또는 기타 기준을 나타내는 추가 Targeting 서브클래스 객체(선택사항)가 있습니다.LineItemCreativeAssociation
LineItemCreativeAssociation (LICA라고도 함)는 하나의 LineItem와 하나의 Creative를 연결합니다. 광고 항목은 두 개 이상의 광고 소재에 연결할 수 있으며, 계정 유형에 따라 광고 소재를 두 개 이상의 광고 항목에 연결할 수도 있습니다. LineItemCreativeAssociation를 생성하면 Ad Manager는 먼저 광고 소재와 광고 항목이 모두 호환되는지 확인합니다. 예를 들어 크기가 다르면 연결을 생성하거나 업데이트하려고 할 때 오류가 발생합니다. 또한 이 객체를 사용하면 연결된 LineItem의 일부 값(예: 시작일/종료일 또는 크기)을 재정의할 수 있습니다(광고 항목에서 지정한 크기에 맞지 않는
광고 소재가 있지만 Ad Manager에서
광고 소재의 크기를 즉시 조정하도록 할 수 있는 경우). LICA는 Ad Manager 사용자 인터페이스에 표시되지 않으며 API 규칙입니다.광고 소재
Creative는 실제 광고를 나타냅니다. 광고가 Ad Manager에 의해 호스팅되는 경우 이 객체는 Ad Manager 서버에 저장된 실제 이미지 바이트, 플래시 파일 또는 맞춤 HTML 태그를 보유합니다. 광고 소재가 타사 사이트에서 호스팅되는 경우 광고 소재는 타사 서버로부터 요청을 전송하는 URL 또는 HTML 스니펫입니다. Inventory타겟팅 및 타겟팅 하위 클래스
InventoryTargeting 객체는 특정 LineItem와 연결된 광고 단위를 나열합니다. Targeting의 적절한 서브클래스의 추가 인스턴스를 사용하여 추가 타겟팅 기준(선택사항)을 지정할 수 있습니다.위치
Placement 객체는 하나 이상의 AdUnit 객체의 모음입니다.AdUnit
AdUnit는 하나 이상의 페이지 상의 광고 위치를 나타냅니다. AdUnit는 LineItem의 InventoryTargeting 객체 또는 Placement 객체의 대상일 수 있습니다. AdUnit 객체에는 크기, ID, 고유 이름이 포함됩니다. ID는 API 내에서 다른 AdUnit 객체를 식별하는 데 사용됩니다. 이름은 특정 AdUnit 객체를 식별하기 위해 HTML 태그에서 고유 식별자로 사용되며 페이지 요청의 일부로 Ad Manager로 다시 전송됩니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 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."]]
