Feed do perfil

Semântica do feed de perfil

Conforme mencionado nas definições de categoria do feed, a semântica de um feed de snapshot é a seguinte:

  • Para qualquer provedor em um feed de snapshots, se ele não existir no banco de dados de provedores de LSA, um novo perfil será criado.
  • Para qualquer provedor em um feed de snapshot, se ele existir no banco de dados de provedores de LSA, as informações do perfil serão atualizadas.
  • Para qualquer provedor que não esteja em um feed de snapshot, se ele existir no banco de dados de provedores de LSA, o perfil será excluído.

A semântica de um feed incremental resulta nas seguintes ações:

  • Para qualquer provedor em um feed incremental, se ele não existir no banco de dados de provedores de LSA, não haverá nenhuma ação.
  • Para qualquer provedor em um feed incremental, se ele já existir no banco de dados de provedores de LSA, as informações do perfil serão atualizadas.
  • Para qualquer provedor que não esteja em um feed incremental, é uma operação nula.

Tratamento de erros em perfis

Se um item de feed de perfil individual for inválido, não vamos atualizar esse item no banco de dados de anúncios locais. Enquanto isso, vamos pausar o item para evitar a veiculação de dados desatualizados.

Se um feed de perfil for inválido (por exemplo, não estiver em conformidade com o esquema), vamos interromper o processamento de todo o feed. Vamos compartilhar um relatório que inclui um resumo do resultado do processamento de feeds (por exemplo, erros, status de processamento de cada item etc.).

Protocolo e restrições

  1. Constraints. Cada empresa (item do feed) em um feed precisa ter um ID exclusivo.

  2. Limites. A LSA impõe limites de tamanho em campos de dados individuais, especificados na tabela abaixo.

  3. Restrições no nome da empresa

    1. Comprimento máximo: 100 caracteres, incluindo espaços
    2. Exige pelo menos um número ou uma letra
    3. As codificações de letras aceitas são UTF-8, UTF-16 e UTF-32 (recomendamos UTF-8).
    4. Caracteres especiais permitidos:
      1. Hífen -, "e" comercial &, ponto final ., vírgula ,, apóstrofo ', parênteses ( )
    5. Não permitir o uso de LETRAS MAIÚSCULAS
    6. Não permitir palavras ofensivas
    7. Não permitir emojis

Campos do perfil

A seguir, descrevemos os campos definidos para um determinado provedor. Os campos opcionais são marcados como tal.

