Используйте сопоставления в таблицах, чтобы сопоставить conversions.batchinsert в Менеджере кампаний 360 API с эквивалентным IngestEventsRequest в Data Manager API.
Аутентификация
Для Data Manager API требуются учетные данные с другой областью действия, чем для Менеджера кампаний 360 API. Следуйте инструкциям в разделе Настройте доступ к API, чтобы создать новые учетные данные, включающие область действия Data Manager API.
Поля запроса
conversions.batchinsert (Campaign Manager 360 API) |
IngestEventsRequest (Data Manager API) |
Примечания |
|---|---|---|
profileId Параметр пути URL |
Ранее такого отчета не существовало | |
kind |
Ранее такого отчета не существовало | Поле для метаданных, не используется Data Manager API. |
conversions |
events |
Обязательно. Список конверсий или событий. Подробнее о полях конверсий… |
encryptionInfo |
Файл перемещен в папку "events.adIdentifiers.encryptedUserIds". |
Определяется на уровне события. Информация о шифровании Менеджера кампаний 360 теперь указывается в каждом зашифрованном идентификаторе пользователя. Подробнее о полях конверсий… |
| Ранее такого отчета не существовало | encryptionInfo |
encryptionInfo на уровне запроса – это информация о шифровании для зашифрованных идентификаторов пользователей UserData. Подробнее о шифровании… |
| Ранее такого отчета не существовало | destinations |
Обязательно. Список объектов Destination, определяющих целевой аккаунт и действие Floodlight для событий. Подробную информацию вы найдете в руководстве по целевым страницам. Сопоставьте отдельные поля, как показано в разделе "Поля конверсий". |
| Ранее такого отчета не существовало | consent |
Необязательные настройки согласия по умолчанию для событий в запросе. Вы можете переопределить это значение для отдельного события, задав поле consent объекта Event. |
| Ранее такого отчета не существовало | encoding |
Обязательный атрибут, если вы отправляете идентификаторы пользователей. Укажите Encoding, используемый для значений UserIdentifier. Если идентификаторы пользователей не используются, это поле игнорируется. |
| Ранее такого отчета не существовало | validateOnly |
Если значение равно true, запрос проверяется, но не выполняется. |
Поля конверсий
Conversion (Campaign Manager 360 API) |
Event (Data Manager API) |
Примечания |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Определяется на уровне запроса. Укажите идентификатор конфигурации Floodlight. |
| Ранее такого отчета не существовало | destinations[].operatingAccount.accountType |
Определяется на уровне запроса. Должен принимать значение FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Определяется на уровне запроса. Установите идентификатор действия Floodlight. |
kind |
Ранее такого отчета не существовало | Поле для метаданных, не используется Data Manager API. |
| Ранее такого отчета не существовало | destinations[].reference |
Определяется на уровне запроса. Идентификатор, заданный пользователем для целевого местоположения. Укажите это поле, если вы отправляете события в несколько мест назначения в одном запросе. |
adUserDataConsent |
consent.adUserData |
Подробнее о Consent… |
nonPersonalizedAd |
consent.adPersonalization |
Подробнее о Consent… |
| Ранее такого отчета не существовало | destinationReferences |
Если вы отправляете события в несколько целевых сервисов в одном запросе, задайте для этого поля значение reference из целевого сервиса. |
timestampMicros |
eventTimestamp |
Подробнее о формате временной метки… |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Ранее такого отчета не существовало |
Поле ordinal из Campaign Manager 360 API отсутствует в Data Manager API.
Вместо этого Data Manager API использует transactionId для дедупликации событий, отправленных с одним и тем же идентификатором действия Floodlight.
В Campaign Manager 360 API можно настроить дедупликацию событий, задав для параметра ordinal постоянное значение, например 1. В Data Manager API для параметра transactionId необходимо задать уникальный идентификатор для каждого события.
|
| Ранее такого отчета не существовало | transactionId |
Data Manager API использует сочетание идентификатора действия Floodlight и transactionId для дедупликации события. Поле transactionId должно содержать уникальный идентификатор для каждого события.
Обязательный, если вы отправляете события для конверсий из нескольких источников. Подробнее о том, как преобразовать данные в объекты Event…
|
customVariables |
customVariables |
Список объектов CustomVariable. В Data Manager API в качестве ключей используются строки, а не перечисления. Используйте клавиши, например 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 |
Data Manager API поддерживает несколько зашифрованных идентификаторов пользователей. Подробнее о AdIdentifiers… |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Каждому идентификатору кандидата соответствует объект EncryptedUserId в списке. |
encryptionInfo.kind |
Ранее такого отчета не существовало | Поле для метаданных, не используется Data Manager 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 |
Подробнее о полях с идентификатором пользователя… |
Поля с идентификатором пользователя
В Data Manager API идентификаторы пользователей сгруппированы в объекте UserData в поле userData объекта Event. Это отличается от API Менеджера кампаний 360, где идентификаторы напрямую прикрепляются к объекту Conversion.
UserIdentifier (Campaign Manager 360 API) |
UserIdentifier (Data Manager 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 |
Ранее такого отчета не существовало | Не поддерживается для целевых страниц Менеджера кампаний 360. |
addressInfo.state |
Ранее такого отчета не существовало | Не поддерживается для целевых страниц Менеджера кампаний 360. |
addressInfo.hashedStreetAddress |
Ранее такого отчета не существовало | Не поддерживается для целевых страниц Менеджера кампаний 360. |
Поля данных корзины
CartData (Campaign Manager 360 API) |
CartData (Data Manager API) |
Примечания |
|---|---|---|
kind |
Ранее такого отчета не существовало | Поле для метаданных, не используется Data Manager API. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Список объектов Item. Подробнее о полях объектов… |
Поля товаров для данных корзины
Item (Campaign Manager 360 API) |
Item (Data Manager API) |
Примечания |
|---|---|---|
kind |
Ранее такого отчета не существовало | Поле для метаданных, не используется Data Manager API. |
| Ранее такого отчета не существовало | itemId |
Необязательное поле. Уникальный идентификатор объекта. |
itemId |
merchantProductId |
Обязательно. Укажите идентификатор товара из Merchant Center. |
quantity |
quantity |
Обязательно. |
unitPrice |
unitPrice |
Обязательно. |