@sparkfabrik/react-native-idfa-aaid
    TypeScript icon, indicating that this package has built-in type declarations

    0.8.3 • Public • Published

    @sparkfabrik/react-native-idfa-aaid

    React Native module for getting IDFA (iOS) or AAID (Android)

    Intro

    React Native is a framework for creating native mobile apps based on React.

    The Advertising Identifier (IDFA on iOS, AAID 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:

    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

    npm install @sparkfabrik/react-native-idfa-aaid

    or

    yarn install @sparkfabrik/react-native-idfa-aaid

    Then run pod install in your ios folder after installation.

    Usage

    iOS configuration

    In info.plist make sure to add:

    <key>NSUserTrackingUsageDescription</key>
    <string>...</string>

    React Native components

    Example of a basic integration in a RN component.

    import ReactNativeIdfaAaid, { AdvertisingInfoResponse } from '@sparkfabrik/react-native-idfa-aaid';
    
    const MyComponent: React.FC = () => {
      const [idfa, setIdfa] = useState<string | null>();
    
      useEffect(() => {
        ReactNativeIdfaAaid.getAdvertisingInfo()
          .then((res: AdvertisingInfoResponse) =>
            !res.isAdTrackingLimited ? setIdfa(res.id) : setIdfa(null),
          )
          .catch((err) => {
            console.log(err);
            return setIdfa(null);
          });
      }, []);

    Contributing

    See the contributing guide to learn how to contribute to the repository and the development workflow.

    License

    MIT

    Install

    npm i @sparkfabrik/react-native-idfa-aaid

    DownloadsWeekly Downloads

    1,758

    Version

    0.8.3

    License

    MIT

    Unpacked Size

    28.1 kB

    Total Files

    21

    Last publish

    Collaborators

    • paolomainardi
    • monska85
    • edodusi