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

필수 항목입니다. 잠재고객 리소스 이름입니다. 이 리소스 이름은 표시되는 잠재고객을 식별하며 애널리틱스 데이터 API와 Admin API 간에 공유됩니다.

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

string

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

object (AudienceDimension)

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

string

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

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

integer

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

애널리틱스 360 속성의 반복 잠재고객 목록 요청은 기본적으로 180일이며 최대 365일입니다. 표준 애널리틱스 속성의 요청은 기본적으로 14일이며 최대 30일입니다.

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

object (WebhookNotification)

선택사항입니다. Google 애널리틱스 Data API에서 웹훅 서버로 전송되는 웹훅 알림을 구성합니다. 웹훅 사용은 선택사항입니다. 사용하지 않는 경우 이 API를 폴링하여 반복되는 잠재고객 목록이 새 잠재고객 목록을 생성하는 시점을 확인해야 합니다. Webhook을 사용하면 서버로 알림을 전송할 수 있으며 폴링할 필요가 없습니다.

반복 잠재고객 목록이 잠재고객 목록을 만들 때마다 두 개의 POST 요청이 전송됩니다. 반복되는 잠재고객 목록의 활성 기간이 0일 남을 때까지 하루에 한 번 실행됩니다. 새로 생성된 잠재고객 목록이 CREATING 상태로 표시된 첫 번째 요청이 전송됩니다. 두 번째 요청은 잠재고객 목록 생성이 완료된 후 (ACTIVE 또는 FAILED 상태) 전송됩니다.

메서드

create

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

get

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

list

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