확장 소재는 디스플레이, YouTube, 앱 스토어 등 다양한 형식에서 여러 유형의 광고를 구성하는 데 사용되는 공유 가능한 데이터 단위(예: 이미지, 동영상, 광고 제목, 설명)입니다.
사물
API의 가장 기본적인 객체는 다음과 같습니다.
Asset: 공유 가능한 광고 데이터 단위입니다.
AssetType: 애셋에 포함된 콘텐츠의 종류입니다(예: 텍스트 또는 이미지).
AssetFieldType: 애셋이 사용되는 방식입니다. 예를 들어 텍스트 애셋 유형은 광고 제목 또는 내용 입력란 애셋 필드 유형으로 사용할 수 있습니다.
AssetSet: 테마를 중심으로 하거나 캠페인별로 정리된 애셋 모음입니다.
AssetSetType: 애셋 세트의 클래스
애셋, 애셋 세트, 광고 그룹, 캠페인, 고객 간의 링크를 나타내는 객체가 있습니다.
애셋 연결
CustomerAsset: 고객과 애셋 간의 링크
CampaignAsset: 캠페인과 애셋 간의 링크
AdGroupAsset: 광고 그룹과 애셋 간의 연결
AssetSetAsset: 애셋 세트와 애셋 간의 링크
애셋 세트와의 연결
CustomerAssetSet: 고객과 애셋 세트 간의 링크
CampaignAssetSet: 캠페인과 애셋 세트 간의 링크
AdGroupAssetSet: 광고 그룹과 애셋 세트 간의 연결
캠페인 애셋 예
다음은 일부 객체를 연결하는 방법을 시각적으로 보여줍니다. 이 예에서는 캠페인이 맨 위에 있지만 동일한 계층 구조가 고객 및 광고 그룹에도 적용됩니다.
캠페인 확장 소재 조합 다이어그램
CampaignAssetSet를 만들기 전에 먼저 Campaign와 하나 이상의 애셋이 포함된 AssetSet을 만들어야 합니다. 확장 소재를 조합하여 캠페인에서 사용할 수 있는 모든 광고 형식의 인벤토리를 만들거나, 광고가 게재되는 채널(YouTube, Gmail, Google 검색 등)에 따라 Google Ads에서 사용 가능한 확장 소재를 조합하도록 할 수 있습니다.
광고에 연결된 애셋 유형
일부 확장 소재 유형은 광고에 직접 연결할 수 있습니다.
애셋 유형
AssetFieldType
광고 유형
동영상
YOUTUBE_VIDEO
앱 광고 앱 재참여 광고 지역 광고 반응형 디스플레이 광고
미디어 번들
MEDIA_BUNDLE CUSTOM_LAYOUT
앱 광고 디스플레이 업로드 광고
이미지
MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eAssets are shareable data units like images and text, used to build various ad types across different platforms.\u003c/p\u003e\n"],["\u003cp\u003eAssets are organized into Asset Sets and linked to Campaigns, Ad Groups, and Customers for streamlined management.\u003c/p\u003e\n"],["\u003cp\u003eSpecific Asset Types can be directly linked to ads or linked through linkage objects for greater flexibility.\u003c/p\u003e\n"],["\u003cp\u003eSome Asset Types are automatically created by the system and cannot be modified, indicated by their AssetSource.\u003c/p\u003e\n"],["\u003cp\u003eCertain Asset Types are designed to be used with specific Asset Set Types for specialized campaign setups.\u003c/p\u003e\n"]]],[],null,["Assets are units of shareable data---such as images, videos, headlines, and\ndescriptions---that are used to construct different types of ads across\nmultiple formats, such as display, YouTube, app store, and others.\n\nObjects\n\nThe most basic objects in the API are the following:\n\n- **`Asset`:** A unit of shareable advertising data\n - **`AssetType`:** The kind of content the asset contains---for example, text or image\n - **`AssetFieldType`:** How the asset is used---for example, a text asset type can be used as a headline or a description asset field type\n- **`AssetSet`** : A collection of assets centered around a theme or organized by campaign\n - **`AssetSetType`**: The class of the asset set\n\nThere are objects that represent links among assets, asset sets, ad groups,\ncampaigns, and customers:\n\n- Linkages to assets\n\n - **`CustomerAsset`:** The link between a customer and an asset\n - **`CampaignAsset`:** The link between a campaign and an asset\n - **`AdGroupAsset`:** The link between an ad group and an asset\n - **`AssetSetAsset`:** The link between an asset set and an asset\n- Linkages to asset sets\n\n - **`CustomerAssetSet`:** The link between a customer and an asset set\n - **`CampaignAssetSet`:** The link between a campaign and an asset set\n - **`AdGroupAssetSet`:** The link between an ad group and an asset set\n\nCampaign assets example\n\nHere's a visual representation of how some of the objects can be linked. The\nexample starts with campaigns at the top, but the same hierarchy also applies to\ncustomers and ad groups.\nDiagram of campaign asset sets\n\nBefore you create a `CampaignAssetSet`, you must first create a\n[`Campaign`](/google-ads/api/docs/campaigns/create-campaigns) and an `AssetSet` containing\none or more assets. You can assemble assets to create an inventory for all\napplicable ad formats in your campaign, or let Google Ads mix and match available\nassets based on which channel the ad is being served: YouTube, Gmail, Search,\nand others.\n| **Key Point:** A `Campaign` can link to one or more `CampaignAssetSet` objects, but each `CampaignAssetSet` can be linked to only one `Campaign`.\n\nAsset types linked to ads\n\nSome asset types can be linked directly to ads.\n\n| Asset type | AssetFieldType | Ad type |\n|----------------|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------|\n| Video | YOUTUBE_VIDEO | App ad App engagement ad Local ad Responsive display ad |\n| Media bundle | MEDIA_BUNDLE CUSTOM_LAYOUT | App ad Display upload Ad |\n| Image | MARKETING_IMAGE SQUARE_MARKETING_IMAGE LOGO LANDSCAPE_LOGO PORTRAIT_MARKETING_IMAGE | App ad App engagement ad Local ad Responsive display ad |\n| Text | HEADLINE LONG_HEADLINE DESCRIPTION MANDATORY_AD_TEXT CALL_TO_ACTION_SELECTION BUSINESS_NAME | App ad App engagement ad Local ad Responsive display ad Responsive search ad Smart campaign ad |\n| Call to Action | CALL_TO_ACTION | Local ad Responsive display ad |\n\nAsset types linked to customers, campaigns, and ad groups\n\nSome types of assets can be linked to customers, campaigns, or ad groups through\nlinkage objects.\n| **Note:** For `BUSINESS_MESSAGE` assets:\n|\n| - Each customer can have only one active business message asset.\n| - At the campaign and ad group levels, you can assign only one active business message asset for each message provider type.\n\n| Asset type | AssetFieldType | Linkage | Mutable |\n|--------------------|--------------------|------------------------------------------|---------|\n| Business message | BUSINESS_MESSAGE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Text | BUSINESS_NAME | CampaignAsset CustomerAsset | No |\n| Image | AD_IMAGE | AdGroupAsset CampaignAsset | No |\n| Image | BUSINESS_LOGO | CampaignAsset CustomerAsset | No |\n| Lead form | LEAD_FORM | CampaignAsset | Yes |\n| Promotion | PROMOTION | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Callout | CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Structured snippet | STRUCTURED_SNIPPET | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Sitelink | SITELINK | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Mobile app | MOBILE_APP | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Hotel callout | HOTEL_CALLOUT | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Call | CALL | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n| Price | PRICE | AdGroupAsset CampaignAsset CustomerAsset | Yes |\n\nLocation assets\n\nLocation assets are handled differently from other asset types. See [Location\nassets](/google-ads/api/docs/assets/location-assets) for details.\n\nAutomatically created assets\n\nAutomatically created assets cannot be modified. The\n[`AssetSource`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource) indicates whether an\nasset was user-created or was automatically generated by the system. Mutable\ntypes like sitelink can't be linked to automatically created assets.\n\nAsset types linked to asset sets\n\nCertain asset types can be linked to specific types of asset sets.\n\n| AssetType | AssetSetType | Linkage | Mutable |\n|----------------------------|------------------------------|---------------------------------------------------|-----------------------|\n| PAGE_FEED | PAGE_FEED | CampaignAssetSet | Yes |\n| DYNAMIC_EDUCATION | DYNAMIC_EDUCATION | CampaignAssetSet | Yes |\n| DYNAMIC_CUSTOM | DYNAMIC_CUSTOM | CampaignAssetSet | Yes |\n| DYNAMIC_HOTELS_AND_RENTALS | DYNAMIC_HOTELS_AND_RENTALS | CampaignAssetSet | Yes |\n| DYNAMIC_REAL_ESTATE | DYNAMIC_REAL_ESTATE | CampaignAssetSet | Yes |\n| DYNAMIC_LOCAL | DYNAMIC_LOCAL | CampaignAssetSet | Yes |\n| DYNAMIC_FLIGHTS | DYNAMIC_FLIGHTS | CampaignAssetSet | Yes |\n| DYNAMIC_JOBS | DYNAMIC_JOBS | CampaignAssetSet | Yes |\n| DYNAMIC_TRAVEL | DYNAMIC_TRAVEL | CampaignAssetSet | Yes |\n| LOCATION | LOCATION_SYNC | CustomerAssetSet CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | GMB_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | CHAIN_DYNAMIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |\n| LOCATION | STATIC_LOCATION_GROUP | CampaignAssetSet AdGroupAssetSet | No (system generated) |"]]
