Alan eşlemeleri

Tablolardaki eşlemeleri kullanarak Display & Video 360 API'deki Müşteri Eşleştirme kitle yönetimi yöntemlerini ve alanlarını Data Manager API'deki eşdeğerleriyle eşleyin.

Yöntem eşleme

Aşağıdaki tabloda, Display & Video 360 API yöntemleri eşdeğer Data Manager API yöntemleriyle eşlenmiştir:

Display & Video 360 API yöntemleri	Data Manager API yöntemleri	Notlar
firstPartyAndPartnerAudiences.get	userLists.get	Data Manager API yalnızca Müşteri Eşleştirme kitlelerini alabilir.
firstPartyAndPartnerAudiences.list	userLists.list	Data Manager API yalnızca Müşteri Eşleştirme kitlelerini döndürür.
firstPartyAndPartnerAudiences.create	userLists.create	Kullanıcı verileri, Data Manager API'de sonraki bir istekte yüklenmelidir.
Eşdeğeri yok	userLists.delete	Display & Video 360 API'sinde kullanılamaz.
firstPartyAndPartnerAudiences.patch	userLists.patch
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.ingest	Müşteri Eşleştirme kitlelerine üye eklemek ve kitlelerden üye kaldırmak için ayrı Data Manager API yöntemleri kullanılır.
firstPartyAndPartnerAudiences.editCustomerMatchMembers	audienceMembers.remove	Müşteri Eşleştirme kitlelerine üye eklemek ve kitlelerden üye kaldırmak için ayrı Data Manager API yöntemleri kullanılır.

Eşleme isteği

Aşağıdaki tablolarda, Display & Video 360 API yöntemlerinin istek alanları, Data Manager API'sindeki eşdeğerleriyle eşlenir.

userLists.get

firstPartyAndPartnerAudiences.get (Display & Video 360 API)	userLists.get (Data Manager API)	Notlar
advertiserId partnerId firstPartyAndPartnerAudienceId	name	UserList adı, hem üst reklamverenin veya iş ortağının kimliğini hem de kitle kimliğini içerir. Ayrıntılar için Kaynak adları bölümüne bakın.

userLists.list

firstPartyAndPartnerAudiences.list (Display & Video 360 API)	userLists.list (Data Manager API)	Notlar
advertiserId partnerId	parent	parent üst reklamverenin veya iş ortağının kimliğini içerir.
pageSize	pageSize	Veri Yöneticisi API'sinde maksimum sayfa boyutu 1000'dır.
pageToken	pageToken
filter	filter
orderBy	Eşdeğeri yok

userLists.create

firstPartyAndPartnerAudiences.create (Display & Video 360 API)	userLists.create (Data Manager API)	Notlar
advertiserId partnerId	parent	parent, yeni kitlenin üst reklamvereninin veya iş ortağının kimliğini içerir.
Eşdeğeri yok	validateOnly
FirstPartyAndPartnerAudience istek metni	UserList istek metni	İstek gövdesi eşlemesi için UserList'e bakın.

userLists.update

firstPartyAndPartnerAudiences.patch (Display & Video 360 API)	userLists.patch (Data Manager API)	Notlar
advertiserId firstPartyAndPartnerAudienceId	userList.name parametresi	Güncellenecek UserList öğesinin kaynak adı.
updateMask	updateMask	Bu alanın Data Manager API'de kullanılması önerilir ancak zorunlu değildir. Boş bırakılırsa dahil edilen tüm alanlar tamamen değiştirilir.
Eşdeğeri yok	validateOnly
FirstPartyAndPartnerAudience istek metni	UserList istek metni	İstek gövdesi eşlemesi için UserList'e bakın.

audienceMembers.ingest

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.ingest (Data Manager API)	Notlar
advertiserId firstPartyAndPartnerAudienceId	destinations	Ayrıntılar için Hedefleri yapılandırma başlıklı makaleyi inceleyin.
addedContactInfoList.contactInfos	audienceMembers	Bireysel kullanıcı tanımlayıcıları, AudienceMember nesnelerindeki compositeData.userData alanında ayarlanabilir. Ayrıntılar için Kullanıcı Tanımlayıcıları başlıklı makaleyi inceleyin.
addedContactInfoList.consent	consent	İzin, ayrı AudienceMember nesnelerinde de ayarlanabilir.
addedMobileDeviceIdList.mobileDeviceIds	audienceMembers	Bireysel mobil cihaz kimlikleri, AudienceMember nesnelerindeki mobileData alanında ayarlanır.
addedMobileDeviceIdList.consent	consent	İzin, ayrı AudienceMember nesnelerinde de ayarlanabilir.
Eşdeğeri yok	validateOnly
Eşdeğeri yok	encoding	Zorunlu. UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın.
Eşdeğeri yok	encryptionInfo	İsteğin şifrelenmiş değerler içerip içermediğini ayarlayın. Ayrıntılar için Şifreleme bölümüne bakın.
Eşdeğeri yok	termsOfService	Zorunludur. Kullanıcının Müşteri Eşleştirme hizmet şartlarını kabul ettiğini veya reddettiğini belirtmek için ayarlanır.

audienceMembers.remove

firstPartyAndPartnerAudiences.editCustomerMatchMembers (Display & Video 360 API)	audienceMembers.remove (Data Manager API)	Notlar
advertiserId firstPartyAndPartnerAudienceId	destinations
removedContactInfoList.contactInfos	audienceMembers	Bireysel kullanıcı tanımlayıcıları, AudienceMember nesnelerindeki compositeData.userData alanında ayarlanabilir. Ayrıntılar için Kullanıcı Tanımlayıcıları başlıklı makaleyi inceleyin.
removedMobileDeviceIdList.mobileDeviceIds	audienceMembers	Bireysel mobil cihaz kimlikleri, AudienceMember nesnelerindeki mobileData alanında ayarlanır.
Eşdeğeri yok	validateOnly
Eşdeğeri yok	encoding	Zorunludur. UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın.
Eşdeğeri yok	encryptionInfo	İsteğin şifrelenmiş değerler içerip içermediğini ayarlayın. Ayrıntılar için Şifreleme bölümüne bakın.

