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

필수 항목입니다. 잠재고객 리소스 이름입니다. 이 리소스 이름은 나열되는 잠재고객을 식별하고 Analytics Data & 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를 폴링하여 반복 잠재고객 목록에서 새 잠재고객 목록을 만드는 시기를 확인해야 합니다. 웹훅을 사용하면 알림을 서버에 전송할 수 있으므로 폴링할 필요가 없습니다.

반복되는 잠재고객 목록이 잠재고객 목록을 만들 때마다 POST 요청이 두 번 전송됩니다. 반복 잠재고객 목록의 활성 일수가 0일이 될 때까지 하루에 한 번 반복됩니다. 생성 중 상태의 새로 생성된 잠재고객 목록을 보여주는 첫 번째 요청이 전송됩니다. 잠재고객 목록 생성이 완료된 후 (활성 또는 실패 상태) 두 번째 요청이 전송됩니다.

방법

create

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

get

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

list

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