Esta é a documentação apenas do Recommendations AI. Para testar a pesquisa de varejo e o console unificado de varejo na fase restrita do GA, entre em contato com a equipe de vendas do Cloud. Se você não quiser usar a pesquisa de varejo, permaneça no console de recomendações até novo aviso.

Se você estiver usando a versão v1beta do Recommendations AI, migre para a versão da API Retail.

Como importar eventos históricos do usuário

Quando você quer criar um novo modelo ou recomendação, esse modelo requer dados de eventos do usuário para treinamento. A quantidade de dados necessários para o treinamento depende do tipo de recomendação e do objetivo de otimização. Consulte Requisitos de dados de eventos do usuário.

Depois de configurar a gravação de eventos em tempo real, pode levar um tempo considerável para registrar dados de evento do usuário suficientes para treinar seus modelos. É possível acelerar o treinamento inicial de modelos importando dados de eventos do usuário de eventos anteriores em massa. Antes de fazer isso, leia as práticas recomendadas para registrar eventos do usuário.

Você pode:

Como importar eventos do usuário do Cloud Storage

Para importar eventos do usuário do Cloud Storage, crie um arquivo contendo dados JSON.

Verifique se o arquivo JSON:

  • É formatado de acordo com o tipo de evento do usuário. Consulte Eventos do usuário para exemplos de cada formato de tipo de evento do usuário.
  • Fornece um evento do usuário inteiro em uma única linha, sem quebras de linha.
  • Tem cada evento de usuário em uma linha separada.

Como importar eventos de usuários in-line

curl

Importe os eventos do usuário in-line incluindo os dados dos eventos na chamada para o método userEvents.import.

A maneira mais fácil de fazer isso é colocar os dados de evento do usuário em um arquivo JSON e fornecer o arquivo para cURL.

Para saber os formatos dos tipos de evento do usuário, consulte Eventos do usuário.

  1. Crie o arquivo JSON:

    {
    "inputConfig": {
      "userEventInlineSource": {
          "userEvents": [
            {
              <userEvent1>>
            },
            {
              <userEvent2>
            },
            ....
          ]
        }
      }
    }
    
  2. Chame o método POST:

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         --data @./data.json \
      "https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/userEvents:import"
    

Como importar eventos do usuário do BigQuery

Importe eventos de usuários do BigQuery usando o método userEvents.import.

Os eventos de usuário precisam estar em tabelas do BigQuery formatadas corretamente para ingestão do Recommendations AI. O esquema da tabela será diferente dependendo do tipo de evento do usuário. Consulte Tipos de eventos de usuários e esquema de exemplos do esquema JSON para especificar ao criar tabelas do BigQuery para cada tipo de evento.

Ao importar eventos, use o valor user_event para dataSchema.

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json

curl \
  -v \
  -X POST \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  "https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/userEvents:import" \
  --data '{
    "inputConfig": {
      "bigQuerySource": {
        "datasetId": "DATASET-ID",
        "tableId": "TABLE-ID",
        "dataSchema": "user_event"
    }
  }
}'

Se o conjunto de dados do BigQuery pertencer a um projeto diferente do projeto do Recommendations AI, siga as instruções em Como configurar o acesso ao conjunto de dados do BigQuery para fornecer sua conta de serviço do Recommendations AI. um papel de Editor de dados do BigQuery para seu projeto do BigQuery. Modifique a solicitação de importação para especificar o ID do projeto do BigQuery:

"bigQuerySource": {
     "projectId": "BQ_PROJECT_ID",
   }

Como importar eventos do usuário do Google Analytics 360 com o BigQuery

Você poderá importar eventos de usuário do Google Analytics 360 se tiver integrado o Google Analytics 360 ao BigQuery e usar o comércio eletrônico avançado.

Para os procedimentos a seguir, consideramos que você esteja familiarizado com o uso do BigQuery e do Google Analytics 360.

Antes de iniciar as próximas etapas, verifique se:

Verificar a fonte de dados

  1. Verifique se os dados de eventos de usuário que você importará estão formatados corretamente em uma tabela do BigQuery a que você tem acesso.

    A tabela precisa ter o formato project_id:ga360_export_dataset.ga_sessions_YYYYMMDD.

    Consulte a documentação do Google Analytics para mais informações sobre o formato de tabela.

  2. No Console do Google Cloud do BigQuery, selecione a tabela de Recursos para visualizar a tabela e verifique se:

  3. Verifique a consistência dos IDs dos itens entre o catálogo enviado e a tabela de eventos do usuário do Analytics 360.

    Usando qualquer ID do produto da coluna hits.product.productSKU na visualização da tabela do BigQuery, use o método product.get para garantir que o mesmo produto esteja no seu catálogo enviado.

    export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json
    
       curl \
         -v \
         -X GET \
         -H "Content-Type: application/json; charset=utf-8" \
         -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
         "https://retail.googleapis.com/v2/projects/[PROJECT_NUMBER]/locations/global/catalogs/default_catalog/branches/default_branch/products/PRODUCT_ID"
    

Importar eventos do Google Analytics 360

Importe os eventos do usuário incluindo os dados dos eventos na chamada para o método userEvents.import.

Para dataSchema, use o valor user_event_ga360.

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json

curl \
  -v \
  -X POST \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token)"" \
  "https://retail.googleapis.com/v2/projects/[PROJECT_ID]/locations/global/catalogs/default_catalog/userEvents:import" \
  --data '{
    "inputConfig": {
      "bigQuerySource": {
        "datasetId": "some_ga360_export_dataset",
        "tableId": "ga_sessions_YYYYMMDD",
        "dataSchema": "user_event_ga360"
    }
  }
}'

Se o conjunto de dados do BigQuery pertencer a um projeto diferente do projeto do Recommendations AI, siga as instruções em Como configurar o acesso ao conjunto de dados do BigQuery para fornecer sua conta de serviço do Recommendations AI. um papel de Editor de dados do BigQuery para seu projeto do BigQuery. Modifique a solicitação de importação para especificar o ID do projeto do BigQuery:

"bigQuerySource": {
     "projectId": "GA360_BQ_PROJECT_ID",
   }

A seguir