보고서 유형: bidStrategy

입찰 전략의 실적 측정항목 및 구성 속성입니다.

이 보고서는 비동기식 요청 (즉, Reports.request() 메서드)으로만 반환할 수 있습니다.

발췌 요청

일반 Reports.request() 요청 본문을 전송하지만 "reportType": "bidStrategy"를 지정합니다. 

{
...
  "reportType": "bidStrategy",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

보고서에서 반환하거나 필터링하려는 각 열에 대해 아래 표에 나열된 columnName를 지정합니다. 원하는 경우 headerText, startDate, endDate를 지정할 수도 있습니다. 일부 열은 필터링할 수 없습니다. 아래 표의 '필터링 가능'을 참고하세요.

columnName설명동작유형필터링 가능
status 입찰 전략의 상태입니다(Active, Paused 또는 Removed). 속성 Status 예
creationTimestamp ISO 8601 형식의 입찰 전략 생성 타임스탬프입니다. 속성 Timestamp 예
lastModifiedTimestamp 입찰 전략이 가장 최근에 수정된 타임스탬프입니다(ISO 8601 형식). 속성 Timestamp 예
agency 대행사 이름입니다. 속성 String 예
agencyId DS 대행사 ID입니다. 속성 ID 예
advertiser 광고주 이름 속성 String 예
advertiserId DS 광고주 ID 속성 ID 예
bidStrategyId DS 입찰 전략 ID입니다. 속성 ID 예
bidStrategy 입찰 전략 이름입니다. 속성 String 예
bidStrategyGoal 입찰 전략의 목표: Position, Conversions, Revenue, Clicks, Advanced targeting 속성 Bid strategy goal 예
floodlightOptimizationEnabled 입찰 전략에서 특정 플러드라이트 활동을 타겟팅하는지 여부입니다. 속성 Boolean 예
ersTarget 입찰 전략의 타겟 ERS (유효 수익 점유율) 비율입니다. 속성 Number 예
cpaTarget 입찰 전략의 타겟 CPA (액션당비용)입니다. 속성 Money 예
roasTarget 입찰 전략의 타겟 ROAS (광고 투자수익) 비율입니다. 속성 Number 예
lowPosition 광고를 게재할 수 있는 가장 낮은 위치 (숫자가 더 큼)입니다. 예를 들어 위치 범위가 2~5인 경우 5가 lowPosition입니다. 속성 Number 예
highPosition 광고를 게재할 수 있는 가장 높은 위치 (숫자가 더 작음)입니다. 예를 들어 2~5의 위치 범위에서 2는 highPosition입니다. 속성 Number 예
bidStrategyMinBid 이 입찰 전략에서 키워드에 적용할 수 있는 최저 입찰가입니다. 속성 Money 예
bidStrategyMaxBid 이 입찰 전략에서 키워드에 대해 가능한 가장 높은 입찰가입니다. 속성 Money 예
monthlySpendTarget 이 입찰 전략의 각 월별 목표 지출액입니다. 필요한 경우 DS는 이 금액이 지출되도록 입찰가를 높입니다. 속성 Money 예
floodlightActivityTargetIds 이 입찰 전략에서 타겟팅하는 플러드라이트 활동 ID를 쉼표로 구분한 목록입니다. 속성 String 예
dfaActions Campaign Manager 액션의 총 개수입니다. 측정항목 Integer 예
dfaRevenue Campaign Manager 거래에서 발생한 총수익입니다. 측정항목 Money 예
dfaTransactions Campaign Manager 거래의 총 개수입니다. 측정항목 Integer 예
dfaWeightedActions Campaign Manager 액션의 가중치 합계입니다. 측정항목 Number 예
dfaActionsCrossEnv 교차 환경 캠페인 관리자 액션의 총 수입니다. 측정항목 Number 예
dfaRevenueCrossEnv 교차 환경 Campaign Manager 거래에서 발생한 총수익입니다. 측정항목 Money 예
dfaTransactionsCrossEnv 교차 환경 Campaign Manager 거래의 총 개수입니다. 측정항목 Number 예
dfaWeightedActionsCrossEnv 교차 환경 Campaign Manager 액션의 가중치 합계입니다. 측정항목 Number 예
avgCpc 평균 클릭당비용입니다. 측정항목 Money 예
avgCpm 평균 1,000회 노출당비용 측정항목 Money 예
avgPos 평균 게재순위 측정항목 Number 예
clicks 클릭수를 집계합니다. 측정항목 Integer 예
cost 엔진 계정에 지급된 총 비용입니다. 측정항목 Money 예
ctr 평균 클릭률입니다. 측정항목 Number 예
impr 총 노출수입니다. 측정항목 Integer 예
adWordsConversions 광고주가 Google Ads 전환수 열에 보고되도록 설정한 데이터입니다. Google Ads 전환 액션이 생성되면 광고주는 전환 보고 열에서 해당 전환을 집계할지 여부를 선택할 수 있습니다. 측정항목 Number 예
adWordsConversionValue Google Ads 전환의 집계된 가치입니다. 측정항목 Number 예
adWordsViewThroughConversions 총 Google Ads 조회 후 전환수입니다. 측정항목 Integer 예
visits DS 방문의 총 개수입니다. 측정항목 Integer 예
date 보고서를 일별로 분류합니다. 각 행과 집계 측정항목은 일별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 날짜를 반환합니다. 세그먼트 Date 예
monthStart 보고서를 월별로 분류합니다. 각 행과 집계 측정항목은 월별로 여러 행으로 분할됩니다. 이 열은 각 행의 월 1일을 반환합니다. 세그먼트 Date 예
monthEnd 보고서를 월별로 분류합니다. 각 행과 집계 측정항목은 월별로 여러 행으로 분할됩니다. 이 열은 각 행의 월 마지막 날짜를 반환합니다. 세그먼트 Date 예
quarterStart 보고서를 분기별로 분류합니다. 각 행과 집계 측정항목은 분기별로 여러 행으로 분할됩니다. 이 열은 각 행의 분기 첫날을 반환합니다. 세그먼트 Date 예
quarterEnd 보고서를 분기별로 분류합니다. 각 행과 집계 측정항목은 분기별로 여러 행으로 분할됩니다. 이 열은 각 행의 분기 마지막 날짜를 반환합니다. 세그먼트 Date 예
weekStart 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 집계 측정항목은 주별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 첫 번째 날짜 (일요일)를 반환합니다. 세그먼트 Date 예
weekEnd 보고서를 주 (일요일~토요일)별로 분류합니다. 각 행과 집계 측정항목은 주별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 마지막 날 (토요일)을 반환합니다. 세그먼트 Date 예
yearStart 보고서를 연도별로 분류합니다. 각 행과 집계 측정항목은 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 첫날을 반환합니다. 세그먼트 Date 예
yearEnd 보고서를 연도별로 분류합니다. 각 행과 집계 측정항목은 연도별로 하나씩 여러 행으로 분할됩니다. 이 열은 각 행의 연도 마지막 날짜를 반환합니다. 세그먼트 Date 예