Nome do campo Descrição Tipo de campo Exemplo Obrigatório Restrições
serviceProviderId Identificador exclusivo de uma ficha de empresa (um provedor de serviços). número 12345 Sim É um ID exclusivo para cada provedor de serviços. Isso será convertido em um int64. Não mude o ID ao atualizar um provedor.
serviceProviderName Nome da empresa string "King David Garage Doors, Inc." Sim Máximo de 100 caracteres. Sujeito à política de restrições de nome.
serviceProviderWebsiteUrl URL do site da empresa string https://abc.xyz Não Comece com http ou https
endereço Endereço comercial objeto "addressLine1":"847 Oliver Avenue", "city":"Valley Stream", "region":"NY", "postalCode":"11581", "country": "US" Sim addressLine1 precisa ser preenchido com o endereço da rua quando disponível. O código do país não pode ser alterado após a configuração inicial da empresa.
aggregatorProfileUrl URL do perfil que leva à página de perfil no site do parceiro. string http://aggregator.com/joes-plumbing/ Não Comece com http ou https
yearBusinessStarted Ano de fundação da empresa número inteiro 2015 Não Formato AAAA
businessHours Horário de funcionamento da empresa Matriz de objetos Consulte "Exemplo de feed de perfil". Sim Consulte a definição de objeto para restrições
businessPhoneNumber Número de telefone comercial individual no formato e164, que deve estar vazio ou ser de propriedade da empresa, em vez de um número de central de atendimento ou de rastreamento alocado por um parceiro. string "+16501112222" Sim O número de telefone precisa estar no formato E.164
contact Dados de contato usados para vários métodos de contato Matriz de objetos "{ “type”: “PHONE”, “address”: “+16501112222” }" Sim O tipo pode ser "PHONE" ou "MESSAGE". Para o tipo "PHONE", o endereço precisa conter um número de telefone formatado em E.164. Para "MESSAGE", o endereço não pode ser preenchido. O elemento do tipo PHONE é obrigatório, mas o elemento do tipo MESSAGE é opcional.
targetingLanguages Uma lista de idiomas em que o anúncio será veiculado. Os idiomas são definidos no código de idioma ISO 639-1 (minúsculo, duas letras). Matriz de strings "en", "fr" Sim Se não for fornecido, o padrão será "en".
geoCovered Região atendida pela empresa. objeto Não
geoCovered ->criteriaIds Uma lista de IDs de critérios que correspondem às áreas atendidas (região, condado, cidade, código postal). Matriz de números inteiros Não O ID do critério geográfico precisa ser válido na lista de segmentações geográficas do Google Ads.
categorias Uma lista de categorias atendidas pela empresa. Matriz de objetos Consulte "Exemplo de feed de perfil". Sim Ser selecionada na lista de categorias fornecida pelo Google. Ela precisa conter exatamente uma categoria.
categories->tasks Uma lista de tarefas atendidas em uma determinada categoria. Matriz de objetos Sim Ser selecionado na lista de tarefas fornecida pelo Google
tasks ->geoCovered Região atendida pela tarefa objeto Sim
tasks ->geoCovered->postalCodeCriteriaIds Uma lista de IDs de critérios que correspondem aos códigos postais atendidos. Matriz de strings ID do critério geográfico de uma lista de códigos postais veiculados. O ID do critério precisa ser válido na lista de segmentações geográficas do Google Ads com o tipo de segmentação "PostalCode".
tasks ->geoCovered->cityCriteriaIds Uma lista de IDs de critérios que correspondem às cidades atendidas. Matriz de strings ID do critério geográfico de uma lista de cidades atendidas. O ID do critério precisa ser válido na lista de segmentações geográficas do Google Ads com o tipo de segmentação "Cidade".
ativo Flag que indica se a empresa deve estar ativa ou pausada booleano true/false Sim
monthlyBudget Orçamento mensal desse provedor em monthlyBudgetCurrency número inteiro 100 Sim Precisa ser maior ou igual ao máximo do preço de reserva de lance ou lead.
monthlyBudgetCurrency Moeda do orçamento mensal e dos lances. Consulte Códigos de moeda. string "USD" Sim Não pode ser alterado após a configuração inicial da empresa.
frases de destaque Uma matriz de callouts para cada categoria Matriz de objetos Sim Ser selecionado na lista de frases de destaque fornecida pelo Google
biddingStrategy Estratégia de lances para esse negócio no leilão. Afeta o preço por lead. string "MANUAL_CPA" / "MAX_CONVERSION" Não Para ser selecionado na lista fornecida pelo Google . Se não for definida, a estratégia vai usar o CPA manual como padrão.
biddingConfiguration Uma lista de configurações de lances por categoria. Aplicável apenas à estratégia de lances MANUAL_CPA. Matriz de objetos Confira um exemplo de feed de perfil N Se nenhuma configuração for fornecida e biddingStrategy for MANUAL_CPA, defina todas as categorias como o lance mínimo.
biddingConfiguration->categoryId ID da categoria na taxonomia de LSA. Elas precisam corresponder às categorias listadas acima. Obrigatório se a configuração de lances for declarada. string Não Para ser selecionado na lista fornecida pelo Google.
biddingConfiguration->manualCostPerLead Configuração manual do custo por lead. Precisa ser fornecido se biddingStrategy for "MANUAL_CPA". objeto Não
manualCostPerLead->bid Lance manual de custo por lead. O preço do lead nunca vai exceder o valor desse lance. Obrigatório se "manualCostPerLead" for declarado. número Não Precisa ser maior ou igual ao preço de reserva.