Firebase Summit에서 발표된 모든 내용을 살펴보고 Firebase로 앱을 빠르게 개발하고 안심하고 앱을 실행하는 방법을 알아보세요. 자세히 알아보기

원격 구성 조건식 참조

이 페이지에는 원격 구성 백엔드 API 또는 Firebase 콘솔을 사용하여 조건식을 빌드하기 위한 참조 정보가 포함되어 있습니다. 백엔드 API 설정 및 사용에 대한 자세한 내용은 프로그래밍 방식으로 원격 구성 수정 을 참조하세요.

조건을 만드는 데 사용되는 요소

원격 구성 REST API는 Firebase 콘솔을 사용하여 원격 구성을 구성할 때 조건을 만드는 데 사용할 수 있는 것과 동일한 요소를 지원합니다.

요소 설명
&&

조건에 둘 이상의 요소를 사용하는 경우 요소의 논리적 "and"를 만드는 데 사용됩니다. 요소가 && 없이 REST 구문에서 사용되는 경우 해당 요소는 조건으로 처리됩니다.

참고: 앰퍼샌드 앞뒤에 공백이 필요합니다. 예: element1 && element2 .

app.build

앱의 빌드 번호 값에 따라 TRUE 또는 FALSE 로 평가됩니다.

참고: Apple 및 Android 기기에서만 사용할 수 있습니다. Apple의 경우 CFBundleVersion 값을 사용하고 Android의 경우 versionCode 값을 사용합니다.

app.version

앱의 버전 번호 값에 따라 TRUE 또는 FALSE 로 평가됩니다.

참고: Android 장치의 경우 versionName 값을 사용하고 Apple 장치의 경우 CFBundleShortVersionString 값을 사용합니다.

app.id 앱의 Firebase 앱 ID를 기반으로 하는 요소
app.audiences 하나 이상의 Firebase Analytics 잠재고객 에서 사용자의 존재 여부에 따라 TRUE 또는 FALSE 로 평가되는 요소입니다.
app.firstOpenTimestamp Google 애널리틱스 first_open 이벤트에서 얻은 사용자가 앱을 처음 실행하는 시간을 기반으로 하는 요소입니다. 고정 시간대를 지정하는 옵션과 함께 ISO 날짜 형식을 사용합니다. 예: app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles') . 시간대를 지정하지 않으면 GMT가 사용됩니다.
app.userProperty Firebase Analytics 사용자 속성 의 숫자 또는 문자열 값을 기준으로 TRUE 또는 FALSE 로 평가되는 요소입니다.
app.operatingSystemAndVersion

앱이 실행되는 운영 체제를 기반으로 하는 요소입니다. OS 및 OS 버전이 지정된 대상과 일치하면 TRUE 로 평가됩니다.

참고: 웹 앱에서만 사용할 수 있습니다.

app.browserAndVersion

앱이 실행되는 브라우저를 기반으로 하는 요소입니다. 브라우저 및 브라우저 버전이 지정된 대상과 일치하면 TRUE 로 평가됩니다.

참고: 웹 앱에서만 사용할 수 있습니다.

app.firebaseInstallationId 특정 장치 설치의 ID를 기반으로 하는 요소입니다. 설치 ID 가 지정된 설치 ID 중 하나와 일치하면 TRUE 로 평가됩니다.
device.country ISO 3166-1 alpha-2 표준(예: 미국 또는 영국)을 사용하여 기기가 위치한 지역/국가를 기반으로 하는 요소입니다. 국가가 예상 국가 코드와 일치하면 TRUE 로 평가됩니다.
device.dateTime 장치가 수행하는 마지막 가져오기 시간을 기반으로 하는 요소입니다. 고정 시간대를 지정하는 옵션과 함께 ISO 날짜 형식을 사용합니다. 예 dateTime('2017-03-22T13:39:44', 'America/Los_Angeles') .
device.language 장치에서 선택한 언어를 기반으로 하는 요소입니다. 언어는 es-ES, pt-BR 또는 en-US와 같은 IETF 언어 태그를 사용하여 표시됩니다. 언어가 예상 언어 코드와 일치하면 TRUE 로 평가됩니다.
device.os 장치(Apple 또는 Android)에서 사용되는 운영 체제를 기반으로 하는 요소입니다. 장치 OS가 예상 유형인 경우 TRUE 로 평가됩니다.
percent 임의로 할당된 부분 백분위수(샘플 크기가 0.000001%로 작음)에 사용자가 포함된 경우 TRUE 로 평가됩니다.

