Используйте сопоставления в таблицах, чтобы сопоставить запрос conversions.batchinsert в API Campaign Manager 360 с его эквивалентом в IngestEventsRequest в API Data Manager.
Поля запроса
conversions.batchinsert (API Campaign Manager 360) | IngestEventsRequest (API менеджера данных) | Примечания |
|---|---|---|
параметр пути URL profileId | Нет эквивалента | |
kind | Нет эквивалента | Поле метаданных; не используется API менеджера данных. |
conversions | events | Обязательно. Список конверсий или событий. Подробнее см. раздел «Поля конверсий» . |
encryptionInfo | Перенесено в events.adIdentifiers.encryptedUserIds | Определяется на уровне события. Информация о шифровании Campaign Manager 360 теперь указывается в каждом зашифрованном идентификаторе пользователя. См. раздел «Поля конверсии» . |
| Нет эквивалента | encryptionInfo | Информация об шифровании на уровне запроса (request-level encryptionInfo содержит данные о шифровании зашифрованных идентификаторов пользователей UserData . Подробнее см. в разделе «Шифрование» . |
| Нет эквивалента | destinations | Обязательно. Список объектов Destination , определяющих целевую учетную запись и активность Floodlight для событий. Подробности см. в руководстве по объектам назначения . Сопоставьте отдельные поля, как показано в разделе «Поля конверсии» . |
| Нет эквивалента | consent | Дополнительные настройки согласия по умолчанию для событий в запросе. Вы можете переопределить это значение для отдельного события, задав значение в поле consent для Event . |
| Нет эквивалента | encoding | Обязательно при отправке идентификаторов пользователей: установите значение, соответствующее Encoding используемой для значений UserIdentifier . Если идентификаторы пользователей не используются, это поле игнорируется. |
| Нет эквивалента | validateOnly | Если это так, запрос подтвержден, но не выполнен. |
Поля преобразования
Conversion (API Campaign Manager 360) | Event (API менеджера данных) | Примечания |
|---|---|---|
floodlightConfigurationId | destinations[].operatingAccount.accountId | Определяется на уровне запроса. Устанавливается в соответствии с идентификатором конфигурации Floodlight. |
| Нет эквивалента | destinations[].operatingAccount.accountType | Определяется на уровне запроса. Устанавливается значение FLOODLIGHT_CONFIG . |
floodlightActivityId | destinations[].productDestinationId | Определяется на уровне запроса. Устанавливается в соответствии с идентификатором действия Floodlight (ранее известным как идентификатор действия Floodlight). |
kind | Нет эквивалента | Поле метаданных; не используется API менеджера данных. |
| Нет эквивалента | destinations[].reference | Определяется на уровне запроса. Пользовательский идентификатор для пункта назначения. Установите это поле, если вы отправляете события в несколько пунктов назначения в одном запросе . |
adUserDataConsent | consent.adUserData | Более подробная информация содержится в разделе Consent . |
nonPersonalizedAd | consent.adPersonalization | Более подробная информация содержится в разделе Consent . |
| Нет эквивалента | destinationReferences | При отправке событий в несколько пунктов назначения в одном запросе установите для этого поля соответствующее reference на пункт назначения . |
timestampMicros | eventTimestamp |
Подробности см. в формате временной метки . |
value | conversionValue | |
quantity | conversionCount | |
ordinal | Нет эквивалента | Поле ordinal из API Campaign Manager 360 отсутствует в API Data Manager. Вместо него для управления дедупликацией конверсий от одного и того же пользователя и дня можно использовать transactionId .В API Campaign Manager 360 можно обеспечить дедупликацию событий, установив ordinal на фиксированное постоянное значение, например, 1 В API Data Manager transactionId должен быть установлен на уникальный идентификатор для каждого события. |
| Нет эквивалента | transactionId | В API Data Manager transactionId используется для управления процессом дедупликации конверсий от одного и того же пользователя и дня. Для каждого события в это поле необходимо установить уникальный идентификатор.Это поле является необязательным при отправке данных о конверсиях Floodlight в автономном режиме. Дополнительные сведения см. в разделе «Преобразование данных в объекты Event . |
customVariables | customVariables | Список объектов CustomVariable . API Data Manager использует строки в качестве ключей вместо перечислений. Используйте ключи типа U1 , U2 для поля variable . |
limitAdTracking | consent.adPersonalization | Более подробная информация содержится в разделе Consent . |
childDirectedTreatment | consent.adPersonalization | Более подробная информация содержится в разделе Consent . |
treatmentForUnderage | consent.adPersonalization | Более подробная информация содержится в разделе Consent . |
gclid | adIdentifiers.gclid | Более подробную информацию см. в AdIdentifiers . |
dclid | adIdentifiers.dclid | Более подробную информацию см. в AdIdentifiers . |
matchId | adIdentifiers.matchId | Более подробную информацию см. в AdIdentifiers . |
mobileDeviceId | adIdentifiers.mobileId | Более подробную информацию см. в AdIdentifiers . |
impressionId | adIdentifiers.impressionId | Более подробную информацию см. в AdIdentifiers . |
encryptedUserId | adIdentifiers.encryptedUserIds | API Data Manager поддерживает несколько зашифрованных идентификаторов пользователей. Подробнее см. в разделе AdIdentifiers . |
encryptedUserIdCandidates | adIdentifiers.encryptedUserIds | Идентификатор каждого кандидата соответствует объекту EncryptedUserId в списке. |
encryptionInfo.kind | Нет эквивалента | Поле метаданных; не используется API менеджера данных. |
encryptionInfo.encryptionEntityType | adIdentifiers.encryptedUserIds[].entityType | Вместо того чтобы указывать информацию о шифровании один раз за запрос, она указывается для каждого зашифрованного идентификатора пользователя. |
encryptionInfo.encryptionEntityId | adIdentifiers.encryptedUserIds[].entityId | Вместо того чтобы указывать информацию о шифровании один раз за запрос, она указывается для каждого зашифрованного идентификатора пользователя. |
encryptionInfo.encryptionSource | adIdentifiers.encryptedUserIds[].source | Вместо того чтобы указывать информацию о шифровании один раз за запрос, она указывается для каждого зашифрованного идентификатора пользователя. |
sessionAttributesEncoded | adIdentifiers.sessionAttributes | Более подробную информацию см. в AdIdentifiers . |
cartData | cartData | Подробности см. в разделе «Поля данных корзины» . |
userIdentifiers | userData.userIdentifiers | Подробную информацию см. в разделе «Поля идентификатора пользователя» . |
Поля идентификатора пользователя
В API Data Manager идентификаторы пользователей группируются в объекте UserData в поле userData объекта Event . Это отличается от API Campaign Manager 360, где идентификаторы напрямую прикрепляются к объекту Conversion .
UserIdentifier (API Campaign Manager 360) | UserIdentifier (API менеджера данных) | Примечания |
|---|---|---|
hashedEmail | emailAddress | Укажите отформатированный и хешированный адрес электронной почты. Вы также можете зашифровать хешированный адрес электронной почты . |
hashedPhoneNumber | phoneNumber | Установите значение для отформатированного и хешированного номера телефона. Вы также можете зашифровать хешированный номер телефона . |
addressInfo | address | Установите значение объекта AddressInfo . Следуйте рекомендациям по форматированию и хешированию . Вы также можете зашифровать хешированные атрибуты адреса . |
addressInfo.hashedFirstName | address.givenName | |
addressInfo.hashedLastName | address.familyName | |
addressInfo.countryCode | address.regionCode | |
addressInfo.postalCode | address.postalCode | |
addressInfo.city | Нет эквивалента | В текущей версии API менеджера данных эта функция не поддерживается. |
addressInfo.state | Нет эквивалента | В текущей версии API менеджера данных эта функция не поддерживается. |
addressInfo.hashedStreetAddress | Нет эквивалента | В текущей версии API менеджера данных эта функция не поддерживается. |
Поля данных корзины
CartData (API Campaign Manager 360) | CartData (API менеджера данных) | Примечания |
|---|---|---|
kind | Нет эквивалента | Поле метаданных; не используется API менеджера данных. |
merchantId | merchantId | |
merchantFeedLabel | merchantFeedLabel | |
merchantFeedLanguage | merchantFeedLanguageCode | |
items | items | Список объектов Item . Дополнительные сведения см. в разделе «Поля объекта Item» . |
Поля для ввода данных о товарах в корзину.
Item (API Campaign Manager 360) | Item (API менеджера данных) | Примечания |
|---|---|---|
kind | Нет эквивалента | Поле метаданных; не используется API менеджера данных. |
| Нет эквивалента | itemId | Необязательно. Уникальный идентификатор товара. |
itemId | merchantProductId | Обязательно. Укажите идентификатор товара в Merchant Center . |
quantity | quantity | Необходимый. |
unitPrice | unitPrice | Необходимый. |