Gunakan pemetaan dalam tabel untuk memetakan an
conversions.batchinsert di Campaign Manager 360 API ke its
IngestEventsRequest yang setara di Data Manager API.
Kolom permintaan
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Catatan |
|---|---|---|
Parameter jalur URL profileId |
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 terenkripsi.encryptionInfo 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 peristiwa dengan menetapkan kolom consent dari Event. |
| Tidak ada ekuivalen | encoding |
Wajib jika mengirim ID pengguna: Tetapkan ke Encoding yang digunakan untuk nilai UserIdentifier. Jika tidak menggunakan ID pengguna, kolom ini akan diabaikan. |
| Tidak ada ekuivalen | validateOnly |
Jika benar (true), permintaan akan divalidasi, tetapi tidak dieksekusi. |
Kolom konversi
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
Catatan |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Ditentukan di tingkat permintaan. Tetapkan 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. Tetapkan 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. Tetapkan 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, tetapkan kolom ini ke reference 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 penghapusan duplikat konversi dari pengguna dan hari yang sama.
Di Campaign Manager 360 API, Anda dapat memastikan peristiwa akan dihapus duplikatnya 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 penghapusan duplikat konversi dari pengguna dan hari yang sama. Kolom ini harus ditetapkan ke ID unik untuk setiap peristiwa.
Kolom ini bersifat opsional saat mengirim konversi offline Floodlight. Lihat Mengonversi data ke objek Eventuntuk 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 enkripsi ditentukan per ID pengguna terenkripsi. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Daripada menentukan info enkripsi sekali per permintaan, info enkripsi ditentukan per ID pengguna terenkripsi. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Daripada menentukan info enkripsi sekali per permintaan, info enkripsi 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
UserData objek di bagian kolom userData dari
Event. Hal ini berbeda dengan Campaign Manager 360 API, tempat ID langsung dilampirkan ke objek Conversion.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager API) |
Catatan |
|---|---|---|
hashedEmail |
emailAddress |
Tetapkan ke alamat email yang diformat dan di-hash. Anda juga dapat mengenktipsi alamat email yang di-hash. |
hashedPhoneNumber |
phoneNumber |
Tetapkan ke nomor telepon yang diformat dan di-hash. Anda juga dapat mengenktipsi nomor telepon yang di-hash. |
addressInfo |
address |
Tetapkan ke objek AddressInfo. Ikuti panduan pemformatan dan hashing. Anda juga dapat mengenktipsi 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 Data Manager API versi saat ini. |
addressInfo.state |
Tidak ada ekuivalen | Tidak didukung di Data Manager API versi saat ini. |
addressInfo.hashedStreetAddress |
Tidak ada ekuivalen | Tidak didukung di Data Manager API versi 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. Tetapkan ke ID produk Merchant Center untuk item. |
quantity |
quantity |
Wajib. |
unitPrice |
unitPrice |
Wajib. |