반복 잠재고객 목록

이 문서에서는 반복 잠재고객 목록인 고급 기능을 제공합니다. 잠재고객 목록 내보내기 기능에 대한 소개는 잠재고객 내보내기 기본사항 가이드를 참고하세요.

반복되는 잠재고객 목록은 매일 다음과 같이 잠재고객 목록을 생성합니다. 잠재고객 멤버십이 변경되어 최신 데이터로 작업할 수 있습니다.

일반 (반복되지 않음) 잠재고객 목록은 잠재고객의 정적 사용자 목록입니다. 목록이 생성된 시점에 적용됩니다.

매일 새 잠재고객 목록 만들기

하루 동안의 잠재고객 데이터를 처리하고 업데이트하는 데 소요되는 시간은 각기 다릅니다. 멤버십입니다. 다음에서 잠재고객 목록 데이터가 업데이트되도록 할 수 있는 방법은 없습니다. 24시간이 걸립니다.

예를 들어 매일 같은 시간에 잠재고객 목록을 요청하더라도 어떤 날에는 잠재고객 목록이 다른 날에는 잠재고객 목록이 다르며 멤버십 변경 날이 추가로 포함됩니다.

매일 새 잠재고객 목록 만들기

잠재고객 목록은 가장 최근 날짜 전날의 이벤트 데이터를 기반으로 합니다. 멤버십 변경사항 일일 멤버십 전에 잠재고객 목록을 만드는 경우 업데이트가 이루어지면 이틀 전의 데이터가 사용됩니다. 만약 매일 멤버십이 업데이트된 후 어제

반복 잠재고객 목록을 주기적으로 폴링합니다.

반복 잠재고객 목록은 날짜가 더 늦어질 때만 잠재고객 목록을 생성합니다. 데이터를 사용할 수 있습니다. 이렇게 하면 새로운 콘텐츠를 언제 만들지 어림짐작하여 잠재고객 목록을 클릭합니다. 대신 저렴하게 반복 잠재고객 목록을 대상으로 설문조사를 실시할 수 있습니다. 확인할 수 있습니다.

하루 동안 반복되는 잠재고객 목록을 주기적으로 폴링합니다.

반복 잠재고객 목록 만들기

반복 잠재고객 목록을 만들려면 recurringAudienceLists.create 드림 메서드를 RecurringAudienceList 객체를 요청할 수 있습니다 다음 매개변수가 필요합니다.

  • 올바른 잠재고객 이름은 audience 드림 필드로, properties/{propertyId}/audiences/{audienceId} 형식으로 지정됩니다. 이 audiences.list 드림 메서드를 사용하여 이 값을 얻어야 합니다. 이 Audience.name 드림 audiences.list 응답의 필드에는 잠재고객 이름이 포함됩니다.
  • dimensions 드림 필드를 확인합니다. 이 메서드가 지원하는 측정기준 목록은 다음에서 확인할 수 있습니다. 잠재고객 내보내기 스키마 문서를 참조하세요. 이 필드에 언급된 측정기준의 데이터만 잠재고객 목록

다음은 반복 잠재고객 목록 생성 요청의 예입니다.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

recurringAudienceLists.create 메서드의 응답에는 name 필드의 이름 (예: properties/1234567/recurringAudienceLists/123)를 사용하며, 이는 다음에서 사용할 수 있습니다. 구성 메타데이터를 검색하는 후속 쿼리 확인할 수 있습니다 또한 구성 메타데이터에는 잠재고객 목록 인스턴스의 리소스 이름 이 반복 잠재고객 목록에 대해 생성됩니다.

HTTP 응답

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

폴링 구성 메타데이터

사용 recurringAudienceLists.get 드림 메서드를 사용하여 특정 애플리케이션에 대한 구성 메타데이터를 반복 잠재고객 목록 구성 메타데이터에는 잠재고객 목록 인스턴스의 리소스 이름 이 반복 잠재고객 목록에 대해 생성됩니다.

예를 들면 다음과 같습니다.

HTTP 요청

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

RecurringAudienceList의 인스턴스 반환됩니다. 여기에는 구성 메타데이터가 포함되며, 잠재고객 목록 인스턴스의 리소스 이름 이 반복 잠재고객 목록에 대해 생성됩니다.

HTTP 응답

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

이때 recurringAudienceLists.list 드림 속성의 반복 잠재고객 목록을 모두 나열합니다.

웹훅을 사용하여 새 잠재고객 목록에 대한 비동기 알림 수신

특정 포드에 대한 구성 메타데이터를 주기적으로 폴링하는 대신 반복 잠재고객 목록, 즉 recurringAudienceLists.get 드림 메서드를 사용하면 잠재고객이 요청을 수신했을 때 비동기식으로 목록을 사용할 수 있게 됩니다.

웹훅 알림을 구성하려면 webhookNotification 드림 필드를 설정할 수 없습니다.

Async audience lists with webhooks 가이드 따르기 를 참조하세요.

잠재고객 내보내기에서 사용자 가져오기

잠재고객 내보내기에서 사용자를 검색하려면 audienceExports.query 드림 방법을 선택하고 잠재고객 내보내기 이름을 구성 메타데이터에서 가져올 수 있으며, recurringAudienceLists.get 또는 recurringAudienceLists.list입니다.

HTTP 요청

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

잠재고객 내보내기가 준비되면 다음과 같이 잠재고객의 사용자가 반환됩니다.

HTTP 응답

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}