- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- TargetingSuggestionMetrics
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 실습
요청된 잠재고객과 관련된 타겟팅 통계 (예: 타겟 가능한 잠재고객)의 모음을 반환합니다.
발생한 오류 목록: AudienceInsightsError AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateSuggestedTargetingInsights
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
필수 항목입니다. 고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "audience": { object ( |
필드 | |
---|---|
audience |
필수 항목입니다. 통계를 요청 중인 관심 잠재고객입니다. |
baselineAudience |
선택사항입니다. 기준 잠재고객입니다. 지정되지 않은 경우 기본값은 관심 잠재고객과 같은 국가에 있는 모든 사람입니다. |
dataMonth |
선택사항입니다. 통계에 사용할 이전 데이터의 1개월 기간이며 'yyyy-mm' 형식입니다. 설정하지 않으면 지난 30일간의 데이터에 대한 통계가 반환됩니다. |
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)입니다. |
index |
기준 잠재고객의 노출 범위에 대한 노출 범위 비율입니다. 이 비율이 정의되지 않았거나 의미가 없는 경우에는 0입니다. |
potentialYoutubeReach |
이 타겟팅을 사용하여 YouTube에서 도달할 수 있는 대략적인 사용자 수입니다. |