- 리소스: Audience
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- 작업
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- 가
- JSON 표현
- AudienceSequenceStep
- AudienceClauseType
- 메서드
리소스: Audience
GA4 잠재고객을 나타내는 리소스 메시지입니다.
JSON 표현 |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
입력란 | |
---|---|
name |
출력 전용입니다. 이 잠재고객 리소스의 리소스 이름입니다. 형식: properties/{propertyId}/audiences/{audienceId} |
displayName |
필수 항목입니다. 잠재고객의 표시 이름입니다. |
description |
필수 항목입니다. 잠재고객에 대한 설명입니다. |
membershipDurationDays |
필수 항목입니다. 변경할 수 없습니다. 사용자가 잠재고객에 남아 있어야 하는 기간입니다. 540일을 초과하여 설정할 수 없습니다. |
adsPersonalizationEnabled |
출력 전용입니다. NPA 잠재고객이고 광고 개인 최적화에서 제외된 경우 GA에서 자동으로 false로 설정합니다. |
eventTrigger |
선택사항입니다. 사용자가 잠재고객에 참여할 때 기록할 이벤트를 지정합니다. 설정하지 않으면 사용자가 잠재고객에 참여할 때 이벤트가 기록되지 않습니다. |
exclusionDurationMode |
변경할 수 없습니다. 제외 필터를 충족하는 사용자에 대해 제외가 지속되는 시간을 지정합니다. 모든 EXCLUDE 필터 절에 적용되며 잠재고객에 EXCLUDE 필터 절이 없으면 무시됩니다. |
filterClauses[] |
필수 항목입니다. 변경할 수 없습니다. 순서가 지정되지 않은 목록입니다. 잠재고객을 정의하는 필터 절입니다. 모든 절은 AND로 연결됩니다. |
AudienceEventTrigger
사용자가 잠재고객에 참여할 때 기록할 이벤트를 지정합니다.
JSON 표현 |
---|
{
"eventName": string,
"logCondition": enum ( |
입력란 | |
---|---|
eventName |
필수 항목입니다. 기록될 이벤트 이름입니다. |
logCondition |
필수 항목입니다. 이벤트를 로깅할 시점입니다. |
LogCondition
이벤트를 로깅할 시점을 결정합니다.
열거형 | |
---|---|
LOG_CONDITION_UNSPECIFIED |
로그 조건이 지정되지 않았습니다. |
AUDIENCE_JOINED |
사용자가 조인된 경우에만 이벤트가 기록되어야 합니다. |
AUDIENCE_MEMBERSHIP_RENEWED |
사용자가 이미 잠재고객의 회원인 경우에도 잠재고객 조건이 충족될 때마다 이벤트가 기록되어야 합니다. |
AudienceExclusionDurationMode
제외 필터를 충족하는 사용자에 대해 제외가 지속되는 시간을 지정합니다.
열거형 | |
---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
지정되지 않음 |
EXCLUDE_TEMPORARILY |
필터 조항을 충족하는 기간 동안 사용자를 잠재고객에서 제외합니다. |
EXCLUDE_PERMANENTLY |
필터 조항을 충족한 적이 있는 사용자를 잠재고객에서 제외합니다. |
AudienceFilterClause
단순 필터 또는 시퀀스 필터를 정의하는 절입니다. 필터는 포괄적 (예: 필터 절을 충족하는 사용자가 잠재고객에 포함됨) 또는 배타적 (예: 필터 절을 충족하는 사용자가 잠재고객에서 제외됨)일 수 있습니다.
JSON 표현 |
---|
{ "clauseType": enum ( |
입력란 | |
---|---|
clauseType |
필수 항목입니다. 포함 필터 절인지 제외 필터 절인지 지정합니다. |
통합 필드
|
|
simpleFilter |
사용자가 잠재고객이 되기 위해 충족해야 하는 간단한 필터입니다. |
sequenceFilter |
사용자가 잠재고객에 포함되기 위해 특정한 순서로 발생해야 하는 필터입니다. |
AudienceSimpleFilter
사용자가 잠재고객에 포함되기 위해 충족해야 하는 간단한 필터를 정의합니다.
JSON 표현 |
---|
{ "scope": enum ( |
입력란 | |
---|---|
scope |
필수 항목입니다. 변경할 수 없습니다. 이 필터의 범위를 지정합니다. |
filterExpression |
필수 항목입니다. 변경할 수 없습니다. 잠재고객 측정기준, 측정항목 또는 이벤트 필터의 논리 표현식입니다. |
AudienceFilterScope
잠재고객에 가입하는 사용자를 평가하는 방법을 지정합니다.
열거형 | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
범위가 지정되지 않았습니다. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
이벤트 1개에서 필터 조건이 충족되면 사용자가 잠재고객에 참여합니다. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
한 세션 내에서 필터 조건이 충족되면 사용자가 잠재고객에 참여합니다. |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
세션의 이벤트에서 필터 조건이 충족되면 사용자가 잠재고객에 참여합니다. |
AudienceFilterExpression
잠재고객 측정기준, 측정항목 또는 이벤트 필터의 논리 표현식입니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드 expr . 필터에 적용된 표현식입니다. expr 은 다음 중 하나여야 합니다. |
|
andGroup |
AND로 결합할 표현식의 목록입니다. orGroup이 있는 AudienceFilterExpressions만 포함될 수 있습니다. 최상위 AudienceFilterExpression에 설정되어야 합니다. |
orGroup |
OR로 함께 연결된 표현식 목록입니다. andGroup 또는 orGroup이 있는 AudienceFilterExpressions를 포함할 수 없습니다. |
notExpression |
부정할 필터 표현식입니다 (예: 반전, 보수). dimensionOrMetricFilter만 포함할 수 있습니다. 최상위 AudienceFilterExpression에서는 설정할 수 없습니다. |
dimensionOrMetricFilter |
단일 측정기준 또는 측정항목에 적용되는 필터입니다. 최상위 AudienceFilterExpression에서는 설정할 수 없습니다. |
eventFilter |
특정 이벤트와 일치하는 필터를 만듭니다. 최상위 AudienceFilterExpression에서는 설정할 수 없습니다. |
AudienceFilterExpressionList
잠재고객 필터 표현식의 목록입니다.
JSON 표현 |
---|
{
"filterExpressions": [
{
object ( |
입력란 | |
---|---|
filterExpressions[] |
잠재고객 필터 표현식의 목록입니다. |
AudienceDimensionOrMetricFilter
단일 측정기준 또는 측정항목을 위한 특정 필터입니다.
JSON 표현 |
---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
입력란 | |
---|---|
fieldName |
필수 항목입니다. 변경할 수 없습니다. 필터링할 측정기준 이름 또는 측정항목 이름입니다. 필드 이름이 맞춤 측정기준 또는 측정항목을 참조하는 경우 맞춤 측정기준 또는 측정항목 이름 앞에 범위 접두사가 추가됩니다. 범위 접두사 또는 맞춤 측정기준/측정항목에 대한 자세한 내용은 Google Analytics Data API 문서를 참조하세요. |
atAnyPointInTime |
선택사항입니다. 이 필터에 동적 평가가 필요한지 여부를 나타냅니다. true로 설정하면 사용자가 조건을 충족한 적이 있는 경우 잠재고객에 참여합니다 (정적 평가). 설정하지 않거나 false로 설정하면 잠재고객에 대한 사용자 평가가 동적입니다. 사용자가 조건을 충족하면 잠재고객에 추가되고 더 이상 조건을 충족하지 않으면 삭제됩니다. 잠재고객 범위가 ACROSS_ALL_SESSIONS인 경우에만 설정할 수 있습니다. |
inAnyNDayPeriod |
선택사항입니다. 설정된 경우 데이터를 평가할 기간을 일 수로 지정합니다. 설정하지 않으면 잠재고객 데이터가 전체 기간 데이터 (예: 무한 기간)를 기준으로 평가됩니다. 예를 들어 1일로 설정하면 현재 날짜의 데이터만 평가됩니다. 기준점은 atAnyPointInTime이 설정되지 않거나 false인 현재 날짜입니다. 잠재고객 범위가 ACROSS_ALL_SESSIONS이고 60일을 초과할 수 없는 경우에만 설정할 수 있습니다. |
통합 필드 one_filter . 위의 필터 중 하나입니다. one_filter 은 다음 중 하나여야 합니다. |
|
stringFilter |
특정 패턴과 일치하는 문자열 유형 측정기준의 필터입니다. |
inListFilter |
특정 옵션 목록과 일치하는 문자열 측정기준의 필터입니다. |
numericFilter |
측정기준 또는 측정항목의 숫자 또는 날짜 값에 대한 필터입니다. |
betweenFilter |
측정기준 또는 측정항목에서 특정 값 사이의 숫자 또는 날짜 값에 대한 필터입니다. |
StringFilter
특정 패턴과 일치하는 문자열 유형 측정기준의 필터입니다.
JSON 표현 |
---|
{
"matchType": enum ( |
입력란 | |
---|---|
matchType |
필수 항목입니다. 문자열 필터의 일치 유형입니다. |
value |
필수 항목입니다. 일치시킬 문자열 값입니다. |
caseSensitive |
선택사항입니다. true인 경우 일치 항목이 대소문자를 구분합니다. false인 경우 일치 항목이 대소문자를 구분하지 않습니다. |
MatchType
문자열 필터의 일치 유형입니다.
열거형 | |
---|---|
MATCH_TYPE_UNSPECIFIED |
미지정 |
EXACT |
문자열 값의 정확한 일치입니다. |
BEGINS_WITH |
문자열 값으로 시작합니다. |
ENDS_WITH |
문자열 값으로 끝납니다. |
CONTAINS |
문자열 값을 포함합니다. |
FULL_REGEXP |
전체 정규 표현식이 문자열 값과 일치합니다. |
InListFilter
특정 옵션 목록과 일치하는 문자열 측정기준의 필터입니다.
JSON 표현 |
---|
{ "values": [ string ], "caseSensitive": boolean } |
입력란 | |
---|---|
values[] |
필수 항목입니다. 일치시킬 수 있는 문자열 값의 목록입니다. 비어 있으면 안 됩니다. |
caseSensitive |
선택사항입니다. true인 경우 일치 항목이 대소문자를 구분합니다. false인 경우 일치 항목이 대소문자를 구분하지 않습니다. |
NumericFilter
측정기준 또는 측정항목의 숫자 또는 날짜 값에 대한 필터입니다.
JSON 표현 |
---|
{ "operation": enum ( |
입력란 | |
---|---|
operation |
필수 항목입니다. 숫자 필터에 적용되는 연산입니다. |
value |
필수 항목입니다. 일치시킬 숫자 또는 날짜 값입니다. |
작업
숫자 필터에 적용되는 연산입니다.
열거형 | |
---|---|
OPERATION_UNSPECIFIED |
지정되지 않았습니다. |
EQUAL |
같음 |
LESS_THAN |
보다 작음 |
GREATER_THAN |
보다 큼 |
NumericValue
숫자를 나타냅니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드 one_value . 숫자 값 중 하나입니다. one_value 은 다음 중 하나여야 합니다. |
|
int64Value |
정수 값. |
doubleValue |
Double 값입니다. |
BetweenFilter
측정기준 또는 측정항목에서 특정 값 사이의 숫자 또는 날짜 값에 대한 필터입니다.
JSON 표현 |
---|
{ "fromValue": { object ( |
입력란 | |
---|---|
fromValue |
필수 항목입니다. 이 숫자로 시작합니다. |
toValue |
필수 항목입니다. 이 숫자로 끝납니다(해당 값 포함). |
AudienceEventFilter
단일 이벤트 이름의 이벤트와 일치하는 필터입니다. 이벤트 매개변수가 지정된 경우 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트의 하위 집합만 이 이벤트 필터와 일치합니다.
JSON 표현 |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
입력란 | |
---|---|
eventName |
필수 항목입니다. 변경할 수 없습니다. 일치시킬 이벤트의 이름입니다. |
eventParameterFilterExpression |
선택사항입니다. 지정된 경우 이 필터는 단일 이벤트 이름 및 매개변수 필터 표현식과 모두 일치하는 이벤트와 일치합니다. 매개변수 필터 표현식 내의 AudienceEventFilter를 설정할 수 없습니다 (예: 중첩된 이벤트 필터는 지원되지 않음). dimensionOrMetricFilter 또는 notExpression의 단일 andGroup이어야 합니다. OR의 AND는 지원되지 않습니다. 또한 'eventCount'에 대한 필터가 포함된 경우 이 필터만 고려되고 다른 모든 필터는 무시됩니다. |
AudienceSequenceFilter
사용자가 잠재고객에 포함되기 위해 특정한 순서로 발생해야 하는 필터를 정의합니다.
JSON 표현 |
---|
{ "scope": enum ( |
입력란 | |
---|---|
scope |
필수 항목입니다. 변경할 수 없습니다. 이 필터의 범위를 지정합니다. |
sequenceMaximumDuration |
선택사항입니다. 전체 시퀀스가 발생해야 하는 기간을 정의합니다. 소수점 아래가 최대 9자리까지이고 ' |
sequenceSteps[] |
필수 항목입니다. 순차적인 순서입니다. 시퀀스 필터에 참가하려면 각 단계를 완료해야 합니다. |
AudienceSequenceStep
이 사용자가 시퀀스와 일치시키기 위해 지정된 단계 순서대로 발생해야 하는 조건입니다.
JSON 표현 |
---|
{ "scope": enum ( |
입력란 | |
---|---|
scope |
필수 항목입니다. 변경할 수 없습니다. 이 단계의 범위를 지정합니다. |
immediatelyFollows |
선택사항입니다. true인 경우 이 단계를 충족하는 이벤트는 마지막 단계를 충족하는 이벤트 다음에 오는 이벤트여야 합니다. 설정하지 않거나 false로 설정하면 이 단계가 이전 단계를 간접적으로 따릅니다. 예를 들어 이전 단계와 이 단계 사이에 이벤트가 있을 수 있습니다. 첫 번째 단계에서는 무시됩니다. |
constraintDuration |
선택사항입니다. 설정된 경우 이 단계는 이전 단계의 constraintDuration (예: t[i] - t[i-1] <= constraintDuration) 이내에 충족되어야 합니다. 설정하지 않으면 기간 요구사항이 없습니다 (기간은 사실상 무제한입니다). 첫 번째 단계에서는 무시됩니다. 소수점 아래가 최대 9자리까지이고 ' |
filterExpression |
필수 항목입니다. 변경할 수 없습니다. 각 단계에서 잠재고객 측정기준, 측정항목 또는 이벤트 필터의 논리 표현식입니다. |
AudienceClauseType
포함 필터 절인지 제외 필터 절인지 지정합니다.
열거형 | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
지정되지 않은 절 유형입니다. |
INCLUDE |
필터 절이 충족되면 사용자가 잠재고객에 포함됩니다. |
EXCLUDE |
필터 절이 충족되면 사용자가 잠재고객에서 제외됩니다. |
방법 |
|
---|---|
|
속성의 잠재고객을 보관처리합니다. |
|
잠재고객을 만듭니다. |
|
단일 잠재고객을 조회합니다. |
|
속성의 잠재고객을 나열합니다. |
|
속성의 잠재고객을 업데이트합니다. |