개요
Google 애널리틱스 iOS 최상위 클래스입니다.
추적기를 만들고 행동 플래그를 설정할 수 있는 기능을 제공합니다.
NSObject를 상속합니다.
인스턴스 메서드 | |
| (ID< GAITracker >) | - trackerWithName:trackingId: |
| 지정된 이름과 추적 ID를 사용하여 GAITracker 구현을 만들거나 가져옵니다. 더보기... | |
| (ID< GAITracker >) | - trackerWithTrackingId: |
| 지정된 추적 ID와 같은 이름을 가진 GAITracker 구현을 만들거나 가져옵니다. 더보기... | |
| (void) | removeTrackerByName: |
| 추적기 사전에서 추적기를 삭제합니다. 더보기... | |
| (void) | - 전달 |
| 대기 중인 추적 정보를 전달합니다. 더보기... | |
| (void) | - dispatchWith완료Handler: |
| 추적 비콘이 전송되었거나 (kGAIDispatchGood 반환) 오류 결과 (kGAIDispatchError 반환)가 발생하면 completeHandler를 호출하여 대기열에서 다음 추적 비콘을 전달합니다. 더보기... | |
클래스 메서드 | |
| (GAI *) | + sharedInstance |
| iOS용 Google 애널리틱스 클래스의 공유 인스턴스를 가져옵니다. 더보기... | |
속성 | |
| id< GAITracker > | defaultTracker |
| 편의를 위해 이 클래스는 기본 추적기 인스턴스를 노출합니다. 더보기... | |
| ID< GAILogger > | logger |
| 사용할 GAILogger입니다. 더보기... | |
| 부울 | optOut |
| 이 경우 추적 정보가 수집되지 않으며 추적 통화는 사실상 노옵스(no-ops)가 됩니다. 더보기... | |
| NSTimeInterval | dispatchInterval |
| 이 값이 양수이면 dispatchInterval초마다 추적 정보가 자동으로 발송됩니다. 더보기... | |
| 부울 | trackUncaughtExceptions |
| true로 설정하면 SDK는 현재 등록된 포착되지 않은 예외 핸들러를 기록한 다음 defaultTracker를 사용하여 발생한 예외를 추적하는 포착되지 않은 예외 핸들러를 등록합니다. 더보기... | |
| 부울 | dryRun |
| '예'인 경우 추적 정보가 전송되지 않습니다. 더보기... | |
메서드 문서
| + (GAI *) sharedInstance |
iOS용 Google 애널리틱스 클래스의 공유 인스턴스를 가져옵니다.
| - (id<GAITracker>) trackerWithName: | (NSString *) | name | |
| 추적 ID: | (NSString *) | trackingId | |
지정된 이름과 추적 ID를 사용하여 GAITracker 구현을 만들거나 가져옵니다.
지정된 이름의 추적기가 없는 경우 생성되고 반환됩니다. 그렇지 않으면 기존 추적기가 반환됩니다. 각 이름의 기존 추적기의 추적 ID가 다른 경우 해당 추적 ID는 이 방법으로 변경되지 않습니다. defaultTracker를 설정하지 않으면 여기에 반환된 추적기 인스턴스로 설정됩니다.
- 매개변수
-
이름 이 추적기의 이름입니다. nil이거나 비어 있으면 안 됩니다.trackingID 이 추적기에 사용할 추적 ID입니다. UA-xxxxx-y형식이어야 합니다.
- 반환 값
- 지정된 이름과 연결된 GAITracker입니다. 추적기는 추적 데이터를 Google 애널리틱스로 전송하는 데 사용할 수 있습니다. 이 메서드가 특정 이름으로 처음 호출되면 해당 이름의 추적기가 반환되며 이후 동일한 이름을 가진 호출도 동일한 인스턴스를 반환합니다. 추적기는 라이브러리에서 내부적으로 유지되므로 추적기를 유지할 필요는 없습니다.
오류가 발생하거나 이름이 유효하지 않은 경우 이 메서드는 nil를 반환합니다.
| - (id<GAITracker>) trackerWithTrackingId: | (NSString *) | trackingId |
지정된 추적 ID와 같은 이름을 가진 GAITracker 구현을 만들거나 가져옵니다.
각 이름에 대한 추적기가 아직 없는 경우 생성되고 추적 ID가 |trackingId|로 설정된 후 반환됩니다. 그렇지 않으면 기존 추적기가 반환됩니다. 각 이름의 기존 추적기의 추적 ID가 다른 경우 해당 추적 ID는 이 방법으로 변경되지 않습니다. defaultTracker가 설정되지 않은 경우 여기에 반환된 추적기 인스턴스로 설정됩니다.
- 매개변수
-
trackingID 이 추적기에 사용할 추적 ID입니다. UA-xxxxx-y형식이어야 합니다. 추적기의 이름은 trackingID와 동일합니다.
- 반환 값
- 지정된 trackingID와 연결된 GAITracker입니다. 추적기는 추적 데이터를 Google 애널리틱스로 전송하는 데 사용할 수 있습니다. 이 메서드가 특정 trackingID로 처음 호출되면 각 이름의 추적기가 반환되고 동일한 trackingID를 사용한 후속 호출이 동일한 인스턴스를 반환합니다. 추적기는 라이브러리에서 내부적으로 유지되므로 추적기를 유지할 필요는 없습니다.
오류가 발생하거나 trackingId가 유효하지 않은 경우 이 메서드는 nil를 반환합니다.
| - (void) removeTrackerByName: | (NSString *) | name |
추적기 사전에서 추적기를 삭제합니다.
기본 추적기인 경우 기본 추적기도 지웁니다.
- 매개변수
-
이름 추적기의 이름입니다.
| - (void) 전달 |
대기 중인 추적 정보를 전달합니다.
이는 dispatchInterval에는 영향을 미치지 않으며 주기적 디스패치와 함께 사용할 수 있습니다.
| - (void) dispatchWith완료Handler: | (void(^)(GAIDispatchResult result)) | completionHandler |
추적 비콘이 전송되었거나 (kGAIDispatchGood 반환) 오류 결과 (kGAIDispatchError 반환)가 발생하면 completeHandler를 호출하여 대기열에서 다음 추적 비콘을 전달합니다.
네트워크 연결이 없거나 전송할 데이터가 없는 경우 kGAIDispatchNoData가 반환됩니다.
nil이 아닌 completeHandler를 사용해 이 메서드를 호출하면 주기적 전달이 사용 중지됩니다. 앱이 백그라운드에서 다시 시작될 때 dispatchInterval을 양수로 설정하면 정기 전달을 다시 사용 설정할 수 있습니다.
nil completeHandler를 사용하여 이 메서드를 호출하는 것은 위의 디스패치를 호출하는 것과 같습니다.
이 메서드는 iOS 7.0 이상에서 백그라운드 데이터를 가져오는 데 사용할 수 있습니다. 애플리케이션이 종료될 때 제출되지 않은 추적 정보를 제출하기 위해 이 메서드를 호출하는 것이 좋습니다.
- 매개변수
-
completionHandler 단일 디스패치 요청 후에 실행할 블록입니다. GAIDispatchResult 매개변수는 전달이 성공했는지, 오류가 발생했는지 또는 전달할 조회가 없는지를 나타냅니다.
부동산 관련 문서
|
(읽기/쓰기, 비원자적, 할당) |
편의를 위해 이 클래스는 기본 추적기 인스턴스를 노출합니다.
nil로 초기화되며 trackerWithTrackingId:에서 인스턴스화된 첫 번째 추적기로 설정됩니다. 원하는 대로 재정의할 수 있습니다.
GAITrackedViewController 클래스는 기본적으로 이 추적기 인스턴스를 사용합니다.
|
(읽기/쓰기, 비원자적, 할당) |
이 경우 추적 정보가 수집되지 않으며 추적 통화는 사실상 노옵스(no-ops)가 됩니다.
true로 설정하면 업로드 대기 중인 모든 정보가 삭제됩니다. 이 플래그의 값은 SDK에 의해 자동으로 유지됩니다. 개발자는 원하는 경우 이 플래그를 사용하여 사용자가 Google 애널리틱스 추적을 선택 해제할 수 있도록 앱에서 선택 해제 설정을 구현할 수 있습니다.
이 값은 기기에서 Google 애널리틱스 SDK가 처음 사용될 때 NO로 설정되며 그 후에도 유지됩니다.
|
(읽기/쓰기, 비원자적, 할당) |
이 값이 양수이면 dispatchInterval초마다 추적 정보가 자동으로 발송됩니다.
그렇지 않으면 디스패치를 호출하여 수동으로 추적 정보를 전송해야 합니다.
기본적으로 120로 설정되어 있으며, 이는 추적 정보가 120초마다 자동으로 전달되어야 함을 나타냅니다.
|
(읽기/쓰기, 비원자적, 할당) |
true로 설정하면 SDK는 현재 등록된 포착되지 않은 예외 핸들러를 기록한 다음 defaultTracker를 사용하여 발생한 예외를 추적하는 포착되지 않은 예외 핸들러를 등록합니다.
defaultTracker가 nil가 아닌 경우 이 함수는 추적기에서 예외를 추적하고 해결되지 않은 추적 정보를 5초 동안 전달하려고 시도합니다. 그런 다음 이전에 등록된 예외 핸들러가 있는 경우 이를 호출합니다. false로 다시 설정하면 이전에 등록된 포착되지 않은 예외 핸들러가 복원됩니다.
|
(읽기/쓰기, 비원자적, 할당) |
'예'인 경우 추적 정보가 전송되지 않습니다.
기본값은 '아니요'입니다.