Adrop에 Flutter 앱 등록하기

0. 사전 준비 사항

선호하는 에디터 또는 IDE를 준비해주세요. Adrop은 다음의 환경에서 동작합니다.

• 안드로이드 :

  • API 레벨 23(M) 혹은 그 이상을 타겟팅

  • Android 6.0 혹은 그 이상 버전을 사용

    • minSdkVersion 23

  • 다음의 버전을 충족하는 Jetpack (AndroidX)을 사용

    • com.android.tools.build:gradle v7.3.0 버전 이상

      • compileSdkVersion 33

  • Kotlin 1.7.10 버전 이상

• iOS:

  • iOS 13

  • Swift 5.0

• 다음 사항을 포함하여 운영체제에 맞게 Flutter 를 설치해주세요:

  • Flutter SDK

  • Supporting libraries

  • 특정 플랫폼에 최적화된 소프트웨어와 SDKs

이제 이메일 또는 구글 계정을 통해 Adrop에 로그인하세요.

Adrop 서비스는 Dart packagesadrop_ads_flutter | Flutter package 라이브러리를 설치하여 이용하실 수 있습니다. 라이브러리를 설치하기 전에 프로젝트 생성과 앱 등록이 선행되어야 합니다. 아래 가이드를 순서대로 따라와주세요. 이미 프로젝트 생성과 앱 등록이 되어있다면, Adrop 설정파일 추가하기 섹션을 확인해 주세요.

---

1. Adrop 프로젝트 생성

먼저 Adrop 시작하기 가이드를 통해 Flutter 앱에 연결할 프로젝트를 생성해 주세요.

2. Adrop에 앱 등록하기

Adrop 콘솔을 사용하기 위해 '프로젝트'에 Flutter 앱 등록이 먼저 필요합니다.

1. 왼쪽 네비게이션의 광고 상품 메뉴에 접근합니다. 해당 메뉴의 오른쪽 상단에 광고 상품 생성하기를 클릭합니다.

   
2. 광고 상품 제작 상세페이에서 새로운 유닛 만들기를 클릭해 주세요.

   
3. 하단의 모달 창의 앱 선택 드롭다운 메뉴에서 앱 생성하기를 클릭해 주세요.

   

앱 스토어 혹은 구글 플레이 스토어에 등록된 앱이 있다면 가이드 4로 가세요. 스토어에 등록되지 않고, 개발중인 앱이라면 가이드 5로 가세요.

4. 광고를 게시하고자 하는 앱 서비스를 플랫폼 별로 검색하여 선택해주세요.

   

   

   

5. 스토어에 등록된 앱이 없다면, 패키지를 직접 등록합니다. 하단 가이드를 참고해 주세요.

   

   

6. 콘솔에 앱이 성공적으로 등록되면, 왼쪽 네비게이션 앱 메뉴에서, 아래와 같이 등록된 어플리케이션들의 리스트를 확인할 수 있습니다.

   

3. Adrop 설정 파일 추가하기

Adrop 서비스를 이용하기 위해서는, 설정 파일을 앱 내부에 추가해 주셔야 합니다. 설정파일은 왼쪽 네비게이션의 앱 메뉴에 접근하시면 확인하실 수 있습니다.

Android

1. adrop_service.json을 다운로드하고 Adrop 안드로이드 플랫폼 설정 파일을 받으세요.

2. 설정 파일을 에셋 디렉토리로 이동시켜주세요. android/app/src/main/assets/adrop_service.json

Apple

1. adrop_service.json 을 다운로드해서 Adrop Apple 플랫폼 설정 파일을 받으세요.

2. 설정 파일을 Xcode 프로젝트의 Runner 디렉토리 루트로 이동시켜 주세요.
3. 프로젝트를 빌드 해 주세요.

   

4. 앱에 Adrop 플러그인을 추가

플러그인을 추가하기 전에 사전 준비 사항을 확인해 주세요.

1. 준비 사항이 잘 확인되었다면, Flutter 프로젝트 디렉토리에서 하단의 커맨드를 실행시켜 플러그인을 설치해주세요.

flutter pub add adrop_ads_flutter
cd ios
pod install --repo-update

5. 앱에서 Adrop 초기화(Initialize)하기

마지막으로, 앱 시작 시 Adrop을 초기화 하기 위하여 프로젝트 루트 위젯에 하단 초기화 코드를 추가해 주세요.

1. Adrop 플러그인을 import하세요.

import 'package:adrop_ads_flutter/adrop_ads_flutter.dart';

2. 앱 시작 시, Adrop을 초기화하세요.

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
    initialize();
  }

  Future<void> initialize() async {
    // ..
    // true for production
    await Adrop.initialize(false); // production 파라미터를 false로 전달할 경우, SDK내에서 발생하는 로그가 출력됩니다.
  }
}

3. 광고 노출수(impressions)를 측정할 수 있도록 AdropNavigatorObserver 를 추가해주세요.

 @override
  Widget build(BuildContext context) {
  return MaterialApp(
      navigatorObservers: [AdropNavigatorObserver()],
      ...
  );

4. Flutter 애플리케이션을 리빌드해주세요.

flutter run

성공적으로 설치가 끝났다면 아래 다음 단계 가이드를 진행하여 직광고를 노출해 보세요.

---

Next Steps

1. 광고 유닛 등록하기

이제 광고 유닛을 등록하면 사용자에게 광고주의 직광고를 노출할 수 있어요.

광고 유닛 등록 방법을 알려드릴게요.

2. 광고 유닛 노출하기

이미 등록된 광고 유닛이 있다면 광고를 노출해 보세요.

광고 노출하기 - Flutter

배너 광고

전면 광고

보상형 광고

---

(선택사항) Troubleshooting

# Add this line to your Podfile
use_frameworks!

# ...
post_install do |installer|
    installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|

        #...
        # Add this line to your Podfile
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        end
    end
end