Используйте сопоставления в таблицах, чтобы сопоставить 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.
В API Менеджера кампаний 360 вы можете обеспечить дедупликацию событий, задав для 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. В этом заключается отличие от Campaign Manager 360 API, где идентификаторы напрямую прикрепляются к объекту 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 |
Обязательно. |