광고 투명성 URL 구성

광고 투명성 URL을 사용하면 특정 광고에 표시되는 AdChoices 아이콘을 맞춤설정할 수 있습니다. 기본적으로 이 아이콘은 광고주, 광고 자체 등의 정보를 포함하며 Google에서 렌더링한 광고 투명성 및 관리 (AT&C) 환경을 통해 사용자에게 표시됩니다.

Google 모바일 광고 SDK에 대한 광고 요청을 생성하면 광고 투명성 URL을 가져오고 광고 투명성 URL이 포함된 응답을 받을 수 있습니다. 앱 내에서 URL을 수신한 후 광고 디자인에 적합한 맞춤형 아이콘을 통합하고 사용자에게 자체 AT&C 환경을 제공할 수 있습니다.

이 페이지에서는 광고 투명성 URL을 요청, 파싱, 검증하는 방법을 설명합니다.

기본 요건

계속하기 전에 다음 작업을 완료했는지 확인하세요.

  • 앱에서 네이티브 광고를 설정합니다. 네이티브 광고에 관한 자세한 내용은 네이티브 광고를 참고하세요.
  • 이 기능에 대한 허용 목록 액세스 권한을 요청합니다. 액세스 권한을 요청하려면 계정 관리자에게 문의하세요.
    • 액세스 권한이 없으면 응답에서 광고 투명성 URL이 반환되지 않으며 기본 아이콘이 의도한 대로 렌더링됩니다.

URL 요청하기

GMA Next-Gen SDK가 광고 투명성 URL을 반환하도록 하려면 네이티브 광고 요청에 추가 요청 매개변수를 추가하세요. 이 매개변수는 앱이 맞춤형 아이콘을 처리할 준비가 되었음을 나타냅니다.

요청에서 "1" 값이 있는 "ad_transparency_url_requested" 키를 네트워크 추가 기능 번들에 추가해야 합니다. 네트워크 추가 기능에 관한 자세한 내용은 setGoogleExtrasBundle을 참고하세요.

다음 예에서는 광고 투명성 URL을 요청하기 위해 이 키와 값을 설정합니다.

자바 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

AD_UNIT_ID를 광고 단위 ID로 바꿉니다. 예를 들어 네이티브 광고의 경우 ca-app-pub-3940256099942544/2247696110입니다.

URL 파싱

URL을 요청하면 응답 정보 객체에 광고 투명성 URL이 포함된 광고 응답이 수신됩니다. 응답 정보 객체에 관한 자세한 내용은 응답 정보를 참고하세요.

응답 추가 기능의 "ad_transparency_url" 키 내에서 광고 투명성 URL에 액세스할 수 있습니다. 다음 예에서는 응답 정보 객체에서 광고 투명성 URL을 가져옵니다.

자바 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

URL 검증

광고 투명성 URL을 테스트하고 검증하려면 네이티브 광고에 Google에서 제공하는 기본 아이콘이 아닌 맞춤형 아이콘이 표시되는지 확인하세요. AT&C 환경을 확인하려면 아이콘을 클릭하세요.

또한 응답 정보 객체의 응답 추가 기능에서 광고 투명성 URL이 표시되는지 확인합니다. 광고 투명성 URL이 표시되지 않으면 맞춤형 아이콘 대신 기본 Google 아이콘이 렌더링됩니다. 다음은 광고 투명성 URL의 예입니다.

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID