Google 애널리틱스 4의 잠재고객을 사용하면 비즈니스에 중요한 방식으로 사용자를 분류할 수 있습니다. 잠재고객을 사용하면 공유 속성을 기반으로 사이트 또는 애플리케이션의 사용자를 그룹화할 수 있습니다.
Google Analytics Data API v1을 사용하면 잠재고객에 속한 사용자의 스냅샷이 포함된 잠재고객 내보내기를 생성할 수 있습니다.
잠재고객 내보내기 만들기
Google Analytics Data API v1은 비동기식 접근 방식을 사용하여 잠재고객 내보내기를 만듭니다. 먼저 사용자의 대상 내보내기를 만들려면 audienceExports.create 메서드에 대한 요청이 필요합니다. 그런 다음 audienceExports.query 메서드를 사용하여 잠재고객의 사용자를 검색합니다.
또한 audienceExports.get를 사용하여 특정 잠재고객 내보내기에 대한 구성 메타데이터를 검색하고 audienceExports.list를 사용하여 속성의 모든 잠재고객 내보내기를 나열할 수 있습니다.
신고 항목 선택
Data API v1의 모든 메서드는 다음과 같이 properties/GA4_PROPERTY_ID 형식의 URL 요청 경로 내에 Google 애널리틱스 4 속성 식별자를 지정해야 합니다.
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
보고서는 지정된 Google 애널리틱스 4 속성에서 수집된 Google 애널리틱스 이벤트 데이터를 기반으로 생성됩니다.
Data API 클라이언트 라이브러리 중 하나를 사용하는 경우 요청 URL 경로를 수동으로 조작할 필요가 없습니다.
대부분의 API 클라이언트는 properties/GA4_PROPERTY_ID 형식의 문자열을 예상하는 property 매개변수를 제공합니다.
클라이언트 라이브러리 사용 예는 빠른 시작 가이드를 참고하세요.
잠재고객 내보내기 생성 요청
잠재고객 내보내기를 만들려면 요청에서 AudienceExport 객체를 사용하여 audienceExports.create 메서드를 호출합니다. 다음 매개변수가 필요합니다.
audience필드에properties/{propertyId}/audiences/{audienceId}형식으로 지정된 유효한 잠재고객 이름입니다. Google 애널리틱스 Admin API v1의audiences.list메서드를 사용하여 이 값을 가져올 수 있습니다.audiences.list응답의Audience.name필드에는 잠재고객 이름이 포함됩니다.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"
}
}
잠재고객 내보내기 준비 상태 쿼리
audienceExports.create 호출 후 잠재고객 내보내기를 생성하는 데 몇 분 정도 걸릴 수 있습니다. audienceExports.get 메서드를 호출하여 잠재고객 내보내기를 위한 준비 상태를 가져올 수 있습니다.
audienceExports.create 응답에서 받은 잠재고객 내보내기 이름 (예: properties/1234567/audienceExports/123)을 사용하여 잠재고객 내보내기를 지정합니다.
예:
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.create 메서드를 사용하여 만든 잠재고객 내보내기가 생성되면 audienceExports.query 메서드를 호출하고 잠재고객 내보내기 이름(예: properties/1234567/audienceExports/123)을 지정합니다.
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
}
잠재고객 내보내기 데이터 기대치
다음 섹션에서는 잠재고객 내보내기의 사용자 멤버십에 대한 데이터 기대치를 설정합니다.
데이터 최신 상태
잠재고객 내보내기 데이터 최신성은 Google 애널리틱스에서 이벤트를 수집하고, 이벤트를 처리한 후, 잠재고객의 사용자 멤버십을 업데이트하는 데 걸리는 시간을 의미합니다. 이 전체 프로세스가 24시간이 걸릴 경우 잠재고객 내보내기 데이터의 업데이트 빈도는 24시간입니다. 자세한 내용은 데이터 최신성을 참고하세요.
예를 들어 사용자가 첫 구매를 완료한 후 7시간 후에 '구매자' 잠재고객용 잠재고객 내보내기를 만들면 사용자는 '구매자' 잠재고객 내보내기에 아직 포함되지 않을 가능성이 높습니다. 첫 구매 후 14~38시간 이내에 사용자는 새 잠재고객 내보내기에 포함될 가능성이 높습니다.
잠재고객 내보내기는
잠재고객 내보내기는 특정 시점의 스냅샷에 대한 잠재고객의 사용자 목록입니다. Google Ads 리마케팅의 경우 Google 애널리틱스는 잠재고객의 사용자를 자동으로 계속 Google Ads로 내보냅니다. 반면 Data API v1을 사용하여 만든 잠재고객 내보내기의 경우 해당 잠재고객의 최신 사용자를 보려면 새 잠재고객 내보내기를 만들어야 합니다.
잠재고객 내보내기는 사용 가능한 최신 사용자 멤버십을 기반으로 생성됩니다. 하지만 잠재고객 내보내기의 데이터 업데이트 빈도는 20시간 정도이므로 잠재고객 내보내기는 현재 시점으로부터 20시간 전의 모든 이벤트를 기반으로 합니다.
최신 멤버십 데이터는 하루에 한 번(일반적으로 속성 시간대의 일광 절약 시간 동안) 업데이트됩니다. 즉, 오전 9시와 오전 11시에 동일한 잠재고객에 대한 잠재고객 내보내기를 실행하면 동일한 데이터가 반환될 가능성이 높지만 오후 3시의 잠재고객 내보내기는 추가 날짜의 데이터를 포함하는 여부에 따라 다를 수 있습니다.
잠재고객 내보내기 만료
잠재고객 내보내기는 72시간 후에 만료됩니다. 신규 사용자는 매일 잠재고객에 들어가거나 나갈 수 있습니다. 최신 사용자 스냅샷을 가져오려면 매일 새로운 잠재고객 내보내기를 만들어야 합니다.
잠재고객 내보내기 사용자 한도
잠재고객 또는 속성의 크기가 사용자 한도를 초과하면 잠재고객 내보내기가 잠재고객의 대표 샘플을 반환합니다. 이러한 한도는 속성 유형 (예: 표준 또는 360 속성)에 따라 다르며 각 잠재고객 내보내기에 개별적으로 적용됩니다. 재방문자는 요청된 잠재고객의 사용자이며, 해당 사용자는 잠재고객의 구성원일 수도 있고 아닐 수도 있는 사용자입니다.
| 한도 유형 | 표준 속성 한도 | 애널리틱스 360 속성 한도 |
|---|---|---|
| 최대 재방문자 수 | 200만 | 2억 개 |
| 고려되는 최대 사용자 수 | 1천만 | 10억 |
보고 ID 일관성
보고 ID는 보고서에서 사용자가 중복 삭제되는 방식을 결정합니다. 잠재고객 내보내기는 보고 ID 설정에 따라 변경되지 않습니다. 잠재고객 내보내기는 항상 사용자 ID와 기기 ID로 사용자를 식별합니다.
즉, 잠재고객에 대한 보고서에 잠재고객 내보내기에서 반환되는 사용자보다 더 많은 사용자가 표시될 수 있습니다. 예를 들어 보고 ID가 '기기 기반'이고 사용자 ID가 수집되는 경우 보고서에서는 사용자 ID를 기준으로 사용자 중복을 삭제하지 않지만 잠재고객 내보내기에서는 사용자 ID를 기준으로 중복 사용자를 삭제합니다.
백필 일관성
Google 애널리틱스에서 잠재고객을 만들고 Google Ads 리마케팅을 사용 설정하면 Google 애널리틱스가 최근에 추가된 멤버로 Google Ads의 해당 잠재고객을 백필합니다. 하지만 Google 애널리틱스 보고서 및 잠재고객 내보내기에는 백필된 잠재고객 멤버십이 포함되지 않습니다. 보고서 및 잠재고객 내보내기에서 해당 잠재고객의 사용자를 표시하려면 잠재고객을 만든 후 사용자가 이벤트를 로깅해야 합니다.
예를 들어 사용자가 6월 20일에 구매 이벤트를 기록하고 개발자가 6월 21일에 '구매자' 잠재고객을 만드는 경우 6월 22일까지 기다려야 해당 사용자가 새 잠재고객 내보내기에 표시될 수 있습니다. 하지만 이 사용자는 6월 21일에 이벤트를 로깅한 경우에만 잠재고객 내보내기에 포함됩니다.