잠재고객 내보내기 만들기

Google 애널리틱스의 잠재고객 비즈니스에 중요한 사용자층을 분류할 수 있습니다. 다음으로 바꿉니다. 공유 기능을 기반으로 사이트 또는 애플리케이션의 사용자를 속성

사용자 개요를 포함하여 잠재고객을 내보낼 수 있습니다. Data API.

잠재고객 내보내기 데이터 기대치를 참고하세요. 잠재고객 내보내기에 표시되는 데이터에 대한 중요한 정보 가이드를 참조하세요.

개요

잠재고객 내보내기를 만들고 쿼리하려면 다음 Data API를 요청합니다.

  1. audienceExports.create를 호출합니다. 메서드를 사용하여 잠재고객 내보내기를 만들 수 있습니다.
  2. audienceExports.query를 호출합니다. 메서드는 잠재고객의 사용자를 검색하는 데 사용됩니다.

자세한 내용은 audienceExports.get(으)로 특정 잠재고객 내보내기에 대한 구성 메타데이터 검색 audienceExports.list 도착 특정 속성에 대한 모든 잠재고객 내보내기를 나열합니다.

신고 항목 선택

모든 Data API 메서드에는 Google 애널리틱스 속성이 필요합니다. 식별자properties/GA_PROPERTY_ID 형태입니다. 예를 들면 다음과 같습니다.

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

이 보고서는 다음에서 수집된 Google 애널리틱스 이벤트 데이터를 기반으로 생성됩니다. 지정된 Google 애널리틱스 속성으로 이동합니다.

Data API 클라이언트 라이브러리 중 하나를 사용하는 경우 요청 URL 경로를 변경할 필요가 없습니다. 대부분의 API 클라이언트는 property properties/GA_PROPERTY_ID 형식의 문자열을 예상하는 매개변수입니다. 자세한 내용은 사용 예시를 보려면 빠른 시작 가이드를 참고하세요. 클라이언트 라이브러리를 사용해 만들 수 있습니다.

잠재고객 내보내기 만들기

잠재고객 내보내기를 만들려면 다음을 사용하여 audienceExports.create 메서드를 호출합니다. AudienceExport 객체를 요청할 수 있습니다. 다음 매개변수가 필요합니다.

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

다음은 잠재고객 내보내기를 만들기 위한 요청의 예입니다.

HTTP 요청

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

audienceExports.create 메서드의 응답에는 다음과 같은 잠재고객 내보내기의 name 필드에 입력합니다(예: properties/1234567/audienceExports/123). 다음은 샘플 응답입니다.

HTTP 응답

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

name를 사용하여 잠재고객 내보내기에서 사용자를 쿼리할 수 있습니다.

잠재고객 내보내기의 준비 상태 쿼리

생성 후 잠재고객 내보내기를 생성하는 데 몇 분 정도 걸릴 수 있습니다. audienceExports.create 드림 있습니다.

다음을 호출하여 잠재고객 내보내기의 준비 상태를 확인할 수 있습니다. audienceExports.get 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다.

audienceExports.create 응답에서 잠재고객 내보내기 이름을 사용하여 다음을 수행합니다. 요청에 잠재고객 내보내기를 지정하세요.

다음은 샘플 요청입니다.

HTTP 요청

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

잠재고객 내보내기의 준비 상태가 state 필드에 반환됩니다. 확인할 수 있습니다 잠재고객 내보내기 생성이 완료되면 CREATING에서 ACTIVE로 변경됩니다.

다음은 샘플 응답입니다.

HTTP 응답

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

다음과 같이 audienceExports.list 드림 메서드를 사용하여 축소하도록 요청합니다.

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

잠재고객 내보내기가 생성되면 audienceExports.query 메서드를 호출하고 요청에서 잠재고객 내보내기의 name를 반환합니다.

다음은 샘플 요청입니다.

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
}