필드 매핑
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
표의 매핑을 사용하여 Display & Video 360 API의 고객 일치 타겟팅 잠재고객 관리 방법과 필드를 Data Manager API의 상응하는 항목에 매핑합니다.
메서드 매핑
다음 표에서는 Display & Video 360 API 메서드를 상응하는 데이터 관리 도구 API 메서드에 매핑합니다.
매핑 요청
다음 표에서는 Display & Video 360 API 메서드의 요청 필드를 Data Manager API의 상응하는 필드에 매핑합니다.
userLists.get
userLists.list
userLists.create
userLists.update
audienceMembers.ingest
firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API) |
audienceMembers.ingest (데이터 관리 도구 API) |
참고 |
advertiserIdfirstPartyAndPartnerAudienceId
|
destinations |
자세한 내용은 대상 구성을 참고하세요. |
addedContactInfoList.contactInfos |
audienceMembers |
개별 사용자 데이터는 AudienceMember 객체 내의 userData 필드에 설정됩니다. |
addedContactInfoList.consent |
consent |
동의는 개별 AudienceMember 객체에서도 설정할 수 있습니다. |
addedMobileDeviceIdList.mobileDeviceIds |
audienceMembers |
개별 휴대기기 ID는 AudienceMember 객체 내의 mobileData 필드에 설정됩니다. |
addedMobileDeviceIdList.consent |
consent |
동의는 개별 AudienceMember 객체에서도 설정할 수 있습니다. |
| - 동등한 보고서 없음 |
validateOnly |
|
| - 동등한 보고서 없음 |
encoding |
필수사항. UserIdentifier 값에 사용된 Encoding로 설정됩니다. |
| - 동등한 보고서 없음 |
encryptionInfo |
요청에 암호화된 값이 포함되어 있는지 설정합니다. 자세한 내용은 암호화를 참고하세요. |
| - 동등한 보고서 없음 |
termsOfService |
필수사항: 사용자가 고객 일치 타겟팅의 서비스 약관에 동의했는지 또는 거부했는지를 나타내도록 설정됩니다. |
audienceMembers.remove
객체 필드 매핑
다음은 Display & Video 360 API 객체와 데이터 관리 도구 API의 해당 객체 간 매핑입니다.
UserList
FirstPartyAndPartnerAudience (Display & Video 360 API) |
UserList (데이터 관리 도구 API) |
참고 |
name |
name |
다른 리소스 이름 형식을 사용합니다. 자세한 내용은 리소스 이름을 참고하세요. |
firstPartyAndPartnerAudienceId |
id |
|
| - 동등한 보고서 없음 |
readOnly |
|
displayName |
displayName |
|
description |
description |
|
| - 동등한 보고서 없음 |
membershipStatus |
|
| - 동등한 보고서 없음 |
integrationCode |
|
membershipDurationDays |
membershipDuration |
|
| - 동등한 보고서 없음 |
closingReason |
|
| - 동등한 보고서 없음 |
accessReason |
|
| - 동등한 보고서 없음 |
accountAccessStatus |
|
displayAudienceSize |
sizeInfo.displayNetworkMembersCount |
|
| - 동등한 보고서 없음 |
sizeInfo.searchNetworkMembersCount |
|
| - 동등한 보고서 없음 |
targetNetworkInfo |
|
| - 동등한 보고서 없음 |
ingestedUserListInfo |
|
firstPartyAndPartnerAudienceType |
- 동등한 보고서 없음 |
|
audienceType |
- 동등한 보고서 없음 |
|
audienceSource |
- 동등한 보고서 없음 |
|
activeDisplayAudienceSize |
- 동등한 보고서 없음 |
|
youtubeAudienceSize |
- 동등한 보고서 없음 |
|
gmailAudienceSize |
- 동등한 보고서 없음 |
|
displayMobileAppAudienceSize |
- 동등한 보고서 없음 |
|
displayMobileWebAudienceSize |
- 동등한 보고서 없음 |
|
displayDesktopAudienceSize |
- 동등한 보고서 없음 |
|
appId |
ingestedUserListInfo.mobileIdInfo.appId |
|
contactInfoList |
audienceMembers 메서드 |
Data Manager API에서 audienceMembers의 ingest 및 remove 메서드를 사용하여 회원을 추가하고 삭제합니다.
|
mobileDeviceIdList |
audienceMembers 메서드 |
Data Manager API에서 audienceMembers의 ingest 및 remove 메서드를 사용하여 회원을 추가하고 삭제합니다.
|
리소스 이름
데이터 관리 도구 API는 Display & Video 360 API와 다른 리소스 이름 형식을 사용합니다.
- Display & Video 360 API
Display & Video 360 API에서 UserList 리소스 이름은 잠재고객 ID만 포함하는 형식을 사용합니다.
firstAndThirdPartyAudiences/{first_and_third_party_audience_id}
- Data Manager API
데이터 관리 도구 API에서 UserList 리소스 이름은 잠재고객 ID와 잠재고객을 소유한 파트너 또는 광고주의 AccountType 및 계정 ID가 포함된 형식을 사용합니다.
accountTypes/{accountType}/accounts/{account}/userLists/{userList}
UserData
대상
| Display & Video 360 API |
Destination (데이터 관리 도구 API) |
참고 |
| Display & Video 360 사용자에게 액세스 권한이 부여된 광고주 또는 파트너의 ID입니다. |
loginAccount |
이 값은 잠재고객이 광고주에 속해 있지만 액세스하는 Display & Video 360 사용자에게 광고주의 상위 파트너에 대한 액세스 권한이 부여된 Display & Video 360 파트너 액세스 시나리오에서만 설정하면 됩니다. 그렇지 않으면 설정되지 않은 상태로 둘 수 있습니다. |
| 잠재고객의 상위 광고주 또는 파트너의 ID입니다. |
operatingAccount |
|
firstPartyAndPartnerAudienceId |
productDestinationId |
|
| - 동등한 보고서 없음 |
reference |
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2026-02-17(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2026-02-17(UTC)"],[],[]]