Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

필드 매핑

표의 매핑을 사용하여 Display & Video 360 API의 고객 일치 타겟팅 잠재고객 관리 방법과 필드를 Data Manager API의 상응하는 항목에 매핑합니다.

인증

Data Manager API에는 Display & Video 360 API와 다른 범위의 사용자 인증 정보가 필요합니다. API 액세스 설정의 단계에 따라 Data Manager API 범위를 포함하는 새 사용자 인증 정보를 생성합니다.

메서드 매핑

다음 표에서는 Display & Video 360 API 메서드를 상응하는 Data Manager API 메서드에 매핑합니다.

Display & Video 360 API 메서드	Data Manager API 메서드	참고
`firstPartyAndPartnerAudiences.get`	`userLists.get`	Data Manager API는 고객 일치 타겟팅 잠재고객만 가져올 수 있습니다.
`firstPartyAndPartnerAudiences.list`	`userLists.list`	Data Manager API는 고객 일치 타겟만 반환합니다.
`firstPartyAndPartnerAudiences.create`	`userLists.create`	사용자 데이터는 Data Manager API의 후속 요청에 업로드해야 합니다.
- 동등한 보고서 없음	`userLists.delete`	Display & Video 360 API에서는 사용할 수 없습니다.
`firstPartyAndPartnerAudiences.patch`	`userLists.patch`
`firstPartyAndPartnerAudiences.editCustomerMatchMembers`	`audienceMembers.ingest`	고객 매치 타겟팅 잠재고객에서 회원을 추가하고 삭제하는 데는 별도의 Data Manager API 메서드가 사용됩니다.
`firstPartyAndPartnerAudiences.editCustomerMatchMembers`	`audienceMembers.remove`	고객 매치 타겟팅 잠재고객에서 회원을 추가하고 삭제하는 데는 별도의 Data Manager API 메서드가 사용됩니다.

매핑 요청

다음 표에서는 Display & Video 360 API 메서드의 요청 필드를 Data Manager API의 상응하는 필드에 매핑합니다.

userLists.get

`firstPartyAndPartnerAudiences.get` (Display & Video 360 API)	`userLists.get` (Data Manager API)	참고
`advertiserId` `partnerId` `firstPartyAndPartnerAudienceId`	`name`	`UserList` 이름에는 상위 광고주 또는 파트너의 ID와 잠재고객 ID가 모두 포함됩니다. 자세한 내용은 리소스 이름을 참고하세요.

userLists.list

`firstPartyAndPartnerAudiences.list` (Display & Video 360 API)	`userLists.list` (Data Manager API)	참고
`advertiserId` `partnerId`	`parent`	`parent`에는 상위 광고주 또는 파트너의 ID가 포함됩니다.
`pageSize`	`pageSize`	Data Manager API의 최대 페이지 크기는 `1000`입니다.
`pageToken`	`pageToken`
`filter`	`filter`
`orderBy`	- 동등한 보고서 없음

userLists.create

`firstPartyAndPartnerAudiences.create` (Display & Video 360 API)	`userLists.create` (Data Manager API)	참고
`advertiserId` `partnerId`	`parent`	`parent`에는 새 잠재고객의 상위 광고주 또는 파트너의 ID가 포함됩니다.
- 동등한 보고서 없음	`validateOnly`
`FirstPartyAndPartnerAudience` 요청 본문	`UserList` 요청 본문	요청 본문 매핑은 UserList를 참고하세요.

userLists.update

`firstPartyAndPartnerAudiences.patch` (Display & Video 360 API)	`userLists.patch` (Data Manager API)	참고
`advertiserId` `firstPartyAndPartnerAudienceId`	`userList.name` 매개변수	업데이트할 `UserList`의 리소스 이름입니다.
`updateMask`	`updateMask`	이 필드는 Data Manager API에서 권장되지만 필수는 아니며, 비워 두면 포함된 모든 필드가 완전히 대체됩니다.
- 동등한 보고서 없음	`validateOnly`
`FirstPartyAndPartnerAudience` 요청 본문	`UserList` 요청 본문	요청 본문 매핑은 UserList를 참고하세요.

audienceMembers.ingest

