Alan eşlemeleri

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şlemek için tablolardaki eşlemeleri kullanın.

Kimlik doğrulama

Data Manager API, Display & Video 360 API'den farklı bir kapsama sahip kimlik bilgileri gerektirir. Data Manager API kapsamını içeren yeni kimlik bilgileri oluşturmak için API erişimini ayarlama bölümündeki adımları uygulayın.

Yöntem eşleme

Aşağıdaki tabloda, Display & Video 360 API yöntemleri ile eşdeğer Data Manager API yöntemleri eşleştirilmiş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'deki sonraki bir istekte yüklenmelidir.
Eşdeğeri yok userLists.delete Display & Video 360 API'de 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şdeğeri yok. audienceMembers.removeAll Data Manager API, tek bir istekle bir kitlenin tüm üyelerini kaldırmayı destekler.

İstek eşleme

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

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 Data Manager API'deki maksimum sayfa boyutu 1000.
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 içeriği UserList istek içeriği İ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, Data Manager API'de ö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 içeriği UserList istek içeriği İ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 Bağımsız kullanıcı kimlikleri, AudienceMember nesnelerindeki compositeData.userData alanında ayarlanabilir. Ayrıntılar için Kullanıcı Kimlikleri bölümüne bakın.
addedContactInfoList.consent consent İzin, ayrı AudienceMember nesnelerinde de ayarlanabilir.
addedMobileDeviceIdList.mobileDeviceIds audienceMembers Bağımsız mobil cihaz kimlikleri, AudienceMember nesneleri içindeki 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 ayarlanır.
Eşdeğeri yok encryptionInfo İstek şifrelenmiş değerler içeriyorsa ayarlayın. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin.
Eşdeğeri yok termsOfService Zorunludur. Kullanıcının, Müşteri Eşleştirme ile ilgili 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 Bağımsız kullanıcı kimlikleri, AudienceMember nesnelerindeki compositeData.userData alanında ayarlanabilir. Ayrıntılar için Kullanıcı Kimlikleri bölümüne bakın.
removedMobileDeviceIdList.mobileDeviceIds audienceMembers Bağımsız 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 ayarlanır.
Eşdeğeri yok encryptionInfo İstek şifrelenmiş değerler içeriyorsa ayarlayın. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin.

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öntemleri Data Manager API'de, audienceMembers'nin ingest, remove ve removeAll yöntemlerini kullanarak üye ekleyip kaldırın.
mobileDeviceIdList audienceMembers yöntemleri Data Manager API'de, audienceMembers'nin ingest, remove ve removeAll yöntemlerini kullanarak üye ekleyip kaldırın.

Kaynak adları

Data Manager API, Display & Video 360 API'den farklı bir kaynak adı biçimi kullanır.

Display & Video 360 API

Display & Video 360 API'de, 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 olan 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ı Kimlikleri

userData hâlâ destekleniyor olsa da entegrasyonunuzun gelecekteki iyileştirmelere hazır olmasını sağlamak için compositeData kullanmanızı öneririz. Ayrıntılar için Bileşik veriler bölümüne bakın.

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

Hedef

Display & Video 360 API Destination (Data Manager API) Notlar
Display & Video 360 kullanıcısına 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şim senaryosunda yapılması gerekir. Aksi takdirde ayarlanmadan bırakılabilir.
Kitlenin üst reklamvereninin veya iş ortağının kimliği. operatingAccount
firstPartyAndPartnerAudienceId productDestinationId
Eşdeğeri yok reference
Önceki
Yükseltme adımları