Use os mapeamentos nas tabelas para mapear um
conversions.batchinsert na API Campaign Manager 360 para o equivalente
IngestEventsRequest na API Data Manager.
Campos de solicitação
conversions.batchinsert (API Campaign Manager 360) |
IngestEventsRequest (API Data Manager) |
Observações |
|---|---|---|
Parâmetro de caminho do URL profileId |
Não há equivalente | |
kind |
Não há equivalente | Campo de metadados; não usado pela API Data Manager. |
conversions |
events |
Obrigatório. A lista de conversões ou eventos. Consulte a seção Campos de conversão para mais detalhes. |
encryptionInfo |
Movido para events.adIdentifiers.encryptedUserIds |
Definido no nível do evento. As informações de criptografia do Campaign Manager 360 agora são especificadas em cada ID de usuário criptografado. Consulte a seção Campos de conversão. |
| Não há equivalente | encryptionInfo |
O encryptionInfo no nível da solicitação são as informações de criptografia para identificadores de usuário UserData criptografados. Consulte Criptografia para mais detalhes. |
| Não há equivalente | destinations |
Obrigatório. Uma lista de objetos Destination que definem a conta de destino e a atividade do Floodlight para os eventos. Consulte o guia Destinos para mais detalhes. Mapeie campos individuais conforme mostrado na seção Campos de conversão. |
| Não há equivalente | consent |
Configurações de consentimento padrão opcionais para eventos na solicitação. É possível substituir esse valor para um evento individual definindo o campo consent de Event. |
| Não há equivalente | encoding |
Obrigatório se você estiver enviando identificadores de usuário: defina como a Encoding usada para valores UserIdentifier. Se você não estiver usando identificadores de usuário, esse campo será ignorado. |
| Não há equivalente | validateOnly |
Se for verdadeiro, a solicitação será validada, mas não executada. |
Campos de conversão
Conversion (API Campaign Manager 360) |
Event (API Data Manager) |
Observações |
|---|---|---|
floodlightConfigurationId |
destinations[].operatingAccount.accountId |
Definido no nível da solicitação. Defina como o ID de configuração do Floodlight. |
| Não há equivalente | destinations[].operatingAccount.accountType |
Definido no nível da solicitação. Defina como FLOODLIGHT_CONFIG. |
floodlightActivityId |
destinations[].productDestinationId |
Definido no nível da solicitação. Defina como o ID da atividade do Floodlight (anteriormente conhecido como ID da atividade do Floodlight). |
kind |
Não há equivalente | Campo de metadados; não usado pela API Data Manager. |
| Não há equivalente | destinations[].reference |
Definido no nível da solicitação. Um identificador definido pelo usuário para o destino. Defina esse campo se você estiver enviando eventos para vários destinos em uma única solicitação. |
adUserDataConsent |
consent.adUserData |
Consulte Consent para mais detalhes. |
nonPersonalizedAd |
consent.adPersonalization |
Consulte Consent para mais detalhes. |
| Não há equivalente | destinationReferences |
Se você estiver enviando eventos para vários destinos em uma única solicitação, defina esse campo como a reference correspondente do destino. |
timestampMicros |
eventTimestamp |
Consulte Formato do carimbo de data/hora para mais detalhes. |
value |
conversionValue |
|
quantity |
conversionCount |
|
ordinal |
Não há equivalente |
O campo ordinal da API Campaign Manager 360 não está presente na API Data Manager.
Em vez disso, transactionId pode ser usado para controlar como as conversões do mesmo usuário e dia são eliminadas.
Na API Campaign Manager 360, você pode garantir que os eventos sejam eliminados definindo ordinal como um valor fixo e constante, como 1. Na API Data Manager, transactionId precisa ser definido como um identificador exclusivo para cada evento.
|
| Não há equivalente | transactionId |
Na API Data Manager, transactionId é usado para controlar como as conversões do mesmo usuário e dia são eliminadas. Esse campo precisa ser definido como um identificador exclusivo para cada evento.
Esse campo é opcional ao enviar conversões off-line do Floodlight. Consulte Converter os dados em Event objetos para mais
detalhes.
|
customVariables |
customVariables |
Uma lista de CustomVariable objetos. A API Data Manager usa strings como chaves em vez de enums. Use chaves como U1, U2 para o campo variable. |
limitAdTracking |
consent.adPersonalization |
Consulte Consent para mais detalhes. |
childDirectedTreatment |
consent.adPersonalization |
Consulte Consent para mais detalhes. |
treatmentForUnderage |
consent.adPersonalization |
Consulte Consent para mais detalhes. |
gclid |
adIdentifiers.gclid |
Consulte AdIdentifiers para mais detalhes. |
dclid |
adIdentifiers.dclid |
Consulte AdIdentifiers para mais detalhes. |
matchId |
adIdentifiers.matchId |
Consulte AdIdentifiers para mais detalhes. |
mobileDeviceId |
adIdentifiers.mobileId |
Consulte AdIdentifiers para mais detalhes. |
impressionId |
adIdentifiers.impressionId |
Consulte AdIdentifiers para mais detalhes. |
encryptedUserId |
adIdentifiers.encryptedUserIds |
A API Data Manager oferece suporte a vários IDs de usuário criptografados. Consulte AdIdentifiers para mais detalhes. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Cada ID de candidato é mapeado para um EncryptedUserId objeto na lista. |
encryptionInfo.kind |
Não há equivalente | Campo de metadados; não usado pela API Data Manager. |
encryptionInfo.encryptionEntityType |
adIdentifiers.encryptedUserIds[].entityType |
Em vez de especificar as informações de criptografia uma vez por solicitação, elas são especificadas por ID de usuário criptografado. |
encryptionInfo.encryptionEntityId |
adIdentifiers.encryptedUserIds[].entityId |
Em vez de especificar as informações de criptografia uma vez por solicitação, elas são especificadas por ID de usuário criptografado. |
encryptionInfo.encryptionSource |
adIdentifiers.encryptedUserIds[].source |
Em vez de especificar as informações de criptografia uma vez por solicitação, elas são especificadas por ID de usuário criptografado. |
sessionAttributesEncoded |
adIdentifiers.sessionAttributes |
Consulte AdIdentifiers para mais detalhes. |
cartData |
cartData |
Consulte Campos de dados do carrinho para mais detalhes. |
userIdentifiers |
userData.userIdentifiers |
Consulte Campos do identificador de usuário para mais detalhes. |
Campos do identificador de usuário
Na API Data Manager, os identificadores de usuário são agrupados em um
UserData objeto no campo userData do
Event. Isso difere da API Campaign Manager 360, em que os identificadores são anexados diretamente ao objeto Conversion.
UserIdentifier (API Campaign Manager 360) |
UserIdentifier (API Data Manager) |
Observações |
|---|---|---|
hashedEmail |
emailAddress |
Defina como o endereço de e-mail formatado e com hash. Também é possível criptografar o endereço de e-mail com hash. |
hashedPhoneNumber |
phoneNumber |
Defina como o número de telefone formatado e com hash. Também é possível criptografar o número de telefone com hash. |
addressInfo |
address |
Defina como um AddressInfo objeto. Siga as diretrizes de formatação e hash. Também é possível criptografar os atributos com hash de um endereço. |
addressInfo.hashedFirstName |
address.givenName |
|
addressInfo.hashedLastName |
address.familyName |
|
addressInfo.countryCode |
address.regionCode |
|
addressInfo.postalCode |
address.postalCode |
|
addressInfo.city |
Não há equivalente | Não é compatível com a versão atual da API Data Manager. |
addressInfo.state |
Não há equivalente | Não é compatível com a versão atual da API Data Manager. |
addressInfo.hashedStreetAddress |
Não há equivalente | Não é compatível com a versão atual da API Data Manager. |
Campos de dados do carrinho
CartData (API Campaign Manager 360) |
CartData (API Data Manager) |
Observações |
|---|---|---|
kind |
Não há equivalente | Campo de metadados; não usado pela API Data Manager. |
merchantId |
merchantId |
|
merchantFeedLabel |
merchantFeedLabel |
|
merchantFeedLanguage |
merchantFeedLanguageCode |
|
items |
items |
Uma lista de Item objetos. Consulte Campos de itens para mais detalhes. |
Campos de itens para dados do carrinho
Item (API Campaign Manager 360) |
Item (API Data Manager) |
Observações |
|---|---|---|
kind |
Não há equivalente | Campo de metadados; não usado pela API Data Manager. |
| Não há equivalente | itemId |
Opcional. Um identificador exclusivo do item. |
itemId |
merchantProductId |
Obrigatório. Defina como o ID do produto do Merchant Center para o item. |
quantity |
quantity |
Obrigatório. |
unitPrice |
unitPrice |
Obrigatório. |