`firstPartyAndPartnerAudiences.editCustomerMatchMembers` (Display & Video 360 API)	`audienceMembers.ingest` (Data Manager API)	참고
`advertiserId` `firstPartyAndPartnerAudienceId`	`destinations`	자세한 내용은 대상 구성을 참고하세요.
`addedContactInfoList.contactInfos`	`audienceMembers`	개별 사용자 식별자는 `AudienceMember` 객체 내의 `compositeData.userData` 필드에 설정할 수 있습니다. 자세한 내용은 사용자 식별자를 참고하세요.
`addedContactInfoList.consent`	`consent`	동의는 개별 `AudienceMember` 객체에서도 설정할 수 있습니다.
`addedMobileDeviceIdList.mobileDeviceIds`	`audienceMembers`	개별 휴대기기 ID는 `AudienceMember` 객체 내의 `mobileData` 필드에 설정됩니다.
`addedMobileDeviceIdList.consent`	`consent`	동의는 개별 `AudienceMember` 객체에서도 설정할 수 있습니다.
- 동등한 보고서 없음	`validateOnly`
- 동등한 보고서 없음	`encoding`	필수사항. `UserIdentifier` 값에 사용된 `Encoding`로 설정됩니다.
- 동등한 보고서 없음	`encryptionInfo`	요청에 암호화된 값이 포함되어 있는지 설정합니다. 자세한 내용은 암호화를 참고하세요.
- 동등한 보고서 없음	`termsOfService`	필수사항: 사용자가 고객 일치 타겟팅의 서비스 약관에 동의했는지 또는 거부했는지를 나타내도록 설정됩니다.

audienceMembers.remove

`firstPartyAndPartnerAudiences.editCustomerMatchMembers` (Display & Video 360 API)	`audienceMembers.remove` (Data Manager API)	참고
`advertiserId` `firstPartyAndPartnerAudienceId`	`destinations`
`removedContactInfoList.contactInfos`	`audienceMembers`	개별 사용자 식별자는 `AudienceMember` 객체 내의 `compositeData.userData` 필드에 설정할 수 있습니다. 자세한 내용은 사용자 식별자를 참고하세요.
`removedMobileDeviceIdList.mobileDeviceIds`	`audienceMembers`	개별 휴대기기 ID는 `AudienceMember` 객체 내의 `mobileData` 필드에 설정됩니다.
- 동등한 보고서 없음	`validateOnly`
- 동등한 보고서 없음	`encoding`	필수사항: `UserIdentifier` 값에 사용된 `Encoding`로 설정됩니다.
- 동등한 보고서 없음	`encryptionInfo`	요청에 암호화된 값이 포함되어 있는지 설정합니다. 자세한 내용은 암호화를 참고하세요.

객체 필드 매핑

다음은 Display & Video 360 API 객체와 Data Manager API의 해당 객체 간 매핑입니다.

UserList

`FirstPartyAndPartnerAudience` (Display & Video 360 API)	`UserList` (Data Manager 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` 메서드를 사용하여 회원을 추가하고 삭제합니다.

리소스 이름

Data Manager 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도 계속 지원되지만 향후 개선사항에 대비할 수 있도록 compositeData을 사용하는 것이 좋습니다. 자세한 내용은 컴포지트 데이터를 참고하세요.

`ContactInfo` (Display & Video 360 API)	`CompositeData` (Data Manager API)	참고
`hashedEmails`	`userData.userIdentifiers.emailAddress`	형식이 지정되고 해싱된 이메일 주소로 설정됩니다. 해시된 이메일 주소를 암호화할 수도 있습니다. 여러 `UserIdentifier` 객체를 사용하여 단일 사용자를 일치시키는 데 여러 이메일을 사용할 수 있습니다.
`hashedPhoneNumbers`	`userData.userIdentifiers.phoneNumber`	형식화되고 해싱된 전화번호로 설정됩니다. 해싱된 전화번호를 암호화할 수도 있습니다. 여러 `UserIdentifier` 객체를 사용하여 여러 전화번호를 통해 단일 사용자를 매칭할 수 있습니다.
`hashedFirstName`	`userData.userIdentifiers.address.givenName`	형식이 지정되고 해싱된 이름으로 설정됩니다. 해시된 성명을 암호화할 수도 있습니다.
`hashedLastName`	`userData.userIdentifiers.address.familyName`	형식이 지정되고 해싱된 성으로 설정됩니다. 해시된 가족 이름을 암호화할 수도 있습니다.
`countryCode`	`userData.userIdentifiers.address.regionCode`
`zipCodes`	`userData.userIdentifiers.address.postalCode`	여러 `UserIdentifier` 객체를 사용하여 여러 우편번호를 통해 단일 사용자를 일치시킬 수 있습니다.

대상

Display & Video 360 API	`Destination` (Data Manager API)	참고
Display & Video 360 사용자에게 액세스 권한이 부여된 광고주 또는 파트너의 ID입니다.	`loginAccount`	이 값은 Display & Video 360 파트너 액세스 시나리오에서만 설정하면 됩니다. 이 경우 잠재고객은 광고주에 속하지만 액세스하는 Display & Video 360 사용자에게 광고주의 상위 파트너에 대한 액세스 권한이 부여됩니다. 그렇지 않으면 설정되지 않은 상태로 둘 수 있습니다.
잠재고객의 상위 광고주 또는 파트너의 ID입니다.	`operatingAccount`
`firstPartyAndPartnerAudienceId`	`productDestinationId`
- 동등한 보고서 없음	`reference`

업그레이드 단계