REST Resource: properties.recurringAudienceLists

리소스: RecurringAudienceList

반복 잠재고객 목록은 매일 새 잠재고객 목록을 생성합니다. 잠재고객 목록은 목록 생성 시점에 잠재고객에 포함된 사용자입니다. 반복 잠재고객 목록을 사용하면 매일 사용 가능한 최신 데이터를 기반으로 한 잠재고객 목록을 이용할 수 있습니다.

JSON 표현 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
필드
name

string

출력 전용입니다. 식별자. 생성 중에 할당된 반복 잠재고객 목록 리소스 이름입니다. 이 리소스 이름으로 이 RecurringAudienceList를 식별합니다.

형식: properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

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

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

string

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

object (AudienceDimension)

필수 항목입니다. 잠재고객 목록 응답에 요청되고 표시된 측정기준입니다.
audienceLists[]

string

출력 전용입니다. 이 반복 잠재고객 목록에 대해 생성된 잠재고객 목록 인스턴스의 잠재고객 목록 리소스 이름입니다. 잠재고객 목록은 매일 하나씩 생성되며, 잠재고객 목록이 여기에 표시됩니다.

이 목록은 가장 최근에 생성된 잠재고객 목록 순으로 정렬됩니다.
activeDaysRemaining

integer

선택사항입니다. 반복 잠재고객 내보내기가 잠재고객 목록 인스턴스를 생성할 남은 일수입니다. 이 카운터는 매일 하나씩 감소하며, 0에 도달하면 새 잠재고객 목록이 생성되지 않습니다.

애널리틱스 360 속성의 반복되는 잠재고객 목록 요청은 기본적으로 180일로 설정되어 있고 최대 기간은 365일입니다. 표준 애널리틱스 속성에 대한 요청은 기본적으로 14일로 설정되며, 최대 30일까지 설정할 수 있습니다.

생성 중에 허용되는 최솟값은 1입니다. 각 최댓값을 초과하는 요청은 최댓값으로 강제 적용됩니다.
webhookNotification

object (WebhookNotification)

선택사항입니다. Google Analytics Data API에서 웹훅 서버로 전송될 웹훅 알림을 구성합니다. 웹훅 사용은 선택사항입니다. 사용하지 않는 경우 이 API를 폴링하여 반복 잠재고객 목록이 새 잠재고객 목록을 만드는 시점을 확인해야 합니다. 웹훅을 사용하면 서버에 알림을 보낼 수 있으며 폴링할 필요성을 피합니다

반복 잠재고객 목록이 잠재고객 목록을 만들 때마다 2개의 POST 요청이 전송됩니다. 이 작업은 반복 잠재고객 목록의 활성 일수가 0에 도달할 때까지 하루에 한 번 발생합니다. 새로 생성된 잠재고객 목록이 생성 중 상태인 첫 번째 요청이 전송됩니다. 두 번째 요청은 잠재고객 목록이 생성된 후에 (활성 또는 실패 상태) 전송됩니다.

메서드

create

 반복 잠재고객 목록을 만듭니다.

get

 특정 반복 잠재고객 목록에 대한 구성 메타데이터를 가져옵니다.

list

 속성의 모든 반복 잠재고객 목록을 나열합니다.