이 페이지에는 원격 구성 백엔드 API 또는 Firebase 콘솔을 사용하여 조건식을 빌드하기 위한 참조 정보가 포함되어 있습니다. 백엔드 API 설정 및 사용에 대한 자세한 내용은 프로그래밍 방식으로 원격 구성 수정 을 참조하세요.
조건을 만드는 데 사용되는 요소
원격 구성 REST API는 Firebase 콘솔을 사용하여 원격 구성을 구성할 때 조건을 만드는 데 사용할 수 있는 것과 동일한 요소를 지원합니다.
요소 | 설명 |
---|---|
&& | 조건에 둘 이상의 요소를 사용하는 경우 요소의 논리적 "and"를 만드는 데 사용됩니다. 요소가 참고: 앰퍼샌드 앞뒤에 공백이 필요합니다. 예: |
app.build | 앱의 빌드 번호 값에 따라 참고: Apple 및 Android 기기에서만 사용할 수 있습니다. Apple의 경우 CFBundleVersion 값을 사용하고 Android의 경우 versionCode 값을 사용합니다. |
app.version | 앱의 버전 번호 값에 따라 참고: 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 버전이 지정된 대상과 일치하면 참고: 웹 앱에서만 사용할 수 있습니다. |
app.browserAndVersion | 앱이 실행되는 브라우저를 기반으로 하는 요소입니다. 브라우저 및 브라우저 버전이 지정된 대상과 일치하면 참고: 웹 앱에서만 사용할 수 있습니다. |
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 로 평가됩니다. |
단일 요소 조건에는 세 개의 필드가 포함됩니다.
- 임의로 정의된
name
(최대 100자) - 위에 표시된 요소로 구성된
TRUE
또는FALSE
로 평가되는 조건식입니다. - (선택사항)
tagColor
는 "BLUE
", "BROWN
", "CYAN
", "DEEP_ORANGE
", "GREEN
", "INDIGO
", "LIME
", "ORANGE
", "PINK
", "PURPLE
" 또는 "TEAL
". 색상은 대소문자를 구분하지 않으며 Firebase 콘솔에 조건이 표시되는 방식에만 영향을 미칩니다.
지원되는 연산자
요소 | 지원되는 연산자 | 설명 |
---|---|---|
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 | <= , > , between | percent 필드의 값이 연산자와 일치하는 임의로 할당된 값과 비교되는 경우 TRUE 를 반환합니다.조건 규칙 유형 에 설명된 대로 주어진 백분율 범위에 대해 무작위로 할당된 새 앱 인스턴스 그룹을 선택하도록 시드를 지정할 수 있습니다. 이렇게 하려면 다음 예와 같이 연산자 앞에 percent('keyName') <= 10이름을 제공하십시오. 특정 범위를 구성하려면 percent between 20 and 60 사용자 지정 시드를 사용하여 60~80명의 사용자 범위를 구성하려면: percent('seedName') between 60 and 80 |