Use os mapeamentos nas tabelas para mapear um
conversions.batchinsert na API Campaign Manager 360 para o equivalente
IngestEventsRequest na API Data Manager.
Autenticação
A API Data Manager exige credenciais com um escopo diferente da API Campaign Manager 360. Siga as etapas em Configurar o acesso à API para gerar novas credenciais que incluem o escopo da API Data Manager.
Campos de solicitação
conversions.batchinsert (API Campaign Manager 360) |
IngestEventsRequest (API Data Manager) |
Observações |
|---|---|---|
profileId Parâmetro de caminho do URL |
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 de destinos para mais detalhes. Mapeie os 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 em um evento específico definindo o campo consent de Event. |
| Não há equivalente | encoding |
Obrigatório se você estiver enviando identificadores de usuário:defina como o Encoding usado para valores de 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. Definido 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. Definido como o 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 este campo como o 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, a API Data Manager usa transactionId para remover eventos duplicados enviados ao mesmo ID de atividade do Floodlight.
Na API do Campaign Manager 360, é possível garantir que os eventos sejam duplicados 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 |
A API Data Manager usa uma combinação de ID de atividade do Floodlight e transactionId para remover a duplicação do evento. O campo transactionId precisa ser definido como um identificador exclusivo para cada evento.
Obrigatório ao enviar eventos para conversões de várias origens. Consulte Converter os dados em objetos Event para mais detalhes.
|
customVariables |
customVariables |
Uma lista de objetos CustomVariable. A API Data Manager usa strings como chaves em vez de enums. Use chaves como U1 e 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 é compatível com vários IDs de usuário criptografados. Consulte AdIdentifiers para mais detalhes. |
encryptedUserIdCandidates |
adIdentifiers.encryptedUserIds |
Cada ID de candidato é mapeado para um objeto EncryptedUserId 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 de identificador do 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 objeto
UserData no campo userData do
Event. Isso é diferente da API do 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 |
Definido 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 |
Definido como o número de telefone formatado e com hash. Também é possível criptografar o número de telefone com hash. |
addressInfo |
address |
Definido como um objeto AddressInfo. Siga as diretrizes de formatação e hash. Também é possível criptografar os atributos 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 destinos do Campaign Manager 360. |
addressInfo.state |
Não há equivalente | Não é compatível com destinos do Campaign Manager 360. |
addressInfo.hashedStreetAddress |
Não há equivalente | Não é compatível com destinos do Campaign Manager 360. |
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 objetos Item. Consulte Campos de item para mais detalhes. |
Campos de item 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. Definido como o ID do produto do Merchant Center do item. |
quantity |
quantity |
Obrigatório. |
unitPrice |
unitPrice |
Obrigatório. |