Tablolardaki eşlemeleri kullanarak Campaign Manager 360 API'deki bir conversions.batchinsert öğesini Data Manager API'deki IngestEventsRequest eşdeğeriyle eşleyin.
İstek alanları
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Notlar |
|---|---|---|
profileId URL yolu parametresi |
Eşdeğeri yok | |
kind |
Eşdeğeri yok | Meta veri alanı; Data Manager API tarafından kullanılmaz. |
conversions |
events |
Zorunlu. Dönüşümlerin veya etkinliklerin listesi. Ayrıntılı bilgi için Dönüşüm alanları bölümüne bakın. |
encryptionInfo |
events.adIdentifiers.encryptedUserIds hedefine taşındı |
Etkinlik düzeyinde tanımlanır. Campaign Manager 360 şifreleme bilgileri artık her şifrelenmiş kullanıcı kimliğinde belirtiliyor. Dönüşüm alanları bölümüne bakın. |
| Eşdeğeri yok | encryptionInfo |
İstek düzeyindeki encryptionInfo, şifrelenmiş UserData kullanıcı tanımlayıcılarının şifreleme bilgileridir. Ayrıntılar için Şifreleme başlıklı makaleyi inceleyin. |
| Eşdeğeri yok | destinations |
Zorunlu. Etkinlikler için hedef hesabı ve Floodlight etkinliğini tanımlayan Destination nesnelerinin listesi. Ayrıntılar için Hedefler kılavuzuna bakın. Dönüşüm alanları bölümünde gösterildiği gibi alanları tek tek eşleyin. |
| Eşdeğeri yok | consent |
İstekteki etkinlikler için isteğe bağlı varsayılan izin ayarları. consent alanını Event olarak ayarlayarak bu değeri tek bir etkinlik için geçersiz kılabilirsiniz. |
| Eşdeğeri yok | encoding |
Kullanıcı tanımlayıcıları gönderiliyorsa zorunludur: UserIdentifier değerleri için kullanılan Encoding olarak ayarlayın. Kullanıcı tanımlayıcıları kullanılmıyorsa bu alan göz ardı edilir. |
| Eşdeğeri yok | validateOnly |
Doğruysa istek doğrulanır ancak yürütülmez. |
Dönüşüm alanları
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
Notlar |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
İstek düzeyinde tanımlanır. Floodlight yapılandırma kimliğine ayarlanır. |
| Eşdeğeri yok | destinations[].operatingAccount.accountType |
İstek düzeyinde tanımlanır. FLOODLIGHT_CONFIG olarak ayarlayın. |
floodlightActivityId |
destinations[].productDestinationId |
İstek düzeyinde tanımlanır. Floodlight etkinlik kimliğine (eski adıyla Floodlight etkinlik kimliği) ayarlanır. |
kind |
Eşdeğeri yok | Meta veri alanı; Data Manager API tarafından kullanılmaz. |
| Eşdeğeri yok | destinations[].reference |
İstek düzeyinde tanımlanır. Hedef için kullanıcı tanımlı tanımlayıcı. Tek bir istekte birden fazla hedefe etkinlik gönderiyorsanız bu alanı ayarlayın. |
adUserDataConsent |
consent.adUserData |
Daha fazla bilgi için Consent sayfasına bakın. |
nonPersonalizedAd |
consent.adPersonalization |
Daha fazla bilgi için Consent sayfasına bakın. |
| Eşdeğeri yok | destinationReferences |
Tek bir istekte birden fazla hedefe etkinlik gönderiyorsanız bu alanı hedefin ilgili reference değerine ayarlayın. |
timestampMicros |
eventTimestamp |
Ayrıntılar için Zaman damgası biçimi bölümüne bakın. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Eşdeğeri yok |
Campaign Manager 360 API'deki ordinal alanı, Data Manager API'sinde bulunmaz.
Bunun yerine, aynı kullanıcıdan ve aynı gün içinde gelen dönüşümlerin nasıl tekilleştirileceğini kontrol etmek için transactionId kullanılabilir.
Campaign Manager 360 API'de, ordinal değerini 1 gibi sabit bir değere ayarlayarak etkinliklerin tekilleştirilmesini sağlayabilirsiniz.
ordinal Veri Yöneticisi API'sinde,
transactionId her etkinlik için benzersiz bir tanımlayıcı olarak ayarlanmalıdır.
|
| Eşdeğeri yok | transactionId |
Veri Yöneticisi API'sinde, aynı kullanıcıdan ve aynı gün içinde gelen dönüşümlerin nasıl tekilleştirileceğini kontrol etmek için transactionId kullanılır. Bu alan, her etkinlik için benzersiz bir tanımlayıcıya ayarlanmalıdır.
Bu alan, Floodlight çevrimdışı dönüşümleri gönderilirken isteğe bağlıdır. Daha fazla bilgi için Verileri Event nesnelerine dönüştürme başlıklı makaleyi inceleyin.
|
customVariables |
customVariables |
CustomVariable nesnelerin listesi. Data Manager API, numaralandırılmış değerler yerine anahtar olarak dizeler kullanır. variable alanı için U1, U2 gibi tuşları kullanın. |
limitAdTracking |
consent.adPersonalization |
Daha fazla bilgi için Consent sayfasına bakın. |
childDirectedTreatment |
consent.adPersonalization |
Daha fazla bilgi için Consent sayfasına bakın. |
treatmentForUnderage |
consent.adPersonalization |
Daha fazla bilgi için Consent sayfasına bakın. |
gclid |
adIdentifiers.gclid |
Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
dclid |
adIdentifiers.dclid |
Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
matchId |
adIdentifiers.matchId |
Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
mobileDeviceId |
adIdentifiers.mobileId |
Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
impressionId |
adIdentifiers.impressionId |
Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
Data Manager API, birden fazla şifrelenmiş kullanıcı kimliğini destekler. Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Her aday kimliği, listedeki bir EncryptedUserId nesnesiyle eşlenir. |
encryptionInfo.kind |
Eşdeğeri yok | Meta veri alanı; Data Manager API tarafından kullanılmaz. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Şifreleme bilgileri istek başına bir kez belirtilmek yerine şifrelenmiş kullanıcı kimliği başına belirtilir. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Şifreleme bilgileri istek başına bir kez belirtilmek yerine, şifrelenmiş kullanıcı kimliği başına belirtilir. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Şifreleme bilgileri istek başına bir kez belirtilmek yerine şifrelenmiş kullanıcı kimliği başına belirtilir. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Daha fazla bilgi için AdIdentifiers sayfasına bakın. |
cartData |
cartData |
Ayrıntılar için Alışveriş sepeti veri alanları başlıklı makaleyi inceleyin. |
userIdentifiers |
userData.userIdentifiers |
Ayrıntılar için Kullanıcı tanımlayıcısı alanları başlıklı makaleyi inceleyin. |
Kullanıcı tanımlayıcısı alanları
Data Manager API'de kullanıcı tanımlayıcıları, Event alanının userData alanı altındaki bir UserData nesnesinde gruplandırılır. Bu, tanımlayıcıların doğrudan Conversion nesnesine eklendiği Campaign Manager 360 API'sinden farklıdır.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
Notlar |
|---|---|---|
hashedEmail |
emailAddress |
Biçimlendirilmiş ve karma oluşturulmuş e-posta adresi olarak ayarlayın. Ayrıca karma oluşturulmuş e-posta adresini şifreleyebilirsiniz. |
hashedPhoneNumber |
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. |
addressInfo |
address |
AddressInfo nesnesi olarak ayarlayın. Biçimlendirme ve karma oluşturma kurallarına uyun. Bir adresin karma oluşturma işlemi uygulanmış özelliklerini de şifreleyebilirsiniz. |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
Eşdeğeri yok | Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez. |
addressInfo.state |
Eşdeğeri yok | Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez. |
addressInfo.hashedStreetAddress |
Eşdeğeri yok | Veri Yöneticisi API'sinin mevcut sürümünde desteklenmez. |
Alışveriş sepeti veri alanları
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
Notlar |
|---|---|---|
kind |
Eşdeğeri yok | Meta veri alanı; Data Manager API tarafından kullanılmaz. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Item nesnelerin listesi. Daha fazla bilgi için Öğe alanları bölümüne bakın. |
Alışveriş sepeti verileri için öğe alanları
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
Notlar |
|---|---|---|
kind |
Eşdeğeri yok | Meta veri alanı; Data Manager API tarafından kullanılmaz. |
| Eşdeğeri yok | itemId |
İsteğe bağlı. Öğenin benzersiz tanımlayıcısı. |
itemId |
merchantProductId |
Zorunlu. Öğe için Merchant Center ürün kimliği olarak ayarlayın. |
quantity |
quantity |
Zorunlu. |
unitPrice |
unitPrice |
Zorunlu. |