REST Resource: properties.audienceExports

리소스: AudienceExport

잠재고객 내보내기는 목록 생성 시점의 잠재고객에 속한 사용자 목록입니다. 한 잠재고객에 다른 날에 대해 생성된 여러 잠재고객 내보내기가 있을 수 있습니다.

JSON 표현
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
필드
name

string

출력 전용입니다. 식별자. 생성 중에 할당된 잠재고객 내보내기 리소스 이름입니다. 이 리소스 이름으로 이 AudienceExport를 식별합니다.

형식: properties/{property}/audienceExports/{audienceExport}

audience

string

필수 항목입니다. 잠재고객 리소스 이름입니다. 나열 중인 잠재고객을 식별하고 애널리틱스 데이터 및 Admin API로 이동합니다.

형식: properties/{property}/audiences/{audience}

audienceDisplayName

string

출력 전용입니다. 잠재고객을 설명하는 표시 이름입니다. 예: '구매자'

dimensions[]

object (AudienceDimension)

필수 항목입니다. 쿼리 응답에 요청되고 표시된 측정기준입니다.

creationQuotaTokensCharged

integer

출력 전용입니다. AudienceExport 생성 중에 청구되는 총 할당량 토큰입니다. 이 토큰 수는 CREATING 상태의 활동을 기반으로 하므로 AudienceExport가 ACTIVE 또는 FAILED 상태가 되면 청구된 토큰이 고정됩니다.

state

enum (State)

출력 전용입니다. 이 AudienceExport의 현재 상태입니다.

beginCreatingTime

string (Timestamp format)

출력 전용입니다. AudienceExports.create가 호출되고 AudienceExport가 CREATING 상태를 시작한 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

rowCount

integer

출력 전용입니다. AudienceExport 결과의 총 행 수입니다.

errorMessage

string

출력 전용입니다. 생성 중에 잠재고객 내보내기가 실패하면 오류 메시지가 채워집니다. 이러한 실패의 일반적인 이유는 할당량 소진입니다.

percentageCompleted

number

출력 전용입니다. 0~100 사이의 잠재고객 내보내기가 완료된 비율입니다.

AudienceDimension

잠재고객 측정기준은 사용자 속성입니다. 특정 사용자 기여 분석이 요청된 후 나중에 QueryAudienceExportResponse에서 반환됩니다.

JSON 표현
{
  "dimensionName": string
}
필드
dimensionName

string

선택사항입니다. 측정기준의 API 이름입니다. 측정기준 이름 목록은 API 측정기준을 참고하세요.

AudienceExport가 현재 이 상태에 있습니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태는 사용되지 않습니다.
CREATING 현재 잠재고객 내보내기를 생성 중이며 향후 사용할 수 있습니다. AudienceExports.create 호출 직후에 만들기가 이루어집니다.
ACTIVE AudienceExport가 완전히 생성되었으며 쿼리할 준비가 되었습니다. AudienceExport가 요청에서 비동기식으로 업데이트됩니다. 최초 생성 호출 후 일정 시간 (예: 15분)이 지난 후에 발생합니다.
FAILED AudienceExport를 생성할 수 없습니다. 이 잠재고객 내보내기를 다시 요청하면 성공할 수 있습니다.

메서드

create

나중에 검색할 수 있도록 잠재고객 내보내기를 만듭니다.

get

특정 잠재고객 내보내기에 대한 구성 메타데이터를 가져옵니다.

list

속성의 모든 잠재고객 내보내기를 나열합니다.

query

사용자의 잠재고객 내보내기를 검색합니다.