Cuidado: você está vendo a documentação da interface REST da API. A maioria das nossas bibliotecas de cliente oficiais usa o gRPC. Consulte Introdução ao REST para ver mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

OfflineUserDataJob

Representação JSON
OfflineUserDataJobType
OfflineUserDataJobStatus
OfflineUserDataJobFailureReason
OfflineUserDataJobMetadata
- Representação JSON
OfflineUserDataJobMatchRateRange
StoreSalesMetadata
- Representação JSON
StoreSalesThirdPartyMetadata
- Representação JSON

Um job que contém dados de usuários off-line sobre visitantes da loja ou membros da lista de usuários que serão processados de maneira assíncrona. Os dados enviados não estão legíveis, e os resultados do processamento da vaga só podem ser lidos usando GoogleAdsService.Search/SearchStream.

Representação JSON

Representação JSON
{ "resourceName": string, "type": enum (`OfflineUserDataJobType`), "status": enum (`OfflineUserDataJobStatus`), "failureReason": enum (`OfflineUserDataJobFailureReason`), "operationMetadata": { object (`OfflineUserDataJobMetadata`) }, "id": string, "externalId": string, // Union field `metadata` can be only one of the following: "customerMatchUserListMetadata": { object (`CustomerMatchUserListMetadata`) }, "storeSalesMetadata": { object (`StoreSalesMetadata`) } // End of list of possible types for union field `metadata`. }

{
  "resourceName": string,
  "type": enum (OfflineUserDataJobType),
  "status": enum (OfflineUserDataJobStatus),
  "failureReason": enum (OfflineUserDataJobFailureReason),
  "operationMetadata": {
    object (OfflineUserDataJobMetadata)
  },
  "id": string,
  "externalId": string,

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  },
  "storeSalesMetadata": {
    object (StoreSalesMetadata)
  }
  // End of list of possible types for union field metadata.
}

Campos
`resourceName`	`string` Imutável. O nome do recurso do job de dados off-line do usuário. Os nomes dos recursos dos jobs de dados do usuário off-line têm o seguinte formato: `customers/{customerId}/offlineUserDataJobs/{offline_user_data_job_id}`
`type`	`enum (OfflineUserDataJobType)` Imutável. Tipo do job.
`status`	`enum (OfflineUserDataJobStatus)` Apenas saída. Status do job.
`failureReason`	`enum (OfflineUserDataJobFailureReason)` Apenas saída. Motivo da falha no processamento (caso o status seja FAILED).
`operationMetadata`	`object (OfflineUserDataJobMetadata)` Apenas saída. Metadados do job de dados off-line do usuário representando o intervalo da taxa de correspondência.
`id`	`string (int64 format)` Apenas saída. ID deste job de dados off-line do usuário.
`externalId`	`string (int64 format)` Imutável. ID da tarefa especificado pelo usuário.
Campo de união `metadata`. Metadados do job. `metadata` pode ser apenas de um dos tipos a seguir:
`customerMatchUserListMetadata`	`object (CustomerMatchUserListMetadata)` Imutável. Metadados para atualizações de dados em uma lista de usuários baseada em CRM.
`storeSalesMetadata`	`object (StoreSalesMetadata)` Imutável. Os metadados da atualização dos dados de vendas na loja.

OfflineUserDataJobType

O tipo de um job de dados do usuário off-line.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
`STORE_SALES_UPLOAD_FIRST_PARTY`	Dados diretos de vendas na loja para autoatendimento.
`STORE_SALES_UPLOAD_THIRD_PARTY`	Dados de vendas na loja de terceiros.
`CUSTOMER_MATCH_USER_LIST`	Dados da lista de usuários da Segmentação por lista de clientes.
`CUSTOMER_MATCH_WITH_ATTRIBUTES`	Segmentação por lista de clientes com dados de atributos.

OfflineUserDataJobStatus

O status de um job de dados do usuário off-line.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
`PENDING`	O job foi criado e está pendente para upload.
`RUNNING`	Os uploads foram aceitos e os dados estão sendo processados.
`SUCCESS`	Os dados enviados foram processados.
`FAILED`	Falha ao processar os dados enviados.

OfflineUserDataJobFailureReason

O motivo da falha de um job de dados do usuário off-line.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Usado apenas para valor de retorno. Representa um valor desconhecido nesta versão.
`INSUFFICIENT_MATCHED_TRANSACTIONS`	As transações correspondidas são insuficientes.
`INSUFFICIENT_TRANSACTIONS`	As transações enviadas são insuficientes.
`HIGH_AVERAGE_TRANSACTION_VALUE`	O valor médio de transação é excepcionalmente alto para sua conta. Se isso for intencional, entre em contato com o suporte para solicitar uma exceção. Saiba mais em https://support.google.com/google-ads/answer/10018944#transaction_value
`LOW_AVERAGE_TRANSACTION_VALUE`	O valor médio de transação é excepcionalmente baixo para sua conta. Se isso for intencional, entre em contato com o suporte para solicitar uma exceção. Saiba mais em https://support.google.com/google-ads/answer/10018944#transaction_value
`NEWLY_OBSERVED_CURRENCY_CODE`	Há um código de moeda que você não usou antes nos seus uploads. Se isso for intencional, entre em contato com o suporte para solicitar uma exceção. Saiba mais em https://support.google.com/google-ads/answer/10018944#Unrecognized_currency.

