자동 애셋
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Google Ads API는 Google Ads에서 직접 관리하는 자동 확장 소재를 지원하며, API 범위는 개별 확장 소재를 일시중지하거나 삭제하고 통계를 검색하는 것으로 제한됩니다. Google Ads 웹 인터페이스를 통해 자동 확장 소재를 선택하거나 선택 해제할 수 있습니다.
생성 및 업데이트
계정에서 이 기능을 선택하면 Google Ads에서 다음과 같이 자동 확장 소재를 생성합니다.
- 애셋이 생성됩니다.
CampaignAsset
, AdGroupAsset
또는 CustomerAsset
객체는 애셋을 각각 캠페인, 광고 그룹 또는 고객 리소스와 연결하기 위해 생성됩니다.
Google Ads API를 사용하여 자동 애셋을 만들거나 업데이트할 수 없으며, Google Ads API를 사용하여 자동 애셋에 대한 CampaignAsset
, AdGroupAsset
또는 CustomerAsset
을 만들 수도 없습니다.
자동 확장 소재를 해당 리소스와 연결하는 CampaignAsset
, AdGroupAsset
또는 CustomerAsset
항목을 일시중지하거나 삭제할 수 있습니다.
연결 일시중지 또는 삭제
연결을 일시중지하면 애셋이 해당 항목에 대해 일시적으로 게재되지 않습니다. 연결을 일시중지하면 웹 인터페이스 또는 API를 통해 다시 사용 설정될 때까지 Google Ads에서 해당 리소스에 대해 자동으로 다시 사용 설정하거나 관련 확장 소재를 게재하지 않습니다. 애셋과 리소스 간의 연결을 영구적으로 사용 중지하려면 연결을 삭제하세요.
Google Ads에서는 특정 유형의 자동 확장 소재가 특정 항목(예: 캠페인당 자동 사이트 링크 수)과 연결될 수 있는 수를 제한합니다. 일시중지된 연결은 이 한도에 포함되지만 삭제된 연결은 포함되지 않습니다. 자동 확장 소재는 수동으로 추가된 확장 소재의 한도에 포함되지 않습니다.
자동 확장 소재 가져오기
AssetSource = AUTOMATICALLY_CREATED
을 필터링하여 자동 확장 소재 데이터를 가져올 수 있습니다.
광고에 연결할 수 있는 애셋의 경우 source
를 확인하세요. 광고에 연결할 수 있는 애셋 유형 목록은 AssetType
을 참고하세요.
다음은 광고의 애셋에 대한 샘플 쿼리입니다.
SELECT
ad_group.name,
ad_group_ad_asset_view.asset,
ad_group_ad_asset_view.ad_group_ad
FROM ad_group_ad_asset_view
WHERE asset.source = 'AUTOMATICALLY_CREATED'
다른 유형의 확장 소재의 경우 Asset
리소스를 직접 쿼리합니다.
SELECT
asset.id,
asset.name
FROM asset
WHERE asset.source = 'AUTOMATICALLY_CREATED'
보고서
애셋 실적 통계는 asset_field_type_view
보고서에서 요청할 수 있습니다. 이 보고서에는 자동 애셋과 수동으로 추가된 애셋의 집계 통계가 모두 포함됩니다.
개별 애셋의 실적 통계는 campaign_asset
, customer_asset
, ad_group_asset
보고서에서 가져올 수 있습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[[["\u003cp\u003eThe Google Ads API allows you to manage automated assets (created by Google Ads) by pausing, removing, or retrieving their performance data.\u003c/p\u003e\n"],["\u003cp\u003eYou can opt in or out of using automated assets through the Google Ads web interface, but cannot create or update them directly via the API.\u003c/p\u003e\n"],["\u003cp\u003ePausing an automated asset's association with a campaign, ad group, or customer temporarily disables it, while removing the association permanently disables it.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve data for automated assets using specific queries and filters within the Google Ads API.\u003c/p\u003e\n"],["\u003cp\u003ePerformance statistics for automated assets are available through various reporting features within the Google Ads API, including aggregated and individual asset data.\u003c/p\u003e\n"]]],[],null,["# Automated assets\n\nThe Google Ads API supports [automated\nassets](//support.google.com/google-ads/answer/7175034) managed directly by\nGoogle Ads, with the scope of the API limited to pausing or removing individual\nassets and retrieving stats. You opt in or out of automated assets through the\nGoogle Ads web interface.\n\nCreation and update\n-------------------\n\nOnce an account is opted in to this feature, Google Ads creates automated assets as\nfollows:\n\n1. Assets are created.\n2. [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset), [`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or [`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) objects are created to associate the asset with campaign, ad group, or customer resources, respectively.\n\nYou cannot create or update automated assets using the Google Ads API, nor can you\ncreate [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset),\n[`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or\n[`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) for the automated assets using\nthe Google Ads API.\n\nYou can pause or remove [`CampaignAsset`](/google-ads/api/reference/rpc/v21/CampaignAsset),\n[`AdGroupAsset`](/google-ads/api/reference/rpc/v21/AdGroupAsset), or\n[`CustomerAsset`](/google-ads/api/reference/rpc/v21/CustomerAsset) entities that associate the\nautomated asset with the corresponding resource.\n\nPause or remove the association\n-------------------------------\n\nPausing the association disables the asset from serving against the\ncorresponding entity temporarily. Once you pause the association, Google Ads won't\nautomatically re-enable or serve the corresponding asset against that resource\nuntil it is re-enabled through the web interface or API. To disable the\nassociation between asset and resource permanently, remove the association.\n\nGoogle Ads enforces a limit on the number of automated assets of a given type that\ncan be associated with a given entity, for example, the number of automated\nsitelinks per campaign. A paused association counts against this limit, whereas\na removed association doesn't. Automated assets don't count towards the limits\nfor manually added assets.\n\nRetrieve automated assets\n-------------------------\n\nYou can retrieve automated assets data by filtering for\n[`AssetSource = AUTOMATICALLY_CREATED`](/google-ads/api/reference/rpc/v21/AssetSourceEnum.AssetSource#automatically_created).\nFor assets that can link to ads, check its\n[`source`](/google-ads/api/reference/rpc/v21/AdGroupAdAssetView#source). Refer to\n[`AssetType`](/google-ads/api/reference/rpc/v21/AssetTypeEnum.AssetType) for a list of asset types\nthat can be linked to ads.\n\nHere is a sample query for assets in an ad: \n\n SELECT\n ad_group.name,\n ad_group_ad_asset_view.asset,\n ad_group_ad_asset_view.ad_group_ad\n FROM ad_group_ad_asset_view\n WHERE asset.source = 'AUTOMATICALLY_CREATED'\n\nFor other types of assets, query the [`Asset`](/google-ads/api/reference/rpc/v21/Asset) resource\ndirectly: \n\n SELECT\n asset.id,\n asset.name\n FROM asset\n WHERE asset.source = 'AUTOMATICALLY_CREATED'\n\nReports\n-------\n\nAsset performance statistics can be requested from the\n[`asset_field_type_view`](/google-ads/api/fields/v21/asset_field_type_view) report. This report\nincludes the aggregated stats for both automated and manually added assets.\n\nPerformance stats for individual assets can be retrieved from the\n[`campaign_asset`](/google-ads/api/fields/v21/campaign_asset),\n[`customer_asset`](/google-ads/api/fields/v21/customer_asset), and\n[`ad_group_asset`](/google-ads/api/fields/v21/ad_group_asset) reports."]]