AudienceMember

작업할 잠재고객 구성원입니다.

JSON 표현 
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // Union field data can be only one of the following:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  }
  // End of list of possible types for union field data.
}
필드
destinationReferences[]

string

선택사항입니다. 잠재고객 구성원을 보낼 Destination을 정의합니다.
consent

object (Consent)

선택사항입니다. 사용자의 동의 설정입니다.
통합 필드 data. 작업할 식별 데이터의 유형입니다. data은 다음 중 하나여야 합니다.
userData

object (UserData)

사용자를 식별하는 사용자 제공 데이터입니다.
pairData

object (PairData)

게시자와 광고주의 식별 정보 매칭 솔루션 (PAIR) ID

이 기능은 데이터 파트너만 사용할 수 있습니다.
mobileData

object (MobileData)

사용자의 휴대기기를 식별하는 데이터입니다.
userIdData

object (UserIdData)

광고주가 정의한 사용자의 고유 식별자와 관련된 데이터입니다.
ppidData

object (PpidData)

게시자 제공 식별자와 관련된 데이터입니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.
compositeData

object (CompositeData)

여러 식별자 유형의 그룹입니다.

PairData

잠재고객의 PAIR ID입니다. 하나 이상의 PAIR ID가 필요합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

JSON 표현 
{
  "pairIds": [
    string
  ]
}
필드
pairIds[]

string

필수 항목입니다. 클린룸에서 제공한 PII 데이터로, SHA256으로 해싱되고 PAIR 사용자 목록에 게시자 키를 사용하여 EC 교환 암호로 암호화됩니다. 단일 AudienceMember에서 최대 10개의 pairIds을 제공할 수 있습니다.

MobileData

잠재고객의 모바일 ID입니다. 모바일 ID가 하나 이상 필요합니다.

JSON 표현 
{
  "mobileIds": [
    string
  ]
}
필드
mobileIds[]

string

필수 항목입니다. 휴대기기 ID (광고 ID/IDFA) 목록입니다. 단일 AudienceMember에서 최대 10개의 mobileIds을 제공할 수 있습니다.

UserIdData

사용자 ID를 보유하는 사용자 ID 데이터입니다.

JSON 표현 
{
  "userId": string
}
필드
userId

string

필수 항목입니다. 광고주가 정의한 사용자의 고유 식별자입니다.

PpidData

ppid를 보유하는 게시자 제공 식별자 데이터입니다. ppid가 하나 이상 필요합니다.

이 기능은 데이터 파트너만 사용할 수 있습니다.

JSON 표현 
{
  "ppids": [
    string
  ]
}
필드
ppids[]

string

필수 항목입니다. 사용자의 게시자 제공 식별자 목록입니다.

CompositeData

사용자의 식별자 및 관련 데이터를 보유하는 복합 데이터입니다. userData 또는 ipData 중 하나가 필요합니다.

JSON 표현 
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
필드
userData

object (UserData)

선택사항입니다. 사용자를 식별하는 사용자 제공 데이터입니다.
ipData[]

object (IpData)

선택사항입니다. 잠재고객을 만드는 데 사용된 고객 상호작용을 나타내는 IP 주소 데이터입니다.

IpData

사용자의 IP 주소 정보입니다. 고객 일치 타겟팅 일치율을 높이려면 observeStartTime과 observeEndTime을 포함하는 것이 좋습니다.

JSON 표현 
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
필드
ipAddress

string

필수 항목입니다. 고객 상호작용 시 캡처된 IP 주소입니다. IPv4 및 IPv6 모두에 표준 문자열 형식을 허용합니다.
observeStartTime

string (Timestamp format)

선택사항입니다. 세션에서 이 IP 주소의 첫 번째 기록된 상호작용 시간입니다.

생성된 출력은 항상 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"입니다.
observeEndTime

string (Timestamp format)

선택사항입니다. 세션에서 이 IP 주소의 마지막으로 기록된 상호작용 시간입니다.

생성된 출력은 항상 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"