OfflineUserDataJobMetadata

Metadados do job de dados off-line do usuário.

Representação JSON
{ "matchRateRange": enum (`OfflineUserDataJobMatchRateRange`) }

Campos

matchRateRange

enum (OfflineUserDataJobMatchRateRange)

Apenas saída. Taxa de correspondência do upload da lista de usuários da Segmentação por lista de clientes. Descreve a taxa de correspondência estimada quando o status do job é "RUNNING" e a taxa de correspondência final quando a taxa de correspondência final está disponível após o status do job ser "SUCCESS/FAILED".

OfflineUserDataJobMatchRateRange

O intervalo da taxa de correspondência de um job de dados do usuário off-line.

Enums
`UNSPECIFIED`	Não especificado.
`UNKNOWN`	Valor padrão para o intervalo de taxa de correspondência.
`MATCH_RANGE_LESS_THAN_20`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 0% e 19%.
`MATCH_RANGE_20_TO_30`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 20% e 30%.
`MATCH_RANGE_31_TO_40`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 31% e 40%.
`MATCH_RANGE_41_TO_50`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 41% e 50%.
`MATCH_RANGE_51_TO_60`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 51% e 60%.
`MATCH_RANGE_61_TO_70`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 61% e 70%.
`MATCH_RANGE_71_TO_80`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 71% e 80%.
`MATCH_RANGE_81_TO_90`	O intervalo da taxa de correspondência para entidades de upload de dados off-line está entre 81% e 90%.
`MATCH_RANGE_91_TO_100`	O intervalo da taxa de correspondência para a entidade de upload de dados off-line é maior ou igual a 91%.

StoreSalesMetadata

Metadados das vendas diretas na loja.

Representação JSON
{ "thirdPartyMetadata": { object (`StoreSalesThirdPartyMetadata`) }, "loyaltyFraction": number, "transactionUploadFraction": number, "customKey": string }

Campos
`thirdPartyMetadata`	`object (StoreSalesThirdPartyMetadata)` Metadados do upload de um relatório de vendas na loja de terceiros.
`loyaltyFraction`	`number` Essa é a fração de todas as transações que podem ser identificadas (por exemplo, associadas a qualquer forma de informação do cliente). Obrigatório. Essa fração precisa estar entre zero e um (excluindo zero).
`transactionUploadFraction`	`number` Essa é a proporção de vendas enviadas em comparação com as vendas gerais que podem ser associadas a um cliente. Obrigatório. Essa fração precisa estar entre zero e um (excluindo zero). Por exemplo, se você fizer o upload de metade das vendas que pode associar a um cliente, esse valor será 0,5.
`customKey`	`string` Nome da chave da variável personalizada de vendas na loja. Uma chave predefinida que pode ser aplicada à transação e posteriormente usada para segmentação personalizada em relatórios. Acessível apenas a clientes na lista de permissões.

StoreSalesThirdPartyMetadata

Metadados de vendas na loja de um terceiro. Este produto é apenas para clientes na lista de permissões. Entre em contato com seu representante de desenvolvimento comercial do Google para saber detalhes sobre a configuração de upload.

Representação JSON
{ "advertiserUploadDateTime": string, "validTransactionFraction": number, "partnerMatchFraction": number, "partnerUploadFraction": number, "bridgeMapVersionId": string, "partnerId": string }

Campos
`advertiserUploadDateTime`	`string` Horário em que o anunciante fez upload dos dados para o parceiro. Obrigatório. O formato é "AAAA-MM-DD HH:MM:SS". Exemplos: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30"
`validTransactionFraction`	`number` A fração de transações válidas. Transações inválidas podem incluir formatos ou valores inválidos. Obrigatório. Essa fração precisa estar entre zero e um (excluindo zero).
`partnerMatchFraction`	`number` A fração de transações válidas que correspondem a um ID de usuário atribuído por terceiros pelo parceiro. Obrigatório. Essa fração precisa estar entre zero e um (excluindo zero).
`partnerUploadFraction`	`number` A fração de transações válidas que é enviada pelo parceiro ao Google. Obrigatório. Essa fração precisa estar entre zero e um (excluindo zero).
`bridgeMapVersionId`	`string` Versão dos IDs de parceiros a serem usados para uploads. Obrigatório.
`partnerId`	`string (int64 format)` ID do parceiro terceirizado que está atualizando o feed de transações.