與最高成效廣告活動報表類似,您可以使用 GoogleAdsService.SearchStream
擷取廣告活動和素材資源群組的結構描述資料,以便改善廣告活動並排除常見問題。
廣告活動最佳化
如要瞭解最高成效廣告活動可達成的不同業務目標,請參閱最高成效廣告活動的最佳化提示。這些提示同樣適用於透過 Google Ads API 建立的最高成效廣告活動。
廣告活動疑難排解
如果最高成效廣告活動的成效不如預期,問題可能出在廣告、出價、指定目標、轉換追蹤或廣告活動設定。如要瞭解疑難排解步驟,請參閱下列指南:
常見的素材資源群組錯誤
如果您建立 AssetGroup
的請求失敗,且 AssetGroupError
和以 NOT_ENOUGH
開頭的列舉值 (例如 AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET
) 也失敗,表示您的 AssetGroup
未符合最低素材資源需求,因此未建立。
舉例來說,AssetGroupError.NOT_ENOUGH_MARKETING_IMAGE_ASSET
錯誤會指出建立 AssetGroup
的要求未附上 MARKETING_IMAGES
的最低數量,在本例中為 1 個。如要修正這項錯誤,請重新提交要求,使用 GoogleAdsService.mutate
方法建立 AssetGroup
做為批次變更要求,其中包含 asset_group_operation
和任何缺少的 asset_group_asset_operations
,如 將素材資源群組連結至素材資源 所示。
在這個範例中,大量變更要求中的變更作業清單必須包含至少一個 AssetGroupAsset
,且 field_type
為 MARKETING_IMAGE
。AssetGroupAsset
參照的資產也必須符合 MARKETING_IMAGE
的規格。
同樣地,如果您建立 AssetGroup
的要求因 AssetGroupError.SHORT_DESCRIPTION_REQUIRED
而失敗,表示您的 AssetGroup
缺少 60 個字元以下的 TEXT
資產,以及 DESCRIPTION
的 field_type
。修正這個問題的步驟與 NOT_ENOUGH_MARKETING_IMAGE_ASSET
範例相同。不過,要求中必須包含至少一個 AssetGroupAsset
,且其 field_type
為 DESCRIPTION
,而 AssetGroupAsset
參照的素材資源必須為 60 個半形字元以下。
素材資源群組疑難排解
您可以使用 asset_group.primary_status
和 asset_group.primary_status_reasons
欄位,深入瞭解素材資源群組的成效。
SELECT
asset_group.resource_name,
asset_group.primary_status,
asset_group.primary_status_reasons
FROM asset_group
WHERE asset_group.resource_name = "customers/CUSTOMER_ID/assetGroups/ASSET_GROUP_ID"
同樣地,asset_group_asset.primary_status
、asset_group_asset.primary_status_details
和 asset_group_asset.primary_status_reasons
欄位可用於顯示素材資源群組資產是否正在放送,或未放送的原因。
SELECT
asset_group_asset.resource_name,
asset_group_asset.primary_status,
asset_group_asset.primary_status_reasons,
asset_group_asset.primary_status_details
FROM asset_group_asset
WHERE asset_group_asset.resource_name = "customers/CUSTOMER/assetGroupAssets/ASSET_GROUP_ID~ASSET_ID~FIELD_TYPE"
已啟用品牌宣傳指南的廣告活動
運用品牌宣傳指南,控管最高成效廣告活動中的品牌呈現方式。您可以使用 Campaign.brand_guidelines_enabled
驗證廣告活動是否已啟用品牌宣傳指南。
Campaign.brand_guidelines_enabled
設為 true
的最高成效廣告活動會使用廣告活動層級品牌素材資源 (BUSINESS_NAME
、LOGO
和 LANDSCAPE_LOGO
),且必須具備以下條件:
- 只有一個
BUSINESS_NAME
素材資源 - 至少提供一個
LOGO
素材資源
如果您無法正確連結這些 CampaignAsset
資源,系統會根據缺少的資產類型,傳回 CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED
或 CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED
錯誤。下列任何動作都可能觸發品牌規範啟用廣告活動的這些錯誤:
- 建立新的
Campaign
時,未在同一個要求中同時提供BUSINESS_NAME
和LOGO
做為CampaignAsset
資源。 - 移除一或多項
CampaignAsset
資源,導致廣告活動不再符合最低品牌素材資源要求。 - 在先前的無素材資源線上銷售最高成效廣告活動中加入素材資源群組層級素材資源,但未在同一項要求中提供所有必要的
CampaignAsset
資源。
如果嘗試在錯誤的層級連結品牌素材資源,也會產生錯誤,您可以按照下列方式修正:
AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL
- 使用CampaignAsset
資源連結品牌資產,因為廣告活動已啟用品牌規範。AssetLinkError.BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL
- 使用AssetGroupAsset
資源連結品牌素材資源,因為廣告活動未啟用品牌規範。
素材資源來源
最高成效廣告活動的獨特之處在於,廣告中包含的素材資源是由廣告主上傳,並由 Google 自動產生。廣告客戶可以透過瞭解素材資源的來源,解決問題或評估成效,因此可以使用 asset_group_asset.source
欄位,如下所示:
SELECT
asset.id,
asset.name,
asset_group.id,
asset_group_asset.source
FROM asset_group_asset
WHERE campaign.id = CAMPAIGN_ID
獲取新客目標的轉換價值
如果您在最高成效廣告活動或搜尋廣告活動中設定獲取新客目標,系統回報的轉換價值可能會高於您手動上傳的轉換價值。如果您選取「新客價值」模式 (出價更高),系統會將全新顧客的生命週期價值加進轉換動作的轉換價值。新顧客終身價值僅可透過 Google Ads 網頁介面查看。
如果您需要計算轉換價值,但不包含所有新客的終身價值,請參閱下列擬似程式碼。您可以從 Google Ads 網頁介面下載新顧客終身價值。
nonNewCustomerAcquisitionConversionValueTotal = 0;
// For each campaign that has that conversion...
for (campaign in campaigns) {
// If the new customer acquisition value is 'Bid higher', then subtract.
if (bidHigher == true) {
nonNewCustomerAcquisitionConversionValueTotal +=
campaign.allConversionsValue - campaign.allNewCustomerLifetimeValue;
}
// If the new customer acquisition value is 'Only bid' or not set, then don't subtract.
else {
nonNewCustomerAcquisitionConversionValueTotal += campaign.allConversionsValue;
}
}