Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sparkfabrik/sparkfabrik-react-native-idfa-aaid
React Native module for getting IDFA (iOS) or AAID (Android)
https://github.com/sparkfabrik/sparkfabrik-react-native-idfa-aaid
Last synced: 5 days ago
JSON representation
React Native module for getting IDFA (iOS) or AAID (Android)
- Host: GitHub
- URL: https://github.com/sparkfabrik/sparkfabrik-react-native-idfa-aaid
- Owner: sparkfabrik
- License: mit
- Created: 2020-11-13T11:16:21.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-31T21:50:24.000Z (5 months ago)
- Last Synced: 2025-01-12T21:01:08.564Z (12 days ago)
- Language: Swift
- Size: 2.58 MB
- Stars: 86
- Watchers: 9
- Forks: 23
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
@sparkfabrik/react-native-idfa-aaid
# React Native module to get IDFA (iOS) or AAID (Android)
## Intro
[React Native](https://reactnative.dev/) is a framework for creating native mobile apps based on React.
The **Advertising Identifier** ([IDFA](https://developer.apple.com/documentation/adsupport/asidentifiermanager) on iOS, [AAID](https://developer.android.com/training/articles/ad-id) on Android) is a device-specific, unique, resettable ID for advertising that allows developers and marketers to track activity for advertising purposes.
This npm module allows any mobile application built with React Native to access the Advertising ID, following the OS specific definition and user permissions.
The module output in the RN framework is the following:
```ts
interface AdvertisingInfoResponse {
id: string; // the Advertising ID (or null if not defined/permitted)
isAdTrackingLimited: boolean; // the user defined permission to track
}
```
## Supported platform
- Android
- iOS
## Installation
```sh
npm install @sparkfabrik/react-native-idfa-aaid
```
or
```sh
yarn add @sparkfabrik/react-native-idfa-aaid
```
Then run `pod install` in your `ios` folder after installation.
## Usage
### iOS configuration
For `native` apps, in `info.plist` make sure to add:
```xml
NSUserTrackingUsageDescription
...
```
For `Expo` apps, in `app.json` make sure to add:
```json
{
"expo": {
"plugins": [
[
"expo-tracking-transparency",
{
"userTrackingPermission": "..."
}
]
]
}
}
```
### React Native components
Example of a basic integration in a RN component.
```js
import ReactNativeIdfaAaid, { AdvertisingInfoResponse } from '@sparkfabrik/react-native-idfa-aaid';
const MyComponent: React.FC = () => {
const [idfa, setIdfa] = useState();
useEffect(() => {
ReactNativeIdfaAaid.getAdvertisingInfo()
.then((res: AdvertisingInfoResponse) =>
!res.isAdTrackingLimited ? setIdfa(res.id) : setIdfa(null),
)
.catch((err) => {
console.log(err);
return setIdfa(null);
});
}, []);
```
#### iOS 17.4
In order to prevent a bug present in iOS 17.4 we also expose the `getAdvertisingInfoAndCheckAuthorization(check: boolean)` which aims to solve the problem of `ATT Tracking Manager` returning status `denied` even if the ATT modal was not yet displayed to the user.
```js
import ReactNativeIdfaAaid, { AdvertisingInfoResponse } from '@sparkfabrik/react-native-idfa-aaid';
const MyComponent: React.FC = () => {
const [idfa, setIdfa] = useState();
useEffect(() => {
ReactNativeIdfaAaid.getAdvertisingInfoAndCheckAuthorization(true)
.then((res: AdvertisingInfoResponse) =>
!res.isAdTrackingLimited ? setIdfa(res.id) : setIdfa(null),
)
.catch((err) => {
console.log(err);
return setIdfa(null);
});
}, []);
```
## Contributing
See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
## License
MIT