단일 요소 조건에는 세 개의 필드가 포함됩니다.

  1. 임의로 정의된 name (최대 100자)
  2. 위에 표시된 요소로 구성된 TRUE 또는 FALSE 로 평가되는 조건식입니다.
  3. (선택사항) tagColor 는 " BLUE ", " BROWN ", " CYAN ", " DEEP_ORANGE ", " GREEN ", " INDIGO ", " LIME ", " ORANGE ", " PINK ", " PURPLE " 또는 " TEAL ". 색상은 대소문자를 구분하지 않으며 Firebase 콘솔에 조건이 표시되는 방식에만 영향을 미칩니다.

지원되는 연산자

예를 들어 app.build.notContains([123, 456]) 는 실제 앱 빌드가 123 또는 492인 경우 TRUE 를 반환하지만 실제 앱 빌드가 999인 경우 FALSE 를 반환합니다. 예를 들어 app.version.notContains([123, 456]) 는 실제 앱 버전이 123 또는 492이면 TRUE 를 반환하지만 실제 앱 버전이 999이면 FALSE 를 반환합니다.
요소 지원되는 연산자 설명
app.audiences .inAtLeastOne([...]) 실제 청중이 목록에 있는 하나 이상의 청중 이름과 일치하는 경우 TRUE 를 반환합니다.
예를 들어:

app.audiences.inAtLeastOne(['Audience 1', 'Audience 2'])

