Esta documentação do Recommendations AI faz referência ao console do Recommendations. Recomendamos migrar para o console de varejo e usar a documentação de varejo, que documenta o Recommendations AI, o console de varejo e a pesquisa de varejo.

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 começar

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 em Recursos para visualizar a tabela e verificar 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