https://github.com/codeandtheory/yanalytics-adobe-ios
Y—Analytics implementation for Adobe SDK
https://github.com/codeandtheory/yanalytics-adobe-ios
Last synced: 2 months ago
JSON representation
Y—Analytics implementation for Adobe SDK
- Host: GitHub
- URL: https://github.com/codeandtheory/yanalytics-adobe-ios
- Owner: codeandtheory
- License: apache-2.0
- Created: 2023-03-28T13:02:29.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-05-05T10:05:50.000Z (almost 3 years ago)
- Last Synced: 2025-11-18T09:25:32.458Z (3 months ago)
- Language: Swift
- Size: 167 KB
- Stars: 1
- Watchers: 7
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://swiftpackageindex.com/yml-org/yanalytics-adobe-ios) [](https://swiftpackageindex.com/yml-org/yanalytics-adobe-ios)
_An Adobe implementation of Y—Analytics' `AnalyticsEngine` protocol._
This framework links the [Adobe Experience Platform Analytics SDK](https://github.com/adobe/aepsdk-analytics-ios) to implement an Adobe version of [Y—Analytics](https://github.com/yml-org/yanalytics-ios)' `AnalyticsEngine` protocol.
Licensing
----------
Y—Analytics Adobe is licensed under the [Apache 2.0 license](LICENSE).
Adobe Experience Platform Analytics SDK is licensed under the [Apache 2.0 license](https://github.com/adobe/aepsdk-analytics-ios/blob/main/LICENSE).
Documentation
----------
Documentation is automatically generated from source code comments and rendered as a static website hosted via GitHub Pages at: https://yml-org.github.io/yanalytics-adobe-ios/
Usage
----------
### `AdobeAnalyticsEngine`
`AdobeAnalyticsEngine` implements the `AnalyticsEngine` protocol, and in its `track(event:)` method it maps the `AnalyticsEvent` enum to the appropriate Adobe methods.
Internally the Adobe SDK is just using singleton objects, but the goal of Y—Analytics is to use Dependency Injection of a generic wrapper. This allows your project code to be loosely coupled to your choice of analytics provider. It also facilitates unit testing and a healthy app architecture.
Just be aware that even if you declare multiple instances of `AdobeAnalyticsEngine`, that they all reference the same Adobe SDK singleton.
When unit testing various components of your project, you should inject an instance of `MockAnalyticsEngine` instead of the Adobe engine. This allows your unit tests to run without any Adobe dependency and allows you to verify which events are tracked and when.
#### Simple use case: app ID
You may initialize `AdobeAnalyticsEngine` by passing an Adobe app ID.
```swift
import YAnalyticsAdobe
final class AppCoordinator {
let engine: AnalyticsEngine = {
let config = AdobeAnalyticsConfiguration(appId: "S3cr3t!")
return AdobeAnalyticsEngine(configuration: config)
}()
func trackSomething(someData: [String: Any]?) {
engine.track(
event: .event(name: "Something", parameters: someData)
)
}
}
```
#### Additional configuration options
In addition to the required app id, `AdobeAnalyticsConfiguration` can be initialized with the following additional parameters:
1. extensions: extensions to register with Adobe.
2. mappings: information for mapping from `AnalyticsEvent` to Adobe events.
3. logLevel: logging level to use
```swift
import YAnalyticsAdobe
final class AppCoordinator {
let extensions: [NSObject.Type] = ...
let logLevel: LogLevel = ...
let mappings: [String: AdobeEventMapping] = ...
let engine: AnalyticsEngine = {
let config = AdobeAnalyticsConfiguration(
extensions: extensions,
appId: "S3cr3t",
logLevel: logLevel,
mappings: mappings
)
return AdobeAnalyticsEngine(configuration: config)
}()
}
```
Dependencies
----------
Y—Analytics Adobe depends upon our [Y—Analytics](https://github.com/yml-org/yanalytics-ios) framework (which is also open source and Apache 2.0 licensed).
Installation
----------
You can add Y—Analytics Adobe to an Xcode project by adding it as a package dependency.
1. From the **File** menu, select **Add Packages...**
2. Enter "[https://github.com/yml-org/yanalytics-adobe-ios](https://github.com/yml-org/yanalytics-adobe-ios)" into the package repository URL text field
3. Click **Add Package**
Contributing to Y—Analytics Adobe
----------
### Requirements
#### SwiftLint (linter)
```
brew install swiftlint
```
#### Jazzy (documentation)
```
sudo gem install jazzy
```
### Setup
Clone the repo and open `Package.swift` in Xcode.
### Versioning strategy
We utilize [semantic versioning](https://semver.org).
```
{major}.{minor}.{patch}
```
e.g.
```
1.0.5
```
### Branching strategy
We utilize a simplified branching strategy for our frameworks.
* main (and development) branch is `main`
* both feature (and bugfix) branches branch off of `main`
* feature (and bugfix) branches are merged back into `main` as they are completed and approved.
* `main` gets tagged with an updated version # for each release
### Branch naming conventions:
```
feature/{ticket-number}-{short-description}
bugfix/{ticket-number}-{short-description}
```
e.g.
```
feature/CM-44-button
bugfix/CM-236-textview-color
```
### Pull Requests
Prior to submitting a pull request you should:
1. Compile and ensure there are no warnings and no errors.
2. Run all unit tests and confirm that everything passes.
3. Check unit test coverage and confirm that all new / modified code is fully covered.
4. Run `swiftlint` from the command line and confirm that there are no violations.
5. Run `jazzy` from the command line and confirm that you have 100% documentation coverage.
6. Consider using `git rebase -i HEAD~{commit-count}` to squash your last {commit-count} commits together into functional chunks.
7. If HEAD of the parent branch (typically `main`) has been updated since you created your branch, use `git rebase main` to rebase your branch.
* _Never_ merge the parent branch into your branch.
* _Always_ rebase your branch off of the parent branch.
When submitting a pull request:
* Use the [provided pull request template](.github/pull_request_template.md) and populate the Introduction, Purpose, and Scope fields at a minimum.
* If you're submitting before and after screenshots, movies, or GIF's, enter them in a two-column table so that they can be viewed side-by-side.
When merging a pull request:
* Make sure the branch is rebased (not merged) off of the latest HEAD from the parent branch. This keeps our git history easy to read and understand.
* Make sure the branch is deleted upon merge (should be automatic).
### Releasing new versions
* Tag the corresponding commit with the new version (e.g. `1.0.5`)
* Push the local tag to remote
Generating Documentation (via Jazzy)
----------
You can generate your own local set of documentation directly from the source code using the following command from Terminal:
```
jazzy
```
This generates a set of documentation under `/docs`. The default configuration is set in the default config file `.jazzy.yaml` file.
To view additional documentation options type:
```
jazzy --help
```
A GitHub Action automatically runs each time a commit is pushed to `main` that runs Jazzy to generate the documentation for our GitHub page at: https://yml-org.github.io/yanalytics-adobe-ios/