AudienceMember

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

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
필드
destinationReferences[]

string

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

object (Consent)

선택사항입니다. 사용자의 동의 설정입니다.
작업할 식별 데이터의 유형입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
userData

object (UserData)

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

object (PairData)

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

이 기능은 데이터 파트너에게만 제공됩니다.
mobileData

object (MobileData)

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

object (UserIdData)

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

object (PpidData)

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

이 기능은 데이터 파트너에게만 제공됩니다.
compositeData

object (CompositeData)

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

object (GoogleUserIdData)

암호화된 Google 사용자 ID입니다.
partnerProvidedIdData

object (PartnerProvidedIdData)

파트너 제공 식별자입니다.
상호 배타적 필드의 끝입니다.

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 목록 (고객 매치 타겟팅 사용자 목록의 경우 Android 광고 ID, iOS IDFA, 기본 사용자 목록의 경우 Android 광고 ID, iOS IDFA, Xbox 또는 Microsoft ID, Amazon Fire TV ID, Roku ID, 일반 기기 ID) 단일 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"입니다.

GoogleUserIdData

암호화된 Google 사용자 ID를 보유하는 Google 사용자 ID 데이터입니다. 하나 이상의 Google 사용자 ID가 필요합니다.

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

string

필수 항목입니다. 암호화된 Google 사용자 ID 목록입니다.

PartnerProvidedIdData

파트너가 제공한 식별자를 보유하는 파트너 제공 데이터입니다. 파트너 제공 식별자가 하나 이상 필요합니다.

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

string

필수 항목입니다. 파트너가 제공한 식별자 목록입니다.