App Native Slider

Важно

이 광고 템플릿은 더 이상 사용되지 않습니다. 대신 App Native Carousel을 사용하세요.

App Native Slider는 상호 연결된 광고로 구성된 슬라이더로, 네이티브 광고의 원칙을 사용합니다. 슬라이더가 표시될 앱의 기능과 디자인에 따라 광고를 사용자 정의할 수 있습니다.

App Native Slider 광고 예시:

이미지 요구 사항

  • 고해상도 이미지를 사용하세요. 그러면 모바일 장치에서 배너의 표시 품질이 향상됩니다. 그러나 시간이 길어질 수 있습니다.
  • TinyPNG와 같은 파일 압축 서비스를 사용하여 이미지 파일 크기를 줄이는 것을 권장합니다.
  • 허용되는 이미지 형식: PNG, GIF(애니메이션 없음), JPG.
  • 단일 파일의 최대 크기는 300KB입니다.

네이티브 배너 만들기

  1. 배너에 포함할 네이티브 요소를 결정합니다.

  2. JSON 코드를 준비합니다. 코드에서 사용자 지정하려는 매개 변수(광고 요소 및 해당하는 값)를 지정하세요.

    JSON 예시
    {
      "content": [
        "text",
        "button"
      ],
      "text": {
        "value": "Customizable text from an Adfox ad unit"
      },
      "button": {
        "label": "Custom button",
        "link": "https://ya.ru/",
        "backgroundColor": "#5D9B9B"
      }
    }
    

    배너의 JSON 요소에 대한 클릭 URL을 전달하려면 매트로( %banner.reference_mrc_user1%)를 사용합니다. 시스템이 배너 클릭을 계수하고 사용자를 Transition URL 매개변수에 지정된 광고주 사이트로 리디렉션할 것입니다.

  3. JSON을 한 줄로 작성하고 \ 문자를 사용해 인용 부호를 이스케이프합니다.

    이스케이프된 인용 부호가 있는 JSON 예시
    {   \"content\": [     \"text\",     \"button\"   ],   \"text\": {     \"value\": \"Customizable text from an Adfox ad unit\"   },   \"button\": {     \"label\": \"Custom button\",     \"link\": \"https:\/\/ya.ru\/\",     \"backgroundColor\": \"#5D9B9B\"   }
    
  4. 앱에서 네이티브 요소가 올바르게 표시될 수 있도록, 앱 측에서 JSON 데이터 읽기 지원을 추가합니다. JSON에서 지정된 각 네이티브 광고 요소는 앱 코드에 적절히 구현되어야 합니다.

    JSON 데이터 파싱 예시(Kotlin)
    
    private fun processAdditionalText(rawJson: String) {
        try {
            val jsonObject = JSONObject(rawJson)
            val contentJSONArray = jsonObject.getJSONArray("content")
    
            repeat(contentJSONArray.length()) { index ->
                val elementName = contentJSONArray.getString(index)
                val elementConfiguration = jsonObject.getJSONObject(elementName)
    
                when (elementName) {
                    "text" -> addTextToLayout(elementConfiguration, index)
                    "button" -> addButtonToLayout(elementConfiguration, index)
                }
            }
        } catch (e: JSONException) {
            adInfoFragment.log(e.message ?: "JSON parsing error")
        }
    }
    
    private fun addTextToLayout(textConfiguration: JSONObject, index: Int) {
        val textView = TextView(this).apply {
            setPadding(resources.getDimension(R.dimen.item_padding).toInt())
    
            text = textConfiguration.getString("value")
        }
        additionalContainer.addView(textView, index)
    }
    
    private fun addButtonToLayout(buttonConfiguration: JSONObject, index: Int) {
        val buttonView = Button(this).apply {
            setPadding(resources.getDimension(R.dimen.item_padding).toInt())
    
            text = buttonConfiguration.getString("label")
    
            val colorHex = buttonConfiguration.getString("backgroundColor")
            setBackgroundColor(Color.parseColor(colorHex))
    
            setOnClickListener {
                val link = buttonConfiguration.getString("link")
                val intent = Intent(Intent.ACTION_VIEW, Uri.parse(link))
                startActivity(intent)
            }
        }
        additionalContainer.addView(buttonView, index)
    }
    
    
  5. 아래 지침에 따라 배너를 추가합니다.

네이티브 배너 준비 단계

Adfox에 배너 추가

배너를 추가하려면:

  1. 광고 캠페인 설정에서 Banners 탭으로 이동하여 Add를 클릭합니다.

  2. App Mobile Native 배너 유형과 App Native Slider 템플릿을 선택합니다.

  3. 배너 매개변수를 설정합니다.

    • Priority: 캠페인에서 배너 표시 순서를 결정하는 숫자입니다. 숫자가 높을수록 동일한 캠페인 내 다른 배너보다 우선순위가 높습니다. 우선순위에 대해 자세히 알아보려면 Adfox 도움말을 참조하세요.

    • Slide N: image(N은 슬라이드 번호)는 슬라이드 이미지입니다.

    • Slide N: click-through web link(N은 슬라이드 번호)는 광고주의 웹사이트로 연결되는 링크입니다. 클릭이 올바르게 작동하도록 하려면 링크에 프로토콜(http:// 또는 https://)이 포함되어 있는지 확인하세요. 사용자가 앱을 설치하지 않은 경우, 딥링크 대신 이 링크가 호출됩니다.

    • Slide N: Deeplink(N은 슬라이드 번호)는 사용자를 iOS 또는 Android 앱의 특정 페이지로 리디렉션하는 링크입니다.

    • Slide N: Android BundleID(N은 슬라이드 번호)는 Android에서 딥링크가 작동하기 위해 필요한 Play Store의 앱 ID입니다. 예시: ru.yandex.searchplugin.

    • Width: 슬라이더 너비입니다. 크기 지정 없이 픽셀 단위의 정수만 입력하세요.

    • Height: 슬라이더 높이입니다. 크기 지정 없이 픽셀 단위의 정수만 입력하세요.

    • Additional text: 광고나 크리에이티브에 사용자 정의 요소를 추가해야 하는 경우, 이전에 생성한 JSON을 지정하세요.

      작성된 Additional text 필드의 예시

    • Slide set: 이 필드에서 슬라이드의 수와 유형을 조정할 수 있습니다. %global.InAppSlideN%(딥링크가 포함된 슬라이드의 경우) 및 %global.InAppSlideDeeplinkN%(딥링크가 포함된 슬라이드의 경우)과 같은 변수를 목록에 추가하세요. 여기서 N은 슬라이드 번호입니다.

      딥링크가 포함된 세 개의 슬라이드로 구성된 슬라이더의 필드 작성 예시
      %global.InAppSlideDeeplink1%
      %global.InAppSlideDeeplink2%
      %global.InAppSlideDeeplink3%
      
    • Start date and time: 필수 매개변수입니다. 기본적으로 이 매개변수는 현재 날짜로 설정됩니다. 변경하지 않으면 배너가 추가된 후 즉시 제공되기 시작합니다(상태가 active로 설정된 경우).

    • Name: 배너의 이름을 입력하세요. 이 필드를 비워두면 순차적인 번호가 할당됩니다.

    • Status: 배너의 상태를 선택하세요.

      • active: 배너를 제공할 준비가 되었습니다.
      • paused: 배너 노출이 일시 중지되었습니다.
      • completed: 배너가 제공되지 않습니다.
    • Disabled on new placements: 이 옵션은 기본적으로 활성화되어 있습니다. 배너를 생성하면 자동으로 배치되지 않습니다.

      • 캠페인이 배치된 사이트나 섹션 내에 새로 생성된 배치 내.
      • 배너가 생성된 후 캠페인 배치 설정에서 활성화된 지면 내. 이 옵션을 비활성화하면 캠페인 배치가 활성화된 모든 배치에 배너가 자동으로 추가됩니다.
    • Targeting profile: 이전에 생성한 타겟팅 프로필을 선택하세요. 타겟팅 프로필에 대해 자세히 알아보려면 Adfox 도움말을 참조하세요.

    • Events enabled: 이 옵션은 타사 시스템에서 추적할 이벤트에 대한 다이렉트 링크를 얻는 데 사용됩니다. 옵션을 활성화하려면 Placements 탭에서 배너 옆에 있는 을 클릭하세요. 열리는 창에서 1부터 30까지의 이벤트에 대한 링크를 볼 수 있습니다. 이를 복사하여 타사 시스템에 전송해 추적하세요.

    • Impressions in total, day, hour:

      • Impressions total, day, hour: 배너 최대 노출수. 캠페인이 고르게 배포되면 배너 표시 종료일을 설정하세요. 노출수가 최대치에 도달하면 배너의 상태가 completed로 변경되고 더 이상 제공되지 않습니다.
      • Impressions per day: 배너 일일 최대 노출수. 하루가 시작된 이후 노출수가 최대치에 도달하면 다음 날이 시작될 때까지 일시 중지됩니다.
      • Impressions per hour: 배너 시간당 최대 노출수. 1시간이 시작된 이후 노출수가 최대치에 도달하면 다음 1시간이 시작될 때까지 일시 중지됩니다.
    • Clicks total, per day, per hour:

      • Clicks total: 배너 최대 클릭수. 캠페인이 고르게 배포되면 배너 표시 종료일을 설정하세요. 클릭수가 최대치에 도달하면 배너의 상태가 Completed로 변경되고 더 이상 제공되지 않습니다.
      • Clicks per day: 배너 일일 최대 클릭수. 하루가 시작된 이후 클릭수가 최대치에 도달하면 다음 날이 시작될 때까지 노출이 일시 중지됩니다.
      • Clicks per hour: 배너 시간당 최대 클릭수. 1시간이 시작된 이후 클릭수가 최대치에 도달하면 다음 1시간이 시작될 때까지 노출이 일시 중지됩니다.
    • End time: 종료 날짜와 시간을 설정하려면 먼저 옵션을 활성화하세요.

  4. 배너를 저장하려면 Add를 클릭하세요.

배너 이벤트에서 측정용 링크를 설정할 수 있습니다.

  • 전체 슬라이더의 노출수를 계수하는 A slider impression tracking pixel.
  • N 슬라이드의 노출수를 계수하는 An N slide impression tracking pixel(여기서 N은 슬라이드 번호).
  • The number of clicks for slide N, 여기서 N은 슬라이드 번호. 전체 클릭 통계는 모든 슬라이드의 총 클릭수입니다.

지원 문의