저장된 열

이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API를 사용하면 더욱 유연하게 맞춤 보고서를 작성하고, 데이터를 보고 애플리케이션 및 프로세스에 통합할 수 있습니다. 새 Search Ads 360 Reporting API로 이전하고 이를 사용하는 방법에 대해 자세히 알아보세요.

플러드라이트 활동, Google 애널리틱스 목표 또는 맞춤 KPI를 보고하려는 광고주는 Search Ads 360 UI에 로그인하고 플러드라이트 활동 열, Google 애널리틱스 활동 열 또는 수식 열과 같은 저장된 열을 하나 이상 만들면 됩니다. 데이터를 다운로드하거나 보고서를 필터링하도록 저장된 열을 보고서 요청에 포함할 수 있습니다.

저장된 열 목록 가져오기

광고주가 만든 저장된 열을 모두 보려면 SavedColumns.list() 요청을 보냅니다. 응답에는 광고주의 각 열에 대한 savedColumnName 가 포함됩니다.

저장된 열에 대한 보고서 요청

보고서 요청에 저장된 열을 포함하려면 savedColumnName 속성이 열 이름으로 설정된 열을 추가합니다.

{
  "reportType": "advertiser",
  "columns": [
    {
      "savedColumnName": string,
      "headerText": string,
    }
  ],
  "filters": [
    {
      "column": {
        "savedColumnName": string,
      },
      ...
    },
    ...
  ],
  ...
}

저장된 열을 사용할 때는 다음 사항에 유의하세요.

  • 저장된 열은 광고주 수준에서 정의됩니다. 저장된 열을 요청에 포함하는 경우 request.reportScope에서 광고주 또는 더 낮은 범위를 지정해야 합니다. 따라서 각 보고서에는 단일 광고주의 저장된 열만 포함될 수 있습니다.

  • 저장된 열 이름은 대소문자를 구분하고 공백을 구분하며 구두점을 구분합니다. savedColumnName 속성은 저장된 열 이름과 정확하게 일치해야 합니다. 저장된 열의 이름이 동일한 요청의 다른 열 이름과 동일한 경우 Search Ads 360에서는 열 중 하나 또는 두 개 모두에 대해 대체 고유 headerText를 지정해야 합니다.

  • 저장된 열은 언제든지 Search Ads 360 캠페인 관리 UI에서 수정하거나 삭제할 수 있습니다. 저장된 열을 지정하는 요청이 실패하면 요청에서 저장된 열을 삭제하고 다시 전송해 보세요.

  • 증분 보고서에는 API에서 명시적으로 지원하지 않는 측정항목 (예: Google 애널리틱스 활동 열)이 포함될 수 없습니다. 또한 Search Ads 360 사용자는 저장된 열을 재정의할 수 있으므로 저장된 열이 포함된 증분 보고서가 정확하지 않을 수 있습니다.