Gunakan pemetaan dalam tabel untuk memetakan
conversions.batchinsert di Campaign Manager 360 API ke
IngestEventsRequest yang setara di Data Manager API.
Kolom permintaan
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Catatan |
|---|---|---|
profileId Parameter jalur URL |
Tidak ada ekuivalen | |
kind |
Tidak ada ekuivalen | Kolom metadata; tidak digunakan oleh Data Manager API. |
conversions |
events |
Wajib. Daftar konversi atau peristiwa. Lihat bagian Kolom konversi untuk mengetahui detailnya. |
encryptionInfo |
Dipindahkan ke events.adIdentifiers.encryptedUserIds |
Ditentukan di tingkat peristiwa. Informasi enkripsi Campaign Manager 360 kini ditentukan di setiap ID pengguna terenkripsi. Lihat bagian kolom Konversi. |
| Tidak ada ekuivalen | encryptionInfo |
encryptionInfo tingkat permintaan adalah informasi enkripsi untuk ID pengguna UserData yang dienkripsi. Lihat Enkripsi untuk mengetahui detailnya. |
| Tidak ada ekuivalen | destinations |
Wajib. Daftar objek Destination yang menentukan akun target dan aktivitas Floodlight untuk peristiwa. Lihat Panduan tujuan untuk mengetahui detailnya. Petakan setiap kolom seperti yang ditunjukkan di bagian Kolom konversi. |
| Tidak ada ekuivalen | consent |
Setelan izin default opsional untuk peristiwa dalam permintaan. Anda dapat mengganti nilai ini untuk setiap acara dengan menyetel kolom consent dari Event. |
| Tidak ada ekuivalen | encoding |
Wajib jika mengirim ID pengguna: Setel ke Encoding yang digunakan untuk nilai UserIdentifier. Jika tidak menggunakan ID pengguna, kolom ini akan diabaikan. |
| Tidak ada ekuivalen | validateOnly |
Jika benar, permintaan divalidasi, tetapi tidak dieksekusi. |
Kolom konversi
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
Catatan |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Ditentukan di tingkat permintaan. Disetel ke ID konfigurasi Floodlight. |
| Tidak ada ekuivalen | destinations[].operatingAccount.accountType |
Ditentukan di tingkat permintaan. Tetapkan ke FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Ditentukan di tingkat permintaan. Disetel ke ID aktivitas Floodlight (sebelumnya dikenal sebagai ID aktivitas Floodlight). |
kind |
Tidak ada ekuivalen | Kolom metadata; tidak digunakan oleh Data Manager API. |
| Tidak ada ekuivalen | destinations[].reference |
Ditentukan di tingkat permintaan. ID yang ditentukan pengguna untuk tujuan. Setel kolom ini jika Anda mengirim peristiwa ke beberapa tujuan dalam satu permintaan. |
adUserDataConsent |
consent.adUserData |
Lihat Consent untuk mengetahui detail selengkapnya. |
nonPersonalizedAd |
consent.adPersonalization |
Lihat Consent untuk mengetahui detail selengkapnya. |
| Tidak ada ekuivalen | destinationReferences |
Jika mengirim peristiwa ke beberapa tujuan dalam satu permintaan, setel kolom ini ke reference yang sesuai dari tujuan. |
timestampMicros |
eventTimestamp |
Lihat Format stempel waktu untuk mengetahui detailnya. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Tidak ada ekuivalen |
Kolom ordinal dari Campaign Manager 360 API tidak ada di Data Manager API.
Sebagai gantinya, transactionId dapat digunakan untuk mengontrol cara penghapusan duplikat konversi dari pengguna dan hari yang sama.
Di Campaign Manager 360 API, Anda dapat memastikan peristiwa akan diduplikasi dengan menetapkan ordinal ke nilai tetap dan konstan seperti 1. Di Data Manager API,
transactionId harus ditetapkan ke ID unik untuk setiap peristiwa.
|
| Tidak ada ekuivalen | transactionId |
Di Data Manager API, transactionId digunakan untuk mengontrol cara penghapusan duplikat konversi dari pengguna dan hari yang sama. Kolom ini harus disetel
ke ID unik untuk setiap peristiwa.
Kolom ini bersifat opsional saat mengirim konversi offline Floodlight. Lihat Mengonversi data menjadi objek Event untuk mengetahui detail selengkapnya.
|
customVariables |
customVariables |
Daftar objek CustomVariable. Data Manager API menggunakan string sebagai kunci, bukan enum. Gunakan kunci seperti U1, U2 untuk kolom variable. |
limitAdTracking |
consent.adPersonalization |
Lihat Consent untuk mengetahui detail selengkapnya. |
childDirectedTreatment |
consent.adPersonalization |
Lihat Consent untuk mengetahui detail selengkapnya. |
treatmentForUnderage |
consent.adPersonalization |
Lihat Consent untuk mengetahui detail selengkapnya. |
gclid |
adIdentifiers.gclid |
Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
dclid |
adIdentifiers.dclid |
Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
matchId |
adIdentifiers.matchId |
Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
mobileDeviceId |
adIdentifiers.mobileId |
Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
impressionId |
adIdentifiers.impressionId |
Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
Data Manager API mendukung beberapa ID pengguna terenkripsi. Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Setiap ID kandidat dipetakan ke objek EncryptedUserId dalam daftar. |
encryptionInfo.kind |
Tidak ada ekuivalen | Kolom metadata; tidak digunakan oleh Data Manager API. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Daripada menentukan info enkripsi sekali per permintaan, info ini ditentukan per ID pengguna terenkripsi. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Daripada menentukan info enkripsi sekali per permintaan, info ini ditentukan per ID pengguna terenkripsi. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Daripada menentukan info enkripsi sekali per permintaan, info ini ditentukan per ID pengguna terenkripsi. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Lihat AdIdentifiers untuk mengetahui detail selengkapnya. |
cartData |
cartData |
Lihat Kolom data keranjang untuk mengetahui detailnya. |
userIdentifiers |
userData.userIdentifiers |
Lihat Kolom ID pengguna untuk mengetahui detailnya. |
Kolom ID pengguna
Di Data Manager API, ID pengguna dikelompokkan dalam objek
UserData di kolom userData dari
Event. Hal ini berbeda dengan Campaign Manager 360 API, yang ID-nya langsung
dilampirkan ke objek Conversion.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
Catatan |
|---|---|---|
hashedEmail |
emailAddress |
Disetel ke alamat email yang diformat dan di-hash. Anda juga dapat mengenkripsi alamat email yang di-hash. |
hashedPhoneNumber |
phoneNumber |
Disetel ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenkripsi nomor telepon yang di-hash. |
addressInfo |
address |
Disetel ke objek AddressInfo. Ikuti panduan pemformatan dan hashing. Anda juga dapat mengenkripsi atribut alamat yang di-hash. |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
Tidak ada ekuivalen | Tidak didukung di versi Data Manager API saat ini. |
addressInfo.state |
Tidak ada ekuivalen | Tidak didukung di versi Data Manager API saat ini. |
addressInfo.hashedStreetAddress |
Tidak ada ekuivalen | Tidak didukung di versi Data Manager API saat ini. |
Kolom data keranjang
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
Catatan |
|---|---|---|
kind |
Tidak ada ekuivalen | Kolom metadata; tidak digunakan oleh Data Manager API. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Daftar objek Item. Lihat Kolom item untuk mengetahui detail selengkapnya. |
Kolom item untuk data keranjang
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
Catatan |
|---|---|---|
kind |
Tidak ada ekuivalen | Kolom metadata; tidak digunakan oleh Data Manager API. |
| Tidak ada ekuivalen | itemId |
Opsional. ID unik untuk item. |
itemId |
merchantProductId |
Wajib. Setel ke ID produk Merchant Center untuk item. |
quantity |
quantity |
Wajib. |
unitPrice |
unitPrice |
Wajib. |