Limitações e considerações - AWS Glue

Limitações e considerações

São limitações do conector do Google Analytics 4:

  • Para a entidade Core Report, somente 9 campos de dimensão e 10 campos métricos são permitidos para enviar em uma solicitação. Se o número permitido de campos for excedido, a solicitação falhará e o conector lançará uma mensagem de erro.

  • Para a entidade Realtime Report, somente 4 campos de dimensão são permitidos para enviar em uma solicitação. Se o número permitido de campos for excedido, a solicitação falhará e o conector lançará uma mensagem de erro.

  • O Google Analytics 4 é uma ferramenta gratuita em versão beta. Consequentemente, haverá atualizações regulares sobre novos recursos, aprimoramento de entidades, adição de novos campos e descontinuação de campos existentes.

  • Os campos do relatório principal são preenchidos dinamicamente. Por isso haverá adição, depreciação e renomeação de campos, e a imposição de novos limites aos campos pode ser feita a qualquer momento.

  • A data de início padrão é 30 dias e a data de término é ontem (um dia antes da data atual). Essas datas serão substituídas no código da expressão de filtro se o usuário tiver definido o valor OU se o fluxo for incremental.

  • De acordo com a documentação, a entidade de relatório em tempo real retornará 10.000 registros se o limite não for passado na solicitação, caso contrário, a API retornará no máximo 250.000 linhas por solicitação, não importa quantas você solicite. Para obter mais informações, consulte Método: properties.runRealtimeReport na documentação do Google Analytics.

  • A entidade de relatório em tempo real não oferece suporte à partição baseada em registros, pois não oferece suporte à paginação. Além disso, ele não oferece suporte à partição baseada em campo, pois nenhum dos campos atende aos critérios definidos.

  • Devido à limitação no número de campos que podem ser transmitidos em uma solicitação. Estamos definindo campos de dimensão e métrica padrão dentro dos limites designados. Se "selecionar tudo" for escolhido, somente os dados desses campos predeterminados serão recuperados.

    • Relatório principal

      • De acordo com a limitação do SAAS, as solicitações são permitidas em até 9 dimensões e até 10 métricas (ou seja, uma solicitação pode conter no máximo 19 campos (métricas + dimensão).

      • De acordo com a implementação: se o usuário utilizar SELECT_ALL ou selecionar mais de 25 campos, os campos padrão serão passados na solicitação.

      • Os seguintes campos são considerados campos padrão para o relatório principal: "country", "city", "eventName", "cityId", "browser", "date", "currencyCode", "deviceCategory", "transactionId", active1DayUsers", "active28DayUsers", "active7DayUsers", "activeUsers", "averagePurchaseRevenue", "averageRevenuePerUser", "averageSessionDuration", "engagedSessions", "eventCount", "engagementRate".

    • Relatório em tempo real

      • De acordo com a limitação das solicitações do SAAS, são permitidas até 4 dimensões.

      • Se o usuário passar SELECT_ALL ou selecionar mais de 15 campos, os campos padrão serão passados na solicitação.

      • Os seguintes campos são considerados campos padrãõ para o relatório em tempo real: "country", "deviceCategory", "city", "cityId", "activeUsers", "conversions", "eventCount", "screenPageViews".

  • Na entidade de relatório principal Core-Report, se a partição no campo date e o filtro em startDate estiverem presentes ao mesmo tempo. Nesse caso, o valor de dateRange será substituído pelo valor do filtro startDate. Mas, já que a partição deve sempre ser a prioridade, descarte o filtro startDate se a partição no campo date já estiver presente.

  • Como agora o cohortSpecs também faz parte do corpo da solicitação do relatório principal, aprimoramos a entidade atual do relatório principal para incluir suporte ao atributo cohortSpec. No corpo da solicitação de cohortSpecs, quase todos os campos exigem a entrada do usuário. Para resolver isso, definimos valores padrão para esses atributos/campos e fornecemos provisões para que o usuário substitua esses valores, se necessário.

    FieldName Valores padrão Exemplo de consulta para transmitir as opções de filterPredicate para substituir os valores padrão
    startDate 30 dias anteriores à data atual "startDate" entre "2023-05-09" e "2023-05-10"
    endDate 1 dia anterior à data atual "startDate" entre "2023-05-09" e "2023-05-10"
    startOffset 0 startOffset=2
    endOffset 1 endOffset=10
    granularidade DIÁRIA granularity="SEMANAL"
  • Você também pode passar todos esses filtros juntos de uma só vez ou com outros filtros.

    • Exemplo 1: filterPredicate: startDate entre "2023-05-09" e "2023-05-10" E startOffset=1 E endOffset=2 E granularity="SEMANAL"

    • Example 2 filterPredicate: city=“xyz” E startOffset=1 E endOffset=2 E granularity="SEMANAL"

  • Na solicitação de coorte: