필터

보고서에 필터가 포함되어 있고 커뮤니티 커넥터가 필터링되지 않은 데이터를 반환하는 경우 요청된 모든 필드에 대해 Looker Studio가 커넥터에 필터를 적용합니다. 있습니다. 하지만 필터를 커뮤니티 커넥터 수준에서 적용하여 성능을 크게 향상할 수 있습니다. 필터 정보 getData() 요청 개체에서 전달되며 커넥터는 이 정보를 사용하여 데이터를 필터링한 후 Looker Studio로 다시 보냅니다.

예를 들어 SQL 데이터베이스에 연결하는 경우 WHERE 절 (아래 다이어그램의 B3)에서 직접 리소스 수를 크게 줄일 수 있습니다. Looker Studio로 반환되는 행 수입니다. 이렇게 하면 처리하여 Looker Studio로 전송해야 하는 데이터의 양을 말합니다 (B5).

참고: 필터를 반드시 적용할 필요는 없지만, 필터를 적용하려는 경우에는 사용하는 것이 좋습니다. 향상하는 효과를 얻을 수 있습니다.

필터 적용 규칙

1. 모든 필터를 적용하거나 아무것도 적용하지 않습니다. 지원되지 않는 필터를 참고하세요.
2. 응답에 forFilterOnly 필드는 포함하지 마세요.

3. request.dimensionsFilters 배열의 각 항목과 함께 AND입니다.

   예를 들어 다음 필터의 경우 커넥터에는 country가 USA 및 source가 Social인 값

   {
     "dimensionsFilters": [
       [{
         "fieldName": "country",
         "values": ["USA"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }],
       [{
         "fieldName": "source",
         "values": ["Social"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }]
     ]
   }
   

4. OR는 request.dimensionsFilters 배열의 각 하위 배열과 함께 포함됩니다.

   예를 들어 다음 필터의 경우 커넥터에는 country이 USA인 또는 country이 Canada인 값

   {
     "dimensionsFilters": [
       [{
         "fieldName": "country",
         "values": ["Canada"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }, {
         "fieldName": "country",
         "values": ["USA"],
         "type": "INCLUDE",
         "operator": "EQUALS"
       }]
     ]
   }
   

를 통해 개인정보처리방침을 정의할 수 있습니다.

주의: OR와 AND의 차이는 미묘합니다. AND이(가) 다음 항목을: [[1], [2]] 구조인 반면 OR의 구조는 [[1, 2]]입니다.

예

다음 예는 보고서 사용자의 엔드 투 엔드 흐름을 보여줍니다. 커뮤니티 커넥터에 필터를 정의하여 필터링된 데이터를 반환할 수 있습니다.

1. 보고서 사용자가 다음 두 가지 필터를 구성했습니다.

   1. country은(는) Canada, USA의 IN_LIST입니다.
   2. source은(는) Social, Organic의 IN_LIST입니다.

2. 보고서 사용자가 source 측정기준으로 차트 구성요소를 구성했습니다. 및 측정항목 sessions개

3. getData()는 Looker Studio에서 다음 요청 객체를 사용하여 실행합니다.

   {
     "fields": [
       {"name": "source"},
       {"name": "sessions"},
       {"name": "country", "forFilterOnly": true}
     ],
     "dimensionsFilters": [
       [{
         "fieldName": "country",
         "values": ["Canada", "USA"],
         "type": "INCLUDE",
         "operator": "IN_LIST"
       }],
       [{
         "fieldName": "source",
         "values": ["Social", "Organic"],
         "type": "INCLUDE",
         "operator": "IN_LIST"
       }]
     ]
   }
   

4. 커넥터는 필터링된 데이터로 응답합니다.

   예시 요청의 경우 source 및 sessions를 반환합니다. 여기서 country "Canada" 또는 "USA"이며 그리고 source이 "Social" 또는 "Organic"입니다. 모든 필터를 사용할 수 있으므로 filtersApplied를 true(으)로 설정 성공적으로 적용되었습니다.

원본 데이터

source	sessions	국가
소셜	60	미국
소셜	50	캐나다
소셜	40	영국
자연 검색	90	미국
자연 검색	80	캐나다
자연 검색	70	영국
신문	30	미국
신문	20	캐나다
신문	10	영국

필터링된 데이터

source	sessions
소셜	60
소셜	50
자연 검색	90
자연 검색	80

응답 getData()개

{
  "schema": [
    {"name": "source",   "dataType": "STRING"},
    {"name": "sessions", "dataType": "NUMBER"},
  ],
  "rows": [
    {"values": ["Social", 60]},
    {"values": ["Social", 50]},
    {"values": ["Organic", 90]},
    {"values": ["Organic", 80]}
  ],
  "filtersApplied": true
}

핵심사항: response.rows[].values에는 country 및 filtersApplied를 true로 설정합니다.

지원되지 않는 필터

커넥터가 요청의 모든 필터를 적용할 수 없는 경우 필터링을 사용하지 않아야 합니다. 확인할 수 있습니다 요청된 모든 필드 (forFilterOnly 포함)를 반환합니다. 필드)을 입력하고 응답의 filtersApplied 키를 false로 설정합니다.

핵심사항: getData()의 표준 응답입니다. 모든 기존 항목 커넥터는 이 변경사항과 하위 호환됩니다.

예:

{
  "schema": [
    {"name": "source",   "dataType": "STRING"},
    {"name": "sessions", "dataType": "NUMBER"},
    {"name": "country",  "dataType": "STRING"}
  ],
  "rows": [
    {"values": ["Social", 60, "USA"]},
    {"values": ["Social", 50, "Canada"]},
    {"values": ["Social", 40, "UK"]},
    {"values": ["Organic", 90, "USA"]},
    {"values": ["Organic", 80, "Canada"]},
    {"values": ["Organic", 70, "UK"]},
    {"values": ["Newspaper", 30, "USA"]},
    {"values": ["Newspaper", 20, "Canada"]},
    {"values": ["Newspaper", 10, "UK"]},
  ],
  "filtersApplied": false
}