- HTTP 요청
- 경로 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- CampaignToForecast
- CriterionBidModifier
- CampaignBiddingStrategy
- ManualCpcBiddingStrategy에
- MaximizeClicksBiddingStrategy
- MaximizeConversionsBiddingStrategy
- ForecastAdGroup
- BiddableKeyword
- KeywordForecastMetrics
- 실습
지정된 캠페인에 대한 키워드 예측의 측정항목 (예: 노출수, 클릭수, 총 비용)을 반환합니다.
발생한 오류 목록: AuthenticationError AuthorizationError CollectionSizeError HeaderError InternalError QuotaError RequestError
HTTP 요청
POST https://googleads.googleapis.com/v15/customers/{customerId}:generateKeywordForecastMetrics
URL은 gRPC 트랜스코딩 구문을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
customerId |
고객의 ID입니다. |
요청 본문
요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{ "forecastPeriod": { object ( |
필드 | |
---|---|
forecastPeriod |
예측 기간입니다. 시작일은 미래여야 하며 종료일은 오늘부터 1년 이내여야 합니다. 사용된 참조 시간대는 고객에게 속한 Google Ads 계정 중 하나입니다. 설정하지 않으면 다음 주 일요일부터 다음 토요일까지의 기본 기간이 사용됩니다. |
campaign |
필수 항목입니다. 예측에 사용된 캠페인입니다. |
currencyCode |
환율 변환에 사용되는 통화입니다. 기본적으로 고객의 계정 통화가 사용됩니다. 통화가 계정 통화와 다른 경우에만 이 필드를 설정합니다. 유효한 통화 코드 목록은 https://developers.google.com/google-ads/api/data/codes-formats#currency-codes에서 확인할 수 있습니다. |
응답 본문
[KeywordPlanIdeaService.GenerateKeywordForecastMetrics]에 대한 응답 메시지입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"campaignForecastMetrics": {
object ( |
필드 | |
---|---|
campaignForecastMetrics |
캠페인 예측 결과 |
승인 범위
다음 OAuth 범위가 필요합니다.
https://www.googleapis.com/auth/adwords
자세한 내용은 OAuth 2.0 개요를 참고하세요.
CampaignToForecast
키워드 캠페인 예측을 수행할 캠페인입니다.
JSON 표현 |
---|
{ "languageConstants": [ string ], "geoModifiers": [ { object ( |
필드 | |
---|---|
languageConstants[] |
타겟팅할 언어의 리소스 이름 목록입니다. 리소스 이름은 'languageConstants/{criterionId}' 형식입니다. 언어 기준 코드 목록은 https://developers.google.com/google-ads/api/data/codes-formats#languages를 참고하세요. |
geoModifiers[] |
타겟팅할 위치입니다. 위치는 고유해야 합니다. |
keywordPlanNetwork |
필수 항목입니다. 타겟팅에 사용되는 네트워크입니다. |
negativeKeywords[] |
예측을 수행할 때 캠페인에서 사용할 제외 키워드 목록입니다. |
biddingStrategy |
필수 항목입니다. 캠페인의 입찰 전략입니다. |
adGroups[] |
예측할 새 캠페인의 광고그룹입니다. |
conversionRate |
사용자가 정의한 예상 전환율 (전환수를 총 클릭수로 나눈 값)입니다. 이 값은 십진수로 표시되므로 2% 의 예상 전환율은 0.02로 입력해야 합니다. 비워 둘 경우 예상 전환율이 사용됩니다. |
CriterionBidModifier
위치 기준 입찰가 조정입니다.
JSON 표현 |
---|
{ "geoTargetConstant": string, "bidModifier": number } |
필드 | |
---|---|
geoTargetConstant |
타겟팅할 지리적 위치의 리소스 이름입니다. 리소스 이름은 'geoTargetConstants/{criterionId}' 형식입니다. |
bidModifier |
criterionId의 관련 승수입니다. 설정하는 경우 이 값은 0이 될 수 없습니다. |
CampaignBiddingStrategy
새 캠페인 예측에 지원되는 입찰 전략입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 bidding_strategy . 입찰 전략: bidding_strategy 은 다음 중 하나여야 합니다. |
|
manualCpcBiddingStrategy |
예측에 수동 CPC 입찰 전략을 사용합니다. |
maximizeClicksBiddingStrategy |
예측에 클릭수 최대화 입찰 전략을 사용합니다. |
maximizeConversionsBiddingStrategy |
예측에 전환수 최대화 입찰 전략을 사용합니다. |
ManualCpcBiddingStrategy
수동 CPC 입찰 전략
JSON 표현 |
---|
{ "maxCpcBidMicros": string, "dailyBudgetMicros": string } |
필드 | |
---|---|
maxCpcBidMicros |
필수 항목입니다. 수동 CPC 입찰 전략의 경우 캠페인 내 광고그룹에 적용될 마이크로 단위의 입찰가입니다. |
dailyBudgetMicros |
마이크로 단위의 캠페인 수준 예산입니다. 설정된 경우 캠페인에서 사용되는 현지 통화에 대해 최소 금액이 적용됩니다. 이 필드가 너무 낮게 설정되면 최솟값을 표시하는 오류가 발생합니다. |
MaximizeClicksBiddingStrategy
클릭수 최대화 입찰 전략을 사용합니다.
JSON 표현 |
---|
{ "dailyTargetSpendMicros": string, "maxCpcBidCeilingMicros": string } |
필드 | |
---|---|
dailyTargetSpendMicros |
필수 항목입니다. 추정에 사용할 일일 목표 지출액입니다(마이크로 단위). 캠페인에서 사용되는 현지 통화에 대해 최소값이 적용됩니다. 이 필드가 너무 낮게 설정되면 최솟값을 표시하는 오류가 발생합니다. |
maxCpcBidCeilingMicros |
세부 최대 CPC 입찰가 상한 |
MaximizeConversionsBiddingStrategy
전환수 최대화 입찰 전략을 사용합니다.
JSON 표현 |
---|
{ "dailyTargetSpendMicros": string } |
필드 | |
---|---|
dailyTargetSpendMicros |
필수 항목입니다. 추정에 사용할 일일 목표 지출액입니다(마이크로 단위). 이 값은 0보다 커야 합니다. |
ForecastAdGroup
예측할 캠페인에 속한 광고그룹입니다.
JSON 표현 |
---|
{ "biddableKeywords": [ { object ( |
필드 | |
---|---|
biddableKeywords[] |
필수 항목입니다. 예측을 수행할 때 광고그룹에서 사용할 입찰 가능한 키워드의 목록입니다. 키워드가 하나 이상 필요합니다. |
negativeKeywords[] |
키워드의 세부정보입니다. 키워드 텍스트와 검색 유형을 모두 지정해야 합니다. |
maxCpcBidMicros |
예측 트래픽을 생성할 때 광고그룹에 사용할 최대 CPC입니다. 이 값은 입찰 전략에 설정된 최대 CPC 값보다 우선 적용됩니다. CPC 값이 최대인 입찰 전략에만 이 필드를 지정하세요. |
BiddableKeyword
광고 그룹에서 입찰 가능한 키워드 부분입니다.
JSON 표현 |
---|
{
"keyword": {
object ( |
필드 | |
---|---|
keyword |
필수 항목입니다. 키워드. 텍스트와 일치 유형이 있어야 합니다. |
maxCpcBidMicros |
예측 시뮬레이션의 광고그룹 수준 최대 CPC 입찰가보다 우선하는 마이크로 단위의 최대 CPC 입찰가입니다. 이 값은 입찰 전략 및 광고그룹에 설정된 최대 CPC 값보다 우선 적용됩니다. 최대 CPC 값을 지원하는 입찰 전략에만 이 필드를 지정하세요. |
KeywordForecastMetrics
계획 없는 키워드 캠페인에 대한 예측 측정항목입니다.
JSON 표현 |
---|
{ "impressions": number, "clickThroughRate": number, "averageCpcMicros": string, "clicks": number, "costMicros": string, "conversions": number, "conversionRate": number, "averageCpaMicros": string } |
필드 | |
---|---|
impressions |
총 노출수입니다. |
clickThroughRate |
평균 클릭률입니다. 노출수가 0보다 큰 경우에만 사용할 수 있습니다. |
averageCpcMicros |
평균 CPC 클릭수가 0보다 큰 경우에만 사용 가능 |
clicks |
총 클릭수입니다. |
costMicros |
총 비용입니다. |
conversions |
예상 전환수: 클릭수 * conversionRate |
conversionRate |
예상 전환율입니다. |
averageCpaMicros |
평균 전환당비용은 costMicros / 전환수로 계산됩니다. |