제한 사항 및 고려 사항 - AWS Glue

제한 사항 및 고려 사항

다음은 Google Analytics 4 커넥터의 제한 사항입니다.

  • 코어 보고서 엔터티의 경우 9개의 차원 필드 및 10개의 지표 필드만 요청에서 전송할 수 있습니다. 허용된 필드 수를 초과하면 요청이 실패하고 커넥터에서 오류 메시지를 표시하니다.

  • 실시간 보고서 엔터티의 경우 4개의 차원 필드만 요청에서 전송할 수 있습니다. 허용된 필드 수를 초과하면 요청이 실패하고 커넥터에서 오류 메시지를 표시하니다.

  • Google Analytics 4는 베타 버전 무료 도구이므로 새 기능, 엔터티 개선 사항, 새 필드 추가 및 기존 필드 사용 중단에 대한 정기적인 업데이트가 제공됩니다.

  • 코어 보고서 필드는 동적으로 채워지므로 필드의 추가, 사용 중단 및 이름 변경이 존재하며 언제든지 필드에 새로운 제한을 적용할 수 있습니다.

  • 기본 시작 날짜는 30일이고 종료 날짜는 어제(현재 날짜의 하루 전)이며, 사용자가 값을 설정했거나 흐름이 증분에 기반한 경우 필터 표현식 코드에서 이러한 날짜가 재정의됩니다.

  • 설명서에 따라 실시간 보고서 엔터티는 요청에서 한도를 전달하지 않으면 10,000개의 레코드를 반환합니다. 그렇지 않으면 요청한 수에 관계없이 API는 요청당 최대 250,000개의 행을 반환합니다. 자세한 내용은 Google Analytics 설명서의 Method: properties.runRealtimeReport를 참조하세요.

  • 실시간 보고서 엔터티는 페이지 매김을 지원하지 않으므로 레코드 기반 파티션을 지원하지 않습니다. 또한 정의된 기준을 충족하는 필드가 없으므로 필드 기반 파티션을 지원하지 않습니다.

  • 요청에서 전달할 수 있는 필드 수의 제한 사항 때문에 지정된 한도 내에서 기본 차원 및 지표 필드를 설정합니다. 'select all'을 선택하면 미리 결정된 필드의 데이터만 검색됩니다.

    • 코어 보고서

      • SAAS의 제한 사항에 따르는 경우 - 요청에서는 최대 9개의 차원과 최대 10개의 지표만 허용됩니다. 즉, 요청은 최대 19개의 필드(지표 + 차원)를 포함할 수 있습니다.

      • 구현에 따르는 경우 - 사용자가 SELECT_ALL을 사용하거나 25개를 초과하는 선택한 필드를 사용하는 경우 요청에서 기본 필드가 전달됩니다.

      • 다음 필드는 코어 보고서의 기본 필드로 고려됩니다. 'country', 'city', 'eventName', 'cityId', 'browser', 'date', 'currencyCode', 'deviceCategory', 'transactionId', active1DayUsers', 'active28DayUsers', 'active7DayUsers', 'activeUsers', 'averagePurchaseRevenue', 'averageRevenuePerUser', 'averageSessionDuration', 'engagedSessions', 'eventCount', 'engagementRate'.

    • 실시간 보고서

      • SAAS의 제한 사항에 따라 요청에서는 최대 4개의 차원이 허용됩니다.

      • 사용자가 SELECT_ALL을 전달하거나 15개를 초과하는 선택한 필드를 전달하는 경우 요청에서 기본 필드가 전달됩니다.

      • 다음 필드는 실시간 보고서의 기본 필드로 고려됩니다. 'country', 'deviceCategory', 'city', 'cityId', 'activeUsers', 'conversions', 'eventCount', 'screenPageViews'.

  • 코어 보고서 엔터티에서 startDate의 필터 및 날짜 필드의 파티션이 동시에 존재하는 경우 dateRange 값이 startDate 필터 값으로 재정의됩니다. 하지만 파티션이 항상 우선적으로 고려되므로 날짜 필드의 파티션이 이미 있는 경우 startDate 필터를 무시합니다.

  • 현재 cohortSpecs는 core-report 요청 본문의 일부이기도 하므로 cohortSpec 속성에 대한 지원을 포함하도록 현재 core-report 엔터티를 개선했습니다. cohortSpecs 요청 본문에서는 거의 모든 필드에 사용자 입력이 필요합니다. 이를 해결하기 위해 이러한 속성/필드에 대한 기본값을 설정하고 필요한 경우 사용자가 이러한 값을 재정의하도록 프로비저닝을 제공합니다.

    FieldName 기본값 filterPredicate 옵션을 전달하여 기본값을 재정의하는 샘플 쿼리
    startDate 현재 날짜로부터 30일 전 '"2023-05-09" 및 "2023-05-10" 사이의 startDate'
    endDate 현재 날짜로부터 1일 전 '"2023-05-09" 및 "2023-05-10" 사이의 startDate'
    startOffset 0 startOffset=2
    endOffset 1 endOffset=10
    세부 수준 DAILY granularity="WEEKLY"
  • 이러한 모든 필터를 한 번에 함께 전달하거나 다른 필터와 함께 전달할 수도 있습니다.

    • 예제 1 - filterPredicate: startDate between "2023-05-09" and "2023-05-10" AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"

    • 예제 2 - filterPredicate: city=“xyz” AND startOffset=1 AND endOffset=2 AND granularity="WEEKLY"

  • 코호트 요청에서: