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:
-
Se "cohortNthMonth" for passado na solicitação, o valor interno de granularity será definido como "MENSAL"
-
Da mesma forma, se "cohortNthWeek" for passado, o valor de granularity será definido como "SEMANAL"
-
E, para "cohortNthDay", o valor de granularity será definido como "DIÁRIO". Para obter mais informações, consulte:
-
Provisão é fornecida para que o usuário substitua os valores padrão de dateRange e granularity. Consulte a tabela acima.
-