Perguntas frequentes
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
- Existe alguma restrição de qual upload pode ser feito?
Há algumas restrições:
- Cada solicitação
batchinsert ou batchupdate
tem um limite de mil conversões.
- O carimbo de data/hora de uma conversão pode ter no máximo 28 dias a partir do
momento do envio.
- Só é possível enviar conversões a configurações do Floodlight que o
perfil de usuário do Campaign Manager 360 pode acessar.
- Devo usar o Campaign Manager 360 ou o Search Ads 360 para fazer upload de conversões?
Consulte a Central de Ajuda do Search Ads 360 para uma comparação detalhada dos recursos oferecidos pelos dois produtos.
- E se eu inserir a mesma conversão no Campaign Manager 360 e no Search Ads 360?
Se você inserir a mesma conversão no Campaign Manager 360 e no Search Ads
360, a duplicação das entradas não será eliminada. Nesse caso, use atividades do Floodlight
separadas.
- O que é um valor ordinal? Como ele é usado?
Os valores ordinais controlam o processamento das conversões duplicadas. Se várias
conversões forem inseridas com os mesmos valores, identificador de usuário e
data de conversão do Floodlight, o ordinal será usado para determinar se:
- a duplicação das conversões será eliminada, restando apenas uma delas. Isso acontece quando
todas as conversões têm o mesmo valor ordinal.
- as conversões serão processadas individualmente e todas elas serão mantidas. Isso acontece
quando todas as conversões têm valores ordinais diferentes.
Os valores não precisam ter um significado. Em geral, usar um valor
fixo (como 1) para todas as conversões fará com que a duplicação seja eliminada.
Usar um valor aleatório ou exclusivo para cada conversão desativa essa opção.
- O que significa quando um upload de
mobileDeviceId falha devido a um erro de NOT_FOUND?
As causas mais comuns desse erro são:
- O
mobileDeviceId é inválido.
- O
mobileDeviceId é desconhecido para o Search Ads 360. Isso significa que o
dispositivo ainda não recebeu um anúncio do Campaign Manager 360.
- O que significa quando um upload de
gclid falha devido a um erro de NOT_FOUND?
As causas mais comuns desse erro são:
- O
gclid é inválido.
- O
gclid não está associado a uma campanha do Search Ads 360 ou a um item de linha do YouTube do Display & Video 360. Isso pode ocorrer quando o gclid é coletado de um redirecionamento de clique do Google Ads que não passou pelo Search Ads 360 (por exemplo, cliques em extensões de local) ou de um redirecionamento de clique do anúncio do YouTube não associado a um item de linha do Display & Video 360 do YouTube.
- O clique associado ao
gclid ocorreu há muito tempo.
Só é possível inserir conversões de cliques com até 60 dias.
- O clique associado ao
gclid ocorreu muito recentemente. Recomendamos
adiar os uploads de conversão com base em gclid em uma hora para garantir que o
gclid seja processado e esteja disponível para correspondência.
- O que significa quando um upload de
dclid falha devido a um erro de NOT_FOUND?
As causas mais comuns desse erro são:
- O
dclid é inválido.
- O clique associado ao
dclid ocorreu há muito tempo.
Só é possível inserir conversões de cliques com até 60 dias.
- O clique associado ao
dclid ocorreu muito recentemente. Recomendamos
adiar os uploads de conversão com base em dclid em uma hora para garantir que o
dclid seja processado e esteja disponível para correspondência.
- O que significa quando um upload de
matchId falha devido a um erro de NOT_FOUND?
As causas mais comuns desse erro são:
- O
matchId é desconhecido para o Campaign Manager 360. Isso pode ocorrer se a
matchId foi coletada de uma chamada do Floodlight que não foi transmitida corretamente
pelo Campaign Manager 360. Verifique se as chamadas do Floodlight estão
funcionando corretamente, incluindo o parâmetro da tag matchId.
- A chamada do Floodlight associada ao
matchId não continha um cookie. A chamada do Floodlight precisa conter um cookie / identificador para que o Campaign Manager 360 armazene o matchId corretamente. Por exemplo, o usuário pode ter bloqueado os cookies ou desativado a opção.
- A chamada de floodlight associada ao
matchId ocorreu há muito tempo. Os uploads de conversões off-line precisam ser feitos em até 60 dias após a
chamada do Floodlight que contém o matchId.
- A chamada do Floodlight associada ao
matchId ocorreu muito recentemente.
Recomendamos atrasar os uploads de conversão com base em matchId em duas horas para
garantir que o matchId seja processado e esteja disponível para correspondência.
- As conversões off-line com um carimbo de data/hora anterior à criação da atividade do Floodlight são incluídas nos relatórios?
O upload de conversões off-line com um carimbo de data/hora anterior à criação da atividade do Floodlight pode ser informado como impressões do Floodlight e como conversões não atribuídas/atribuídas, até 28 dias antes do envio. No entanto, esse comportamento não é garantido e não deve ser usado. A prática recomendada é criar atividades do Floodlight antes do carimbo de data/hora mais antigo de uma conversão off-line.
- Qual consentimento é necessário para usar a inserção de conversões off-line na criação de listas de público-alvo?
Além do consentimento de dados do usuário do anúncio, o campo nonPersonalizedAd precisa ser definido explicitamente como false para permitir a criação de listas de público-alvo.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 2025-08-31 UTC."],[[["\u003cp\u003eConversion uploads are restricted by quantity (1,000 per request), recency (28 days old maximum), and user profile access.\u003c/p\u003e\n"],["\u003cp\u003eDuplicate conversions can be controlled using ordinal values; identical values deduplicate, while unique values allow all conversions.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eNOT_FOUND\u003c/code\u003e errors for identifiers (\u003ccode\u003emobileDeviceId\u003c/code\u003e, \u003ccode\u003egclid\u003c/code\u003e, \u003ccode\u003ematchId\u003c/code\u003e) often indicate invalid IDs, unknown IDs to the system, or timing issues.\u003c/p\u003e\n"],["\u003cp\u003eAlthough conversions with timestamps before a Floodlight Activity's creation might be reported, it's best to create the activity beforehand for reliable reporting.\u003c/p\u003e\n"]]],[],null,["# Frequently asked questions\n\nAre there any restrictions on what I can upload?\n\n: There are a few restrictions to be aware of:\n\n - Individual `batchinsert` and `batchupdate` requests are limited to 1,000 conversions.\n - The timestamp of a conversion can be **at most** 28 days old from the time of submission.\n - You can only submit conversions to a Floodlight configuration to which your Campaign Manager 360 user profile has access.\n\nShould I use Campaign Manager 360 or Search Ads 360 to upload conversions?\n\n: Refer to the [Search Ads 360 help center](//support.google.com/searchads/answer/7384231) for a detailed\n comparison of features offered by both products.\n\nWhat if I insert the same conversion to both Campaign Manager 360 and Search Ads 360?\n\n: If you insert the same conversion to both Campaign Manager 360 and Search Ads\n 360, the entries will not be deduplicated. Please use separate Floodlight\n activities in this case.\n\nWhat is an ordinal value and how is it used?\n\n: Ordinal values control how duplicate conversions are processed. If multiple\n conversions are inserted with the same Floodlight values, user identifier, and\n conversion date, the ordinal is used to determine whether:\n\n - The conversions are deduplicated and only one survives. This happens if all conversions have the **same** ordinal value.\n - The conversions are processed individually and all survive. This happens if all conversions have a **different** ordinal value.\n\n The values themselves don't need to be meaningful. In general, using a fixed\n value (such as `1`) for all conversions will enable deduplication.\n Using a random or unique value for each conversion will disable it.\n\nWhat does it mean when a `mobileDeviceId` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `mobileDeviceId` is invalid.\n - The `mobileDeviceId` is unknown to Search Ads 360. This means that the device has yet to be served an ad by Campaign Manager 360.\n\nWhat does it mean when a `gclid` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `gclid` is invalid.\n - The `gclid` is not associated with a Search Ads 360 campaign or a Display \\& Video 360 YouTube line item. This may occur if the `gclid` was collected from a Google Ads click redirect which did not pass through Search Ads 360 (e.g., clicks on location extensions) or collected from a YouTube ad click redirect not associated with a Display \\& Video 360 YouTube line item.\n - The click associated with the `gclid` occurred too far in the past. Conversions may only be inserted for clicks up to 60 days old.\n - The click associated with the `gclid` occurred too recently. We recommend delaying `gclid`-based conversion uploads by 1 hour to ensure that the `gclid` is processed and available for matching.\n\nWhat does it mean when a `dclid` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `dclid` is invalid.\n - The click associated with the `dclid` occurred too far in the past. Conversions may only be inserted for clicks up to 60 days old.\n - The click associated with the `dclid` occurred too recently. We recommend delaying `dclid`-based conversion uploads by 1 hour to ensure that the `dclid` is processed and available for matching.\n\nWhat does it mean when a `matchId` upload fails due to a `NOT_FOUND` error?\n\n: The most common causes of this error are:\n\n - The `matchId` is unknown to Campaign Manager 360. This may occur if the `matchId` was collected from a Floodlight call which did not properly pass through Campaign Manager 360 (make sure your Floodlight calls are working correctly including the `matchId` tag parameter).\n - The Floodlight call associated with the `matchId` didn't contain a cookie. The Floodlight call must contain a cookie / identifier for Campaign Manager 360 to store the `matchId` correctly (ie. user may have blocked cookies or opted out).\n - The Floodligh call associated with the `matchId` occurred too far in the past. Offline Conversion uploads must be made within 60 days of the Floodlight call containing the `matchId`.\n - The Floodlight call associated with the `matchId` occurred too recently. We recommend delaying `matchId`-based conversion uploads by 2 hours to ensure that the `matchId` is processed and available for matching.\n\nAre offline conversions with a timestamp prior to the creation of the Floodlight Activity included in reports?\n\n: The upload of offline conversions with a timestamp prior to the creation of\n the Floodlight Activity could be reported as Floodlight impressions and as\n unattributed/attributed conversions, up to 28 days prior from the time of\n submission. However, this behavior is not guaranteed and shouldn't be relied\n upon. The best practice is to create Floodlight Activities before the earliest\n timestamp of an offline conversion.\n\nWhat consent is necessary to use Offline Conversion Insertion for audience list creation?\n\n: In addition to ad user data consent, the `nonPersonalizedAd` field must be\n explicitly set to `false` to enable audience list creation."]]
