REST Resource: curators.dataSegments

리소스: DataSegment

거래 또는 입찰 패키지 UI에서 큐레이터 또는 미디어 기획자가 타겟팅할 수 있는 인벤토리 세그먼트의 식별자를 정의합니다. 인벤토리 선별은 외부 플랫폼의 큐레이터가 수행합니다. -- 다음 ID: 9 --

JSON 표현
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "state": enum (State),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "cpmFee": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
  "userListId": string
}
필드
name

string

변경할 수 없습니다. 식별자. 데이터 세그먼트의 고유 식별자입니다. 계정 ID는 세그먼트를 만든 계정 ID에 해당합니다. 형식: curators/{curatorAccountId}/dataSegments/{curatorDataSegmentId}

createTime

string (Timestamp format)

출력 전용입니다. 데이터 세그먼트가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 데이터 세그먼트가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.

state

enum (State)

출력 전용입니다. 데이터 세그먼트의 상태입니다.

다른 계정에서 이 데이터 세그먼트를 사용하면 수수료가 청구됩니다. 예를 들어 다른 계정에서 이 데이터 세그먼트를 거래 또는 입찰 패키지에 추가하는 경우입니다. 데이터 세그먼트의 수수료 유형은 설정 후 변경할 수 없습니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 최대 하나의 필드가 설정됩니다.
cpmFee

object (Money)

선택사항입니다. 1,000회 노출당 청구되는 고정 수수료입니다. 통화 코드는 설정 후 변경할 수 없습니다.

millipercentOfMediaFee

string (int64 format)

선택사항입니다. 수수료는 노출 비용의 백분율로 청구되며, 밀리퍼센트로 표시됩니다. 예를 들어 1% 는 1000으로 표시됩니다.

상호 배타적 필드의 끝입니다.
userListId

string

선택사항입니다. 변경할 수 없습니다. 이 데이터 세그먼트로 래핑된 사용자 목록의 ID입니다.

연결된 데이터 파트너 계정이 있는 큐레이터는 연결된 데이터 파트너 계정이 소유한 사용자 목록을 래핑하는 데이터 세그먼트를 만들 수 있습니다. Data Manager API를 사용하여 사용자 목록을 업로드하고 관리할 수 있습니다. 사용자 목록을 데이터 세그먼트에 연결하면 내가 만든 잠재고객을 기반으로 인벤토리 세그먼트를 정의할 수 있습니다.

주

출력 전용입니다. 활성화 및 비활성화 메서드를 사용하여 상태를 변경합니다.

열거형
STATE_UNSPECIFIED 기본값
ACTIVE 데이터 세그먼트가 활성 상태입니다.
INACTIVE 데이터 세그먼트가 비활성 상태입니다.
SUSPENDED 데이터 세그먼트가 정지되어 활성화할 수 없습니다.

메서드

activate

데이터 세그먼트를 활성화합니다.

create

나열된 큐레이터가 소유한 데이터 세그먼트를 만듭니다.

deactivate

데이터 세그먼트를 비활성화합니다.

get

이름이 지정된 데이터 세그먼트를 가져옵니다.

list

큐레이터가 소유한 데이터 세그먼트를 나열합니다.

patch

데이터 세그먼트를 업데이트합니다.