Nesne alanı eşlemeleri

Display & Video 360 API nesnelerinin Data Manager API'sindeki eşdeğer nesnelerle eşlemeleri aşağıda verilmiştir.

UserList

FirstPartyAndPartnerAudience (Display & Video 360 API)	UserList (Data Manager API)	Notlar
name	name	Farklı bir kaynak adı biçimi kullanır. Ayrıntılar için Kaynak adları bölümüne bakın.
firstPartyAndPartnerAudienceId	id
Eşdeğeri yok	readOnly
displayName	displayName
description	description
Eşdeğeri yok	membershipStatus
Eşdeğeri yok	integrationCode
membershipDurationDays	membershipDuration
Eşdeğeri yok	closingReason
Eşdeğeri yok	accessReason
Eşdeğeri yok	accountAccessStatus
displayAudienceSize	sizeInfo.displayNetworkMembersCount
Eşdeğeri yok	sizeInfo.searchNetworkMembersCount
Eşdeğeri yok	targetNetworkInfo
Eşdeğeri yok	ingestedUserListInfo
firstPartyAndPartnerAudienceType	Eşdeğeri yok
audienceType	Eşdeğeri yok
audienceSource	Eşdeğeri yok
activeDisplayAudienceSize	Eşdeğeri yok
youtubeAudienceSize	Eşdeğeri yok
gmailAudienceSize	Eşdeğeri yok
displayMobileAppAudienceSize	Eşdeğeri yok
displayMobileWebAudienceSize	Eşdeğeri yok
displayDesktopAudienceSize	Eşdeğeri yok
appId	ingestedUserListInfo.mobileIdInfo.appId
contactInfoList	audienceMembers yöntemler	Data Manager API'de, audienceMembers ingest ve remove yöntemlerini kullanarak üye ekleyip kaldırın.
mobileDeviceIdList	audienceMembers yöntemler	Data Manager API'de, audienceMembers ingest ve remove yöntemlerini kullanarak üye ekleyip kaldırın.

Kaynak adları

Veri Yöneticisi API'si, Display & Video 360 API'sinden farklı bir kaynak adı biçimi kullanır.

Display & Video 360 API

Display & Video 360 API'sinde UserList kaynak adı, yalnızca kitle kimliğini içeren bir biçim kullanır:

firstAndThirdPartyAudiences/{first_and_third_party_audience_id}

Data Manager API

Veri Yöneticisi API'sinde UserList kaynak adı, kitle kimliğinin yanı sıra kitleye sahip iş ortağının veya reklamverenin AccountType ve hesap kimliğini içeren bir biçim kullanır:

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

Kullanıcı Tanımlayıcıları

userData hâlâ destekleniyor olsa da entegrasyonunuzun gelecekteki iyileştirmelere hazır olması için compositeData kullanmanızı öneririz. Ayrıntılar için Bileşik veriler başlıklı makaleyi inceleyin.

ContactInfo (Display & Video 360 API)	CompositeData (Data Manager API)	Notlar
hashedEmails	userData.userIdentifiers.emailAddress	Biçimlendirilmiş ve karma oluşturulmuş e-posta adresi olarak ayarlayın. Ayrıca karma oluşturulmuş e-posta adresini şifreleyebilirsiniz. Birden fazla UserIdentifier nesnesi kullanılarak tek bir kullanıcıyla eşleşmek için birden fazla e-posta adresi kullanılabilir.
hashedPhoneNumbers	userData.userIdentifiers.phoneNumber	Biçimlendirilmiş ve karma oluşturma işlemi uygulanmış telefon numarası olarak ayarlayın. Karma oluşturma işlemi uygulanmış telefon numarasını da şifreleyebilirsiniz. Birden fazla UserIdentifier nesnesi kullanılarak tek bir kullanıcıyla eşleşmek için birden fazla telefon numarası kullanılabilir.
hashedFirstName	userData.userIdentifiers.address.givenName	Biçimlendirilmiş ve karma oluşturulmuş ad olarak ayarlayın. Karma oluşturulmuş adı şifreleyebilirsiniz.
hashedLastName	userData.userIdentifiers.address.familyName	Biçimlendirilmiş ve karma oluşturulmuş aile adı olarak ayarlayın. Karma oluşturulmuş aile adını da şifreleyebilirsiniz.
countryCode	userData.userIdentifiers.address.regionCode
zipCodes	userData.userIdentifiers.address.postalCode	Birden fazla UserIdentifier nesnesi kullanılarak tek bir kullanıcıyla eşleşmek için birden fazla posta kodu kullanılabilir.

Hedef

Display & Video 360 API	Destination (Data Manager API)	Notlar
Display & Video 360 kullanıcısının erişim izni verilen reklamverenin veya iş ortağının kimliği.	loginAccount	Bu ayarın yalnızca, kitlenin bir reklamverenin altında olduğu ancak erişen Display & Video 360 kullanıcısına reklamverenin üst iş ortağına erişim izni verildiği Display & Video 360 iş ortağı erişimi senaryosunda ayarlanması gerekir. Aksi takdirde ayarlanmamış olarak bırakılabilir.
Kitlenin üst reklamvereninin veya iş ortağının kimliği.	operatingAccount
firstPartyAndPartnerAudienceId	productDestinationId
Eşdeğeri yok	reference