Conversions

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Quando um usuário realiza uma ação desejada após ver o anúncio, isso é uma "conversão".

{
  "kind": "dfareporting#conversion",
  "floodlightConfigurationId": long,
  "floodlightActivityId": long,
  "encryptedUserId": string,
  "encryptedUserIdCandidates": [
    string
  ],
  "matchId": string,
  "mobileDeviceId": string,
  "gclid": string,
  "dclid": string,
  "limitAdTracking": boolean,
  "childDirectedTreatment": boolean,
  "nonPersonalizedAd": boolean,
  "treatmentForUnderage": boolean,
  "timestampMicros": long,
  "value": double,
  "quantity": long,
  "ordinal": string,
  "customVariables": [
    {
      "kind": "dfareporting#customFloodlightVariable",
      "type": string,
      "value": string
    }
  ]
}
Nome da propriedade Valor Descrição Observações
childDirectedTreatment boolean Indica se esta solicitação específica pode ter sido gerada por um usuário com menos de 13 anos, de acordo com o previsto na COPPA.
customVariables[] list São variáveis personalizadas do Floodlight.
customVariables[].kind string Identifica o tipo de recurso. Valor: a string fixa "dfareporting#customFloodlightVariable".
customVariables[].type string É o tipo de variável personalizada do Floodlight a que o valor será informado. Eles são mapeadas para "u[1-20]=" nas tags.

Os valores aceitáveis são os seguintes:
  • "U1"
  • "U10"
  • "U100"
  • "U11"
  • "U12"
  • "U13"
  • "U14"
  • "U15"
  • "U16"
  • "U17"
  • "U18"
  • "U19"
  • "U2"
  • "U20"
  • "U21"
  • "U22"
  • "U23"
  • "U24"
  • "U25"
  • "U26"
  • "U27"
  • "U28"
  • "U29"
  • "U3"
  • "U30"
  • "U31"
  • "U32"
  • "U33"
  • "U34"
  • "U35"
  • "U36"
  • "U37"
  • "U38"
  • "U39"
  • "U4"
  • "U40"
  • "U41"
  • "U42"
  • "U43"
  • "U44"
  • "U45"
  • "U46"
  • "U47"
  • "U48"
  • "U49"
  • "U5"
  • "U50"
  • "U51"
  • "U52"
  • "U53"
  • "U54"
  • "U55"
  • "U56"
  • "U57"
  • "U58"
  • "U59"
  • "U6"
  • "U60"
  • "U61"
  • "U62"
  • "U63"
  • "U64"
  • "U65"
  • "U66"
  • "U67"
  • "U68"
  • "U69"
  • "U7"
  • "U70"
  • "U71"
  • "U72"
  • "U73"
  • "U74"
  • "U75"
  • "U76"
  • "U77"
  • "U78"
  • "U79"
  • "U8"
  • "U80"
  • "U81"
  • "U82"
  • "U83"
  • "U84"
  • "U85"
  • "U86"
  • "U87"
  • "U88"
  • "U89"
  • "U9"
  • "U90"
  • "U91"
  • "U92"
  • "U93"
  • "U94"
  • "U95"
  • "U96"
  • "U97"
  • "U98"
  • "U99"
customVariables[].value string É o valor da variável personalizada do Floodlight. A string não pode exceder 50 caracteres.
dclid string É o ID de clique de display. Este campo é mutuamente exclusivo com encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId e gclid. É obrigatório usar este campo, encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId ou gclid.
encryptedUserId string É o ID do usuário alfanumérico criptografado. Quando definido, encryptionInfo também precisa ser especificado. Este campo é mutuamente exclusivo com encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid e dclid. É obrigatório usar este campo, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid ou dclid.
encryptedUserIdCandidates[] list É uma lista de IDs do usuário alfanuméricos criptografados. Qualquer ID de usuário com exposição antes do carimbo de data/hora será usado na conversão inserida. Se nenhum ID de usuário for encontrado, a conversão será rejeitada com o erro INVALID_ARGUMENT. Quando definido, encryptionInfo também precisa ser especificado. Este campo só pode ser usado ao chamar batchinsert. Ele não é compatível com batchupdate. Este campo é mutuamente exclusivo com encryptedUserId, matchId, mobileDeviceId, gclid e dclid. É obrigatório usar este campo, encryptedUserId, matchId, mobileDeviceId, gclid ou dclid.
floodlightActivityId long É o ID da atividade do Floodlight desta conversão. Este campo é obrigatório.
floodlightConfigurationId long É o ID da configuração do Floodlight desta conversão. Este campo é obrigatório.
gclid string É o ID de clique do Google. Este campo é mutuamente exclusivo com encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId e dclid. É obrigatório usar este campo, encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId ou dclid.
kind string Identifica o tipo de recurso. Valor: a string fixa "dfareporting#conversion".
limitAdTracking boolean Indica se a opção de limitar o rastreamento de anúncios está ativada. Ao definir como verdadeiro, a conversão será usada para a geração de relatórios, mas não para a segmentação. Isso impedirá o remarketing.
matchId string É o campo "ID de correspondência". Um ID de correspondência é seu próprio identificador primário que foi sincronizado com o Google usando o recurso de ID de correspondência no Floodlight. Este campo é mutuamente exclusivo com encryptedUserId, encryptedUserIdCandidates[], mobileDeviceId, gclid e dclid. É obrigatório usar este campo, encryptedUserId, encryptedUserIdCandidates[], mobileDeviceId, gclid ou dclid.
mobileDeviceId string É o ID do dispositivo móvel. Este campo é mutuamente exclusivo com encryptedUserId, encryptedUserIdCandidates[], matchId, gclid e dclid. É obrigatório usar este campo, encryptedUserId, encryptedUserIdCandidates[], matchId, gclid ou dclid.
nonPersonalizedAd boolean Indica se a conversão foi feita para um anúncio não personalizado.
ordinal string É o valor ordinal da conversão. Use este campo para controlar como são eliminadas as duplicações das conversões do mesmo usuário e dia. Este campo é obrigatório.
quantity long É a quantidade da conversão.
timestampMicros long É o carimbo de data/hora da conversão, em microssegundos, desde a Era Unix. Este campo é obrigatório.
treatmentForUnderage boolean Indica se esta solicitação específica pode ter sido originada por um usuário com menos de 16 anos de idade, em cumprimento do Regulamento geral de proteção de dados (GDPR, na sigla em inglês) da União Europeia.
value double É o valor da conversão.

Métodos

batchinsert
Insere conversões.
batchupdate
Atualiza as conversões existentes.