UserList

사용자 목록. 고객이 타겟팅할 수 있는 사용자의 목록입니다.

JSON 표현
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  },
  "lookalikeUserList": {
    object (LookalikeUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
입력란
resourceName

string

변경할 수 없습니다. 사용자 목록의 리소스 이름입니다. 사용자 목록 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/userLists/{userListId}

membershipStatus

enum (UserListMembershipStatus)

이 사용자 목록의 가입 상태입니다. 사용자 목록이 열려 있는지 또는 활성 상태인지를 나타냅니다. 열려 있는 사용자 목록만 더 많은 사용자를 집계할 수 있으며 타겟팅될 수 있습니다.

sizeRangeForDisplay

enum (UserListSizeRange)

출력 전용. Google 디스플레이 네트워크에 표시되는 UserList의 크기 범위입니다.

이 필드는 읽기 전용입니다.

type

enum (UserListType)

출력 전용. 이 목록의 유형입니다.

이 필드는 읽기 전용입니다.

closingReason

enum (UserListClosingReason)

이 사용자 목록 멤버십 상태가 종료된 이유를 표시합니다. 활동이 없어 자동으로 닫은 목록에만 채워지며 목록 멤버십 상태가 활성화되면 지워집니다.

accessReason

enum (AccessReason)

출력 전용. 이 계정에 목록 액세스 권한이 부여된 이유를 나타냅니다. 공유됨, 소유함, 라이선스 보유 또는 구독됨일 수 있습니다.

이 필드는 읽기 전용입니다.

accountUserListStatus

enum (UserListAccessStatus)

이 공유가 아직 사용 설정되어 있는지 나타냅니다. UserList를 사용자와 공유하는 경우 이 필드는 ENABLED로 설정됩니다. 나중에 userList 소유자가 공유를 취소하고 이를 사용 중지할 수 있습니다. 이 입력란의 기본값은 '사용'으로 설정되어 있습니다.

id

string (int64 format)

출력 전용. 사용자 목록의 ID입니다.

readOnly

boolean

출력 전용. 사용자가 목록을 수정할 수 있는지 여부를 나타내는 옵션입니다. 목록 소유권 및 목록 유형에 따라 다릅니다. 예를 들어 외부 리마케팅 사용자 목록은 수정할 수 없습니다.

이 필드는 읽기 전용입니다.

name

string

이 사용자 목록의 이름입니다. accessReason에 따라 사용자 목록 이름이 고유하지 않을 수 있습니다 (예: accessReason=SHARED인 경우).

description

string

이 사용자 목록에 대한 설명입니다.

integrationCode

string

외부 시스템의 ID입니다. 사용자 목록 판매자가 시스템의 ID를 상호 연결하는 데 사용됩니다.

membershipLifeSpan

string (int64 format)

사용자의 쿠키가 가장 최근에 목록에 추가된 이후 해당 목록에 남아 있는 일수입니다. 이 필드는 0 이상 540 이하여야 합니다. 하지만 CRM 기반 사용자 목록의 경우 이 필드를 10000으로 설정할 수 있으므로 만료되지 않습니다.

logicalUserList 및 RulesBasedUserList 유형의 경우 이 필드가 무시됩니다. 이러한 유형의 목록에 대한 가입 여부는 목록에 정의된 규칙에 따라 다릅니다.

sizeForDisplay

string (int64 format)

출력 전용. Google 디스플레이 네트워크에서 이 사용자 목록에 있는 예상 사용자 수입니다. 사용자 수가 아직 확인되지 않은 경우 이 값은 null입니다.

이 필드는 읽기 전용입니다.

eligibleForDisplay

boolean

출력 전용. 이 사용자 목록이 Google 디스플레이 네트워크에 게재될 수 있음을 나타냅니다.

이 필드는 읽기 전용입니다.

matchRatePercentage

integer

출력 전용. 고객 일치 타겟팅 목록의 일치율을 나타냅니다. 이 필드의 범위는 [0-100]입니다. 다른 목록 유형 또는 일치율을 계산할 수 없는 경우 null이 됩니다.

이 필드는 읽기 전용입니다.

통합 필드 user_list. 사용자 목록입니다.

정확히 1개를 설정해야 합니다. user_list는 다음 중 하나여야 합니다.

crmBasedUserList

object (CrmBasedUserListInfo)

광고주가 제공한 CRM 사용자의 사용자 목록입니다.

similarUserList

object (SimilarUserListInfo)

출력 전용. 다른 사용자 목록의 사용자와 유사한 사용자 목록입니다. 이 목록은 읽기 전용이며 Google에서 자동으로 생성됩니다.

ruleBasedUserList

object (RuleBasedUserListInfo)

규칙에 의해 생성된 사용자 목록입니다.

logicalUserList

object (LogicalUserListInfo)

사용자 목록과 사용자 관심분야의 맞춤 조합인 사용자 목록입니다.

basicUserList

object (BasicUserListInfo)

전환 또는 리마케팅 액션의 모음으로서의 사용자 목록 타겟팅입니다.

lookalikeUserList

object (LookalikeUserListInfo)

변경할 수 없습니다. 유사한 사용자 목록.

UserListMembershipStatus

가능한 사용자 목록 멤버십 상태를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
OPEN 공개 상태 - 목록에 회원이 추가되고 있으며 목록을 타겟팅할 수 있습니다.
CLOSED 차단 상태 - 새 회원이 추가되고 있지 않습니다. 타겟팅에 사용할 수 없습니다.

UserListSizeRange

가능한 사용자 목록 크기 범위를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LESS_THAN_FIVE_HUNDRED 사용자 목록의 사용자가 500명 미만입니다.
LESS_THAN_ONE_THOUSAND 사용자 목록의 사용자 수가 500~1,000명입니다.
ONE_THOUSAND_TO_TEN_THOUSAND 사용자 목록의 사용자 수가 1,000~10,000명입니다.
TEN_THOUSAND_TO_FIFTY_THOUSAND 사용자 목록의 사용자 수가 10,000~50,000명입니다.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND 사용자 목록의 사용자 수가 50,000~100,000명입니다.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND 사용자 목록의 사용자 수가 100,000~300,000명입니다.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND 사용자 목록의 사용자 수가 300,000~500,000명입니다.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION 사용자 목록의 사용자 수가 500,000~100만 명입니다.
ONE_MILLION_TO_TWO_MILLION 사용자 목록의 사용자 수는 1~2백만 명입니다.
TWO_MILLION_TO_THREE_MILLION 사용자 목록의 사용자 수는 2~3백만 명입니다.
THREE_MILLION_TO_FIVE_MILLION 사용자 목록의 사용자 수가 3~5백만 명입니다.
FIVE_MILLION_TO_TEN_MILLION 사용자 목록의 사용자 수가 5~1천만 명입니다.
TEN_MILLION_TO_TWENTY_MILLION 사용자 목록의 사용자 수가 1천만~2천만 명입니다.
TWENTY_MILLION_TO_THIRTY_MILLION 사용자 목록의 사용자 수가 2천만 명에서 3천만 명 사이입니다.
THIRTY_MILLION_TO_FIFTY_MILLION 사용자 목록의 사용자 수가 3천만~5천만 명입니다.
OVER_FIFTY_MILLION 사용자 목록에는 5천만 명 이상의 사용자가 있습니다.

UserListType

가능한 사용자 목록 유형을 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
REMARKETING 전환 유형의 집합으로 표현되는 UserList입니다.
LOGICAL 다른 사용자 목록/관심분야의 조합으로 표현되는 UserList입니다.
EXTERNAL_REMARKETING Google Ad Manager 플랫폼에서 생성된 UserList입니다.
RULE_BASED 규칙과 연결된 UserList입니다.
SIMILAR 다른 UserList의 사용자와 유사한 사용자가 있는 UserList입니다.
CRM_BASED 광고주가 이메일 또는 기타 형식의 형태로 제공한 퍼스트 파티 CRM 데이터의 사용자 목록입니다.
LOOKALIKE 구성 가능한 시드 (UserLists 집합)의 사용자와 유사한 사용자로 구성된 LookalikeUserlist

UserListClosingReason

가능한 사용자 목록 종료 이유를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
UNUSED 사용자 목록이 1년 이상 사용되지 않아 닫혔습니다.

AccessReason

가능한 액세스 이유를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
OWNED 사용자가 소유한 리소스입니다.
SHARED 리소스가 사용자와 공유됩니다.
LICENSED 사용자에게 리소스의 라이선스가 부여됩니다.
SUBSCRIBED 사용자가 리소스를 구독했습니다.
AFFILIATED 사용자가 리소스에 액세스할 수 있습니다.

UserListAccessStatus

가능한 사용자 목록 액세스 상태를 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 액세스가 사용 설정되었습니다.
DISABLED 액세스가 사용 중지되었습니다.

CrmBasedUserListInfo

광고주가 제공한 CRM 사용자의 사용자 목록입니다.

JSON 표현
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
입력란
uploadKeyType

enum (CustomerMatchUploadKeyType)

목록의 일치하는 키 유형입니다. 동일한 목록에서 혼합된 데이터 유형은 허용되지 않습니다. 이 필드는 ADD 연산 시 필요합니다.

dataSourceType

enum (UserListCrmDataSourceType)

목록의 데이터 소스입니다. 기본값은 FIRST_PARTY입니다. 허용 목록에 있는 고객만 서드 파티 출처 CRM 목록을 만들 수 있습니다.

appId

string

데이터가 수집된 모바일 애플리케이션을 고유하게 식별하는 문자열입니다. iOS의 경우 ID 문자열은 App Store URL 끝에 표시되는 9자리 문자열입니다 (예: 'Flood-It!'의 경우 '476943146' 2'를 입력합니다.http://itunes.apple.com/us/app/flood-it!-2/id476943146) Android의 경우 ID 문자열은 애플리케이션의 패키지 이름입니다 (예: Google Play 링크가 지정된 'Color Drips'의 경우 'com.labpixies.colordrips' https://play.google.com/store/apps/details?id=com.labpixies.colordrips). 모바일 광고 ID를 업로드하기 위해 CrmBasedUserList를 만들 때 필요합니다.

CustomerMatchUploadKeyType

가능한 고객 일치 타겟팅 업로드 키 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CONTACT_INFO 이메일 주소, 전화번호, 실제 주소와 같은 고객 정보를 기준으로 회원을 일치시킵니다.
CRM_ID 구성원은 광고주가 생성하고 할당한 사용자 ID와 일치합니다.
MOBILE_ADVERTISING_ID 모바일 광고 ID를 통해 회원을 일치시킵니다.

UserListCrmDataSourceType

가능한 사용자 목록 crm 데이터 소스 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
FIRST_PARTY 업로드된 데이터는 퍼스트 파티 데이터입니다.
THIRD_PARTY_CREDIT_BUREAU 서드 파티 신용 기관에서 제공한 데이터를 업로드했습니다.
THIRD_PARTY_VOTER_FILE 업로드된 데이터는 제3자 유권자 파일에서 가져온 것입니다.

SimilarUserListInfo

SimilarUserList는 다른 사용자 목록의 사용자와 유사한 사용자 목록입니다. 이러한 목록은 읽기 전용이며 Google에서 자동으로 생성됩니다.

JSON 표현
{
  "seedUserList": string
}
입력란
seedUserList

string

이 목록이 파생된 시드 UserList입니다.

RuleBasedUserListInfo

규칙에 의해 생성된 사용자 목록을 나타냅니다.

JSON 표현
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
입력란
prepopulationStatus

enum (UserListPrepopulationStatus)

자동 입력의 상태입니다. 설정하지 않으면 필드의 기본값은 'NONE'으로, 이전 사용자는 고려되지 않습니다. REQUESTED로 설정하면 목록 정의와 일치하는 이전 사이트 방문자 또는 앱 사용자가 목록에 포함됩니다 (디스플레이 네트워크에서만 작동). 이렇게 하면 목록의 가입 기간과 리마케팅 태그가 추가된 날짜에 따라 최근 30일 이내의 이전 사용자만 추가됩니다. 요청이 처리되면 상태가 FINISHED로, 요청이 실패하면 실패로 업데이트됩니다.

flexibleRuleUserList

object (FlexibleRuleUserListInfo)

방문자가 하나 또는 여러 개의 작업으로 규칙을 유연하게 표현할 수 있습니다. 유연한 사용자 목록은 두 가지 피연산자 목록, 즉 다음을 포괄하는 피연산자와 배타적인 피연산자로 정의됩니다. 각 피연산자는 지정된 기간에 사용자가 실행한 작업을 기반으로 한 사용자 집합을 나타냅니다. 이러한 피연산자 목록은 AND_NOT 연산자와 결합되므로 포괄적 피연산자로 표현되는 사용자는 사용자 목록에 포함되며 배타적 피연산자가 나타내는 사용자는 제외됩니다.

UserListPrepopulationStatus

가능한 사용자 목록 자동 입력 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
REQUESTED Prepopoulation을 요청하는 중입니다.
FINISHED 자동 입력이 완료되었습니다.
FAILED 자동 입력에 실패했습니다.

FlexibleRuleUserListInfo

방문자가 하나 또는 여러 개의 작업으로 규칙을 유연하게 표현할 수 있습니다. 유연한 사용자 목록은 두 가지 피연산자 목록, 즉 다음을 포괄하는 피연산자와 배타적인 피연산자로 정의됩니다. 각 피연산자는 지정된 기간에 사용자가 실행한 작업을 기반으로 한 사용자 집합을 나타냅니다. 이러한 피연산자 목록은 AND_NOT 연산자와 결합되므로 포괄적 피연산자로 표현되는 사용자는 사용자 목록에 포함되며 배타적 피연산자가 나타내는 사용자는 제외됩니다.

JSON 표현
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
입력란
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

포괄적인 피연산자가 결합되는 방식을 정의하는 연산자.

inclusiveOperands[]

object (FlexibleRuleOperandInfo)

사용자 목록에 포함되어야 하는 사용자를 나타내는 규칙입니다. 이는 AND_NOT 연산자의 왼쪽에 있으며, inclusiveRuleOperator에서 지정한 대로 AND/OR로 결합됩니다.

exclusiveOperands[]

object (FlexibleRuleOperandInfo)

사용자 목록에서 제외되어야 하는 사용자를 나타내는 규칙입니다. 이들은 AND_NOT 연산자의 오른쪽에 있으며 OR로 결합됩니다.

UserListFlexibleRuleOperator

가능한 사용자 목록 결합 규칙 연산자를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AND A AND B
OR A OR B

FlexibleRuleOperandInfo

공통 규칙과 전환 확인 기간을 래핑하는 유연한 규칙

JSON 표현
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
입력란
rule

object (UserListRuleInfo)

이 규칙을 정의하는 규칙 항목 그룹의 목록입니다. 규칙 항목 그룹은 함께 그룹화됩니다.

lookbackWindowDays

string (int64 format)

이 규칙의 전환 확인 기간(일)입니다. 오늘부터 X일 전까지

UserListRuleInfo

웹사이트에서 전송하거나 광고주가 업로드한 맞춤 매개변수를 기반으로 고객이 정의한 규칙입니다.

JSON 표현
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
입력란
ruleType

enum (UserListRuleType)

규칙 유형은 규칙 항목을 그룹화하는 방법을 결정하는 데 사용됩니다.

기본값은 AND의 OR (논리합 표준형)입니다. 즉, 규칙 항목은 규칙 항목 그룹 내에서 AND로 연결되고 그룹 자체는 OR로 연결됩니다.

OR은 FlexibleRuleUserList에 지원되는 유일한 유형입니다.

ruleItemGroups[]

object (UserListRuleItemGroupInfo)

이 규칙을 정의하는 규칙 항목 그룹의 목록입니다. 규칙 항목 그룹은 규칙 유형을 기준으로 그룹화됩니다.

UserListRuleType

가능한 사용자 목록 규칙 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AND_OF_ORS 접속사 표준형입니다.
OR_OF_ANDS 논리합 표준형입니다.

UserListRuleItemGroupInfo

규칙 항목의 그룹입니다.

JSON 표현
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
입력란
ruleItems[]

object (UserListRuleItemInfo)

RulesType을 기준으로 그룹화될 규칙 항목입니다.

UserListRuleItemInfo

원자적 규칙 항목.

JSON 표현
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
입력란
name

string

규칙 변수 이름입니다. 픽셀에 의해 실행된 해당 키 이름과 일치해야 합니다. 이름은 US-ASCII 문자, 밑줄 또는 127 이상의 UTF8 코드로 시작하고 US-ASCII 문자, 숫자, 밑줄 또는 127 이상의 UTF8 코드로 구성되어야 합니다. 웹사이트의 경우 두 가지 기본 제공 변수 URL (name = 'url__')과 리퍼러 URL (name = 'ref_url__')이 있습니다. 이 필드는 새 규칙 항목을 만들 때 채워야 합니다.

통합 필드 rule_item. 원자적 규칙 항목. rule_item은 다음 중 하나여야 합니다.
numberRuleItem

object (UserListNumberRuleItemInfo)

숫자 연산으로 구성된 원자 규칙 항목입니다.

stringRuleItem

object (UserListStringRuleItemInfo)

문자열 연산으로 구성된 원자적 규칙 항목입니다.

dateRuleItem

object (UserListDateRuleItemInfo)

날짜 연산으로 구성된 원자적 규칙 항목입니다.

UserListNumberRuleItemInfo

숫자 연산으로 구성된 규칙 항목입니다.

JSON 표현
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
입력란
operator

enum (UserListNumberRuleItemOperator)

숫자 비교 연산자입니다. 이 필드는 필수이며 새 숫자 규칙 항목을 만들 때 채워야 합니다.

value

number

변수와 비교할 숫자 값입니다. 이 필드는 필수이며 새 숫자 규칙 항목을 만들 때 채워야 합니다.

UserListNumberRuleItemOperator

가능한 사용자 목록 번호 규칙 항목 연산자를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
GREATER_THAN 보다 큼
GREATER_THAN_OR_EQUAL 크거나 같습니다.
EQUALS 같음
NOT_EQUALS 같지 않음
LESS_THAN 보다 작음
LESS_THAN_OR_EQUAL 작거나 같습니다.

UserListStringRuleItemInfo

문자열 연산으로 구성된 규칙 항목입니다.

JSON 표현
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
입력란
operator

enum (UserListStringRuleItemOperator)

문자열 비교 연산자입니다. 이 필드는 필수이며 새 문자열 규칙 항목을 만들 때 채워야 합니다.

value

string

문자열 규칙 항목의 오른쪽입니다. URL 또는 리퍼러 URL의 경우 값에 줄바꿈, 따옴표, 탭 또는 괄호와 같은 잘못된 URL 문자가 포함될 수 없습니다. 이 필드는 필수이며 새 문자열 규칙 항목을 만들 때 채워야 합니다.

UserListStringRuleItemOperator

가능한 사용자 목록 문자열 규칙 항목 연산자를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CONTAINS 포함
EQUALS 같음
STARTS_WITH 다음으로 시작합니다.
ENDS_WITH 다음으로 끝납니다.
NOT_EQUALS 같지 않음
NOT_CONTAINS 포함되지 않음
NOT_STARTS_WITH 다음으로 시작하지 않음
NOT_ENDS_WITH 다음으로 끝나지 않음.

UserListDateRuleItemInfo

날짜 연산으로 구성된 규칙 항목입니다.

JSON 표현
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
입력란
operator

enum (UserListDateRuleItemOperator)

날짜 비교 연산자입니다. 이 필드는 필수이며 새 날짜 규칙 항목을 만들 때 채워야 합니다.

value

string

규칙 변수와 비교할 날짜 값을 나타내는 문자열입니다. 지원되는 날짜 형식은 YYYY-MM-DD입니다. 시간은 고객의 시간대로 보고됩니다.

offsetInDays

string (int64 format)

오른쪽의 상대적인 날짜 값은 지금으로부터의 오프셋 일수로 표시됩니다. 두 필드가 모두 있는 경우 값 필드가 이 필드를 재정의합니다.

UserListDateRuleItemOperator

가능한 사용자 목록 날짜 규칙 항목 연산자를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EQUALS 같음
NOT_EQUALS 같지 않음
BEFORE 이전.
AFTER 이후

LogicalUserListInfo

사용자 목록의 맞춤 조합인 사용자 목록을 나타냅니다.

JSON 표현
{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}
입력란
rules[]

object (UserListLogicalRuleInfo)

이 사용자 목록을 정의하는 논리적 목록 규칙입니다. 규칙은 논리 연산자 (ALL/ANY/NONE) 및 사용자 목록 목록으로 정의됩니다. 모든 규칙은 평가될 때 AND로 연결됩니다.

논리적 사용자 목록을 만드는 데 필요합니다.

UserListLogicalRuleInfo

사용자 목록 논리적 규칙입니다. 규칙에는 논리 연산자 (and/or/not)가 있으며 사용자 목록 목록이 피연산자로 사용됩니다.

JSON 표현
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
입력란
operator

enum (UserListLogicalRuleOperator)

규칙의 논리적 연산자입니다.

ruleOperands[]

object (LogicalUserListOperandInfo)

규칙의 피연산자 목록입니다.

UserListLogicalRuleOperator

가능한 사용자 목록 논리 규칙 연산자를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ALL And - 모든 피연산자가 있어야 합니다.
ANY Or - 피연산자 중 하나 이상.
NONE Not - 피연산자 중 어느 것도 없습니다.

LogicalUserListOperandInfo

사용자 목록으로 구성된 논리적 사용자 목록의 피연산자입니다.

JSON 표현
{
  "userList": string
}
입력란
userList

string

피연산자인 사용자 목록의 리소스 이름입니다.

BasicUserListInfo

전환 또는 리마케팅 액션의 모음으로서의 사용자 목록 타겟팅입니다.

JSON 표현
{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}
입력란
actions[]

object (UserListActionInfo)

이 사용자 목록과 관련된 작업입니다.

UserListActionInfo

리마케팅 사용자 목록을 만드는 데 사용되는 작업 유형을 나타냅니다.

JSON 표현
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
입력란
통합 필드 user_list_action. 사용자 목록 작업의 하위유형 user_list_action은 다음 중 하나여야 합니다.
conversionAction

string

리마케팅에서 생성되지 않은 전환 액션입니다.

remarketingAction

string

리마케팅 액션입니다.

LookalikeUserListInfo

구성 가능한 시드 (UserLists 집합)의 사용자와 유사한 사용자로 구성된 LookalikeUserlist

JSON 표현
{
  "seedUserListIds": [
    string
  ],
  "expansionLevel": enum (LookalikeExpansionLevel),
  "countryCodes": [
    string
  ]
}
입력란
seedUserListIds[]

string (int64 format)

사용자가 제공한, 이 목록이 파생된 시드 사용자 목록 ID입니다.

expansionLevel

enum (LookalikeExpansionLevel)

유사 잠재고객의 규모를 반영하는 확장 수준

countryCodes[]

string

유사 항목에서 타겟팅하는 국가입니다. ISO-3166에 정의된 두 자리 국가 코드입니다.

LookalikeExpansionLevel

유사 잠재고객의 규모를 반영하는 확장 수준

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 확장 수준이 잘못되었습니다.
NARROW 시드 목록과 유사한 소수의 사용자로 확장
BALANCED 시드 목록과 유사한 중간 규모의 사용자 그룹으로 확장합니다. EXPANSION_LEVEL_NARROW의 모든 사용자 등을 포함합니다.
BROAD 시드 목록과 유사한 대규모 사용자 집합으로 확장합니다. EXPANSION_LEVEL_BalanceD의 모든 사용자 등을 포함합니다.