傳回與指定目標對象相關的一組指定目標洞察 (例如可指定目標對象)。
擲回錯誤清單:AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。客戶的 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "audience": { object ( |
欄位 | |
---|---|
audience |
必要欄位。要求取得其洞察資料的目標對象。 |
baselineAudience |
選用設定。基準目標對象。如未特別指定,預設設定是與感興趣的目標對象位於相同國家/地區的所有使用者。 |
dataMonth |
選用設定。用於深入分析的一個月歷來資料範圍,格式為「yyyy-mm」。如未設定,系統會傳回最近三十天的洞察資料。 |
customerInsightsGroup |
選用設定。預定進行遷移的客戶名稱。這是使用者定義的值, |
回應主體
「AudienceInsightsService.GenerateSuggestedTargetingInsights
」的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"suggestions": [
{
object ( |
欄位 | |
---|---|
suggestions[] |
建議的指定目標對象洞察資料。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
TargetingSuggestionMetrics
與要求的目標對象相關的建議目標對象。
JSON 表示法 |
---|
{ "locations": [ { object ( |
欄位 | |
---|---|
locations[] |
建議的指定地區。這些屬性全都具有維度「GEO_TARGET_COUNTRY」或「SUB_COUNTRY_LOCATION」 |
ageRanges[] |
建議的年齡指定目標;可能空白,表示未指定年齡。 |
gender |
建議的性別。如果有,此屬性的維度為「GENDER」。 |
userInterests[] |
建議指定的目標對象區隔。這些屬性全都具有維度「AFFINITY_USER_INTEREST」或「IN_MARKET_USER_INTEREST」 |
coverage |
使用建議指定目標可觸及的目標對像比例 (從 0 到 1,含 0 到 1)。 |
index |
未定義這個比例或不具意義時,其涵蓋率與基準目標對象涵蓋率的比率,如果這個比率未定義或不具意義,則為 0。 |
potentialYoutubeReach |
使用這個指定目標時,可在 YouTube 上觸及的預估觀眾人數。 |