Google 모바일 광고 SDK를 앱에 통합하는 것은 광고 게재 및 수익 창출 SDK를 통합한 후에는 광고 형식 (예: 네이티브 또는 보상형 동영상)을 선택하고 구현할 수 있습니다
시작하기 전에
앱을 준비하려면 다음 섹션의 단계를 완료합니다.
앱 기본 요건
앱의 빌드 파일이 다음 값을 사용하는지 확인합니다.
- 최소 SDK 버전
</ph>
21
이상 - 다음의 SDK 버전을 컴파일합니다.
</ph>
33
이상
- 최소 SDK 버전
</ph>
앱 구성
Gradle 설정 파일에 Google Maven 저장소 및 Maven 중앙 저장소:
Kotlin
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include(":app")
Groovy
pluginManagement { repositories { google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() mavenCentral() } } rootProject.name = "My Application" include ':app'
앱 수준 빌드에 Google 모바일 광고 SDK의 종속 항목 추가 파일:
Kotlin
dependencies { implementation("com.google.android.gms:play-services-ads:23.3.0") }
Groovy
dependencies { implementation 'com.google.android.gms:play-services-ads:23.3.0' }
앱 ID를 Ad Manager 입력하세요. <ph type="x-smartling-placeholder">Ad Manager</ph> 웹 인터페이스를 앱의
AndroidManifest.xml
파일 이렇게 하려면 다음과 같이<meta-data>
태그를 추가합니다.android:name="com.google.android.gms.ads.APPLICATION_ID"
입니다. 다음에서 확인할 수 있습니다. 앱 ID를 Ad Manager 웹 인터페이스에 입력합니다. 대상android:value
, 자체 앱 ID를 Ad Manager 삽입하세요. 따옴표로 묶습니다.<manifest> <application> <!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~3347511713 --> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> </application> </manifest>
실제 앱에서는 샘플 앱 ID를 실제 앱 ID로 Ad Manager 앱 ID입니다. 다음과 같은 경우에 샘플 ID를 사용할 수 있습니다. Hello World 앱에서 SDK를 사용해 보고 있습니다
또한
<meta-data>
태그를 표시된 결과와 동일하게 추가하지 못하면 다음과 같은 메시지가 표시됩니다.Missing application ID.
(선택사항) 이전 버전이 Android에서 작동하기 위한
AD_ID
권한 13.앱에서 Google 모바일 광고 SDK 버전 20.4.0을 사용하는 경우 높은 경우 SDK가 자동으로
com.google.android.gms.permission.AD_ID
권한이 있으며 광고 ID에 액세스할 수 있습니다.Google 모바일 광고 SDK 버전 20.3.0을 사용하는 앱의 경우 Android 13을 타겟팅하는 경우
com.google.android.gms.permission.AD_ID
권한 Google 모바일 광고 SDK의AndroidManifest.xml
파일 광고 ID에 액세스합니다.<manifest> <application> <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value="ca-app-pub-xxxxxxxxxxxxxxxx~yyyyyyyyyy"/> <!-- For apps targeting Android 13 or higher & GMA SDK version 20.3.0 or lower --> <uses-permission android:name="com.google.android.gms.permission.AD_ID"/> </application> </manifest>
자세히 알아보려면
com.google.android.gms.permission.AD_ID
권한 선언, 자세한 내용은 이 Play 콘솔 도움말을 참조하세요.
Google 모바일 광고 SDK 초기화
</ph> 광고를 로드하기 전에 다음을 호출하여 Google 모바일 광고 SDK를 초기화합니다.MobileAds.initialize()
이 메서드는 SDK를 초기화하고 Google 모바일 광고 SDK 및 어댑터 초기화가 완료되거나 제한 시간은 30초입니다. 이 작업은 앱 실행 시 한 번만 처리하면 됩니다.
Google 모바일 광고 SDK 또는 미디에이션 파트너 SDK에서 광고를 미리 로드할 수 있음
. 유럽 사용자의 동의를 얻어야 하는 경우
경제 지역 (EEA)의 경우 요청별 플래그를 설정합니다. 예를 들면 다음과 같습니다.
setTagForChildDirectedTreatment()
를 탭합니다.
또는
setTagForUnderAgeOfConsent()
,
또는
초기화하기 전에 조치를 취하세요.
Google 모바일 광고 SDK에서
사용할 수 있습니다
다음은 백그라운드에서 initialize()
메서드를 호출하는 방법을 보여주는 예입니다.
할 수 있습니다.
자바
import com.google.android.gms.ads.MobileAds;
import com.google.android.gms.ads.initialization.InitializationStatus;
import com.google.android.gms.ads.initialization.OnInitializationCompleteListener;
public class MainActivity extends AppCompatActivity {
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
new Thread(
() -> {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this, initializationStatus -> {});
})
.start();
}
}
Kotlin
import com.google.android.gms.ads.MobileAds
import kotlinx.coroutines.CoroutineScope
import kotlinx.coroutines.Dispatchers
import kotlinx.coroutines.launch
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val backgroundScope = CoroutineScope(Dispatchers.IO)
backgroundScope.launch {
// Initialize the Google Mobile Ads SDK on a background thread.
MobileAds.initialize(this@MainActivity) {}
}
}
}
광고 형식 선택
이제 Google 모바일 광고 SDK 가져오기가 완료되어 광고를 구현할 준비가 되었습니다. Ad Manager 다양한 광고 형식을 제공하므로 앱의 사용자 환경에 가장 적합한 것을 선택할 수 있습니다.
배너
배너 광고 단위에는 앱 화면의 일부분을 차지하는 있습니다. 일정 시간이 지나면 자동으로 새로고침될 수 있습니다. 다시 말해 사용자가 동일한 콘텐츠를 유지하더라도 일정한 간격으로 새 광고를 봅니다. 화면에 나타납니다. 또한 구현하기 가장 간단한 광고 형식이기도 합니다.
전면 광고
전면 광고 단위는 앱에서 전체 페이지 광고를 게재합니다. 자연스러운 장소에 배치하세요. 앱 인터페이스에서 중단 및 전환(예: 레벨 완료 후) 50% 증가했습니다.
네이티브
네이티브 광고는 광고 제목, 텍스트, 이미지 등 앱에 표시되는 것을 확인할 수 있습니다 광고 스타일을 직접 지정하여 풍부한 사용자의 관심을 유도할 수 있는 자연스럽고 눈에 거슬리지 않는 광고 프레젠테이션을 만듭니다. 경험해 볼 수 있습니다
Google Ad Manager에서는 네이티브 광고를 구현하는 두 가지 방법인 네이티브 스타일과 표준 네이티브 광고를 게재할 수 있습니다.
네이티브 스타일은 네이티브 광고의 구현을 간소화하기 위해 이 형식을 처음 접하는 경우 좋은 선택이 될 것입니다 맞춤 렌더링은 를 사용하면 프레젠테이션을 최대한 자유롭게 만들 수 있습니다.
네이티브 스타일 구현 네이티브 광고 구현 (맞춤 렌더링)
리워드 제공됨
보상형 광고 단위를 사용하면 사용자가 코인, 생명 추가 생명, 포인트 등의 인앱 리워드 적립 다음과 같이 설정할 수 있습니다. 광고 단위별로 보상을 다르게 하고, 보상 가치 및 사용자가 받은 상품
보상형 전면 광고
보상형 전면 광고는 새로운 유형의 인센티브형 광고 형식으로 자동으로 게재되는 광고에 코인이나 추가 생명과 같은 리워드를 제공하세요. 앱 전환 중에 발생합니다.
보상형 광고와 달리 사용자는 수신 동의하지 않고도 보상형 동영상 광고를 전면 광고에 사용됩니다.
보상형 전면 광고를 사용하려면 보상형 광고에서 선택 메시지 대신 리워드를 공지하고 다음 경우에 사용자에게 선택 해제할 수 있는 인트로 화면 그렇게 하기를 원합니다.
앱 오프닝 광고
앱 오프닝 광고는 사용자가 앱을 열거나 앱으로 다시 전환할 때 표시되는 광고 형식입니다. 있습니다. 광고가 로드 화면 위에 오버레이됩니다.
추가 리소스
GitHub의 Google 모바일 광고 저장소는 이 API에서 제공하는 다양한 광고 형식을 사용하는 방법을 알아봅니다.