app.audiences .notInAtLeastOne([...]) 실제 청중이 목록에 있는 하나 이상의 청중 이름과 일치하지 않으면 TRUE 를 반환합니다.
app.audiences .inAll([...]) 실제 청중이 목록에 있는 모든 청중 이름의 구성원인 경우 TRUE 를 반환합니다.
app.audiences .notInAll([...]) 실제 대상이 목록에 있는 대상의 구성원이 아닌 경우 TRUE 를 반환합니다.
app.firstOpenTimestamp <=, > first_open 이벤트의 시간을 조건에 지정된 시간과 비교하고 연산자에 따라 TRUE 또는 FALSE 를 반환합니다.
샘플 사용법:
app.firstOpenTimestamp >= ('2022-10-31T14:37:47', 'America/Los_Angeles') .
범위를 지정하려면:
app.firstOpenTimestamp >= ('2022-11-01T00:00:00') && app.firstOpenTimestamp < ('2022-12-01T00:00:00') 시간대를 지정하지 않으면 GMT가 사용됩니다.
app.userProperty < , <= , == , != , >= , > 실제 사용자 속성이 연산자와 일치하는 방식으로 지정된 값과 수치적으로 비교되는 경우 TRUE 를 반환합니다.
app.userProperty .contains([...]) 대상 값이 실제 사용자 속성의 하위 문자열인 경우 TRUE 를 반환합니다.
app.userProperty .notContains([...]) 대상 값 중 실제 사용자 속성의 하위 문자열이 없는 경우 TRUE 를 반환합니다.
app.userProperty .exactlyMatches([...]) 실제 사용자 속성이 목록의 대상 값과 정확히 일치(대소문자 구분) 하는 경우 TRUE 를 반환합니다.
app.userProperty .matches([...]) 목록 대상 정규식이 실제 값의 하위 문자열 또는 전체와 일치하는 경우 TRUE 를 반환합니다. 전체 문자열을 강제로 일치시키려면 정규식 앞에 "^"를 붙이고 접미사에 "$"를 붙입니다. RE2 구문을 사용합니다.
app.id == 지정된 값이 앱의 앱 ID와 일치하면 TRUE 를 반환합니다.
app.build < , <= , == , != , >= , > 실제 앱 빌드가 연산자와 일치하는 방식으로 지정된 값과 수치적으로 비교되는 경우 TRUE 를 반환합니다.
app.build .contains([...]) 대상 값 중 하나라도 실제 앱 빌드의 하위 문자열인 경우 TRUE 를 반환합니다. 예를 들어 "a" 및 "bc"는 "abc"의 하위 문자열입니다.
app.build .notContains([...]) 목표 값 중 어느 것도 실제 앱 빌드의 하위 문자열이 아닌 경우 TRUE 를 반환합니다.
app.build .exactlyMatches([...]) 실제 앱 빌드가 목록의 대상 값과 정확히 일치 하는 경우 TRUE 를 반환합니다.
app.build .matches([...]) 목록 대상 정규식이 실제 값의 하위 문자열 또는 전체와 일치하는 경우 TRUE 를 반환합니다. 전체 문자열을 강제로 일치시키려면 정규식 앞에 "^"를 붙이고 접미사에 "$"를 붙입니다. RE2 구문을 사용합니다.
app.version < , <= , == , != , >= , > 실제 앱 버전이 연산자와 일치하는 방식으로 지정된 값과 수치적으로 비교되면 TRUE 를 반환합니다.
app.version .contains([...]) 대상 값 중 하나라도 실제 앱 버전의 하위 문자열인 경우 TRUE 를 반환합니다. 예를 들어 "a" 및 "bc"는 "abc"의 하위 문자열입니다.
app.version .notContains([...]) 대상 값 중 어느 것도 실제 앱 버전의 하위 문자열이 아닌 경우 TRUE 를 반환합니다.
app.version .exactlyMatches([...]) 실제 앱 버전이 목록의 대상 값과 정확히 일치 하는 경우 TRUE 를 반환합니다.
app.version .matches([...]) 목록 대상 정규식이 실제 값의 하위 문자열 또는 전체와 일치하는 경우 TRUE 를 반환합니다. 전체 문자열을 강제로 일치시키려면 정규식 앞에 "^"를 붙이고 접미사에 "$"를 붙입니다. RE2 구문을 사용합니다.
app.operatingSystemAndVersion .inOne([...]) OS 및 버전이 목록의 대상 값과 일치 하는 경우 TRUE 를 반환합니다.
예를 들어:

    app.operatingSystemAndVersion.inOne([operatingSystemName('Macintosh').version.==('10.15')])
    

app.browserAndVersion .inOne([...]) 브라우저 및 버전이 목록의 대상 값과 일치 하는 경우 TRUE 를 반환합니다.
예를 들어:

    app.browserAndVersion.inOne([browserName('Chrome').anyVersion])
    

app.firebaseInstallationId in [...] 설치 ID가 목록에 지정된 것과 일치하면 TRUE 를 반환합니다. 샘플 사용법: app.firebaseInstallationId in ['eyJhbGciOiJFUzI1N_iIs5', 'eapzYQai_g8flVQyfKoGs7']
device.country in [...] 장치의 국가가 목록에 지정된 것과 일치하면 TRUE 를 반환합니다. 사용 예: device.country in ['gb', 'us'] . 기기 국가 코드는 요청의 기기 IP 주소 또는 Firebase Analytics에서 결정한 국가 코드(Analytics 데이터가 Firebase와 공유된 경우)를 사용하여 결정됩니다.
device.dateTime <= , > 현재 시간과 조건의 목표 시간을 비교하여 연산자에 따라 TRUE 또는 FALSE 로 평가합니다. 샘플 사용법: dateTime < dateTime('2017-03-22T13:39:44') .
device.language in [...] 앱의 언어가 목록의 언어와 일치하면 TRUE 를 반환합니다. 샘플 사용: device.language in ['en-UK', 'en-US'] .
device.os == , != 장치의 운영 체제가 연산자와 일치하는 해당 필드의 값과 비교하면 TRUE 를 반환합니다.
percent <= , > percent 필드의 값이 연산자와 일치하는 임의로 할당된 값과 비교되는 경우 TRUE 를 반환합니다.