Media Native Deeplink

Media Native Deeplink는 앱의 디자인과 원활하게 통합될 수 있는 이미지 크리에이티브를 위한 템플릿입니다. 이 템플릿을 사용하면 앱 내 특정 페이지로의 링크를 설정할 수 있습니다(딥링크)

Media Native Deeplink 광고 예시:

네이티브 배너 만들기

배너에 포함할 네이티브 요소를 결정합니다.
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 매개변수에 지정된 광고주 사이트로 리디렉션할 것입니다.

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 데이터 읽기 지원을 추가합니다. 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)
}

아래 지침에 따라 배너를 추가합니다.

네이티브 배너 준비 단계

광고 캠페인 설정에서 Banners 탭으로 이동하여 Add를 클릭합니다.
App Mobile Native 배너 유형과 Media Native Deeplink 템플릿을 선택합니다.
배너 매개변수를 설정합니다.
메인

추가
- Priority: 캠페인에서 배너 표시 순서를 결정하는 숫자입니다. 숫자가 높을수록 동일한 캠페인 내 다른 배너보다 우선순위가 높습니다. 우선순위에 대해 자세히 알아보려면 Adfox 도움말을 참조하세요.
- Click-through web URL: 딥링크가 리디렉션하는 앱을 사용자가 설치하지 않은 경우, 딥링크 대신 이 링크가 호출됩니다.
- Image URL (URL) 또는 Image URL (File): 이미지를 업로드합니다.
- Width: 배너 너비를 설정합니다(크기 지정 없이 픽셀 단위의 정수만 입력).
- Height: 배너 높이를 설정합니다(크기 지정 없이 픽셀 단위의 정수만 입력).
- Additional text: 광고나 크리에이티브에 사용자 정의 요소를 추가해야 하는 경우, 이전에 생성한 JSON을 지정하세요.
  
  작성된 Additional text 필드의 예시
- Android BundleID: Play Store의 앱 ID. 이 매개변수는 딥링크가 Android에서 작동하기 위해 필요합니다. 예시: ru.yandex.searchplugin.
- Deeplink click-through URL: 사용자를 iOS 또는 Android 앱의 특정 페이지로 리디렉션하는 링크입니다.
  
  Внимание
  
  운영 체제가 서로 다른 앱이 다른 주소 지정(객체 ID가 다름)을 사용하는 경우, 각 앱에 대해 자체 딥링크가 있는 별도의 배너를 만드세요.
  
  배치 관리를 더 용이하게 하려면 각 앱을 Adfox에 별도의 객체(웹사이트, 섹션 또는 사이트)로 추가하세요.
- Start date and time: 필수 매개변수입니다. 기본적으로 이 매개변수는 현재 날짜로 설정됩니다. 변경하지 않으면 배너가 추가된 후 즉시 제공되기 시작합니다(상태가 active로 설정된 경우).
- Ad label: Ad 또는 Social Ad를 선택하여 배너에 라벨을 추가합니다. 광고 크리에이티브에 이미 라벨이 포함된 경우 드롭다운 목록의 Disabled 값을 그대로 둘 수 있습니다.
  
  Примечание
  
  Social Ad 라벨을 추가한다고 해서 크리에이티브가 자동으로 소셜 광고로 정의되지는 않습니다. 크리에이티브를 상태 레지스터에서 소셜 광고로 라벨링하려면 해당하는 최종 광고주와의 계약에서 Social ads contract를 선택하세요.
- Domain: 라벨에 추가할 광고주 도메인( Ad / Example.com 또는 Social ad / Example.com)을 지정하세요(드롭다운 목록에서 Ad 또는 Social Ad 값을 선택한 경우에만).
- Show banner menu: 클릭할 수 없는 배너에 토큰을 추가하려면 이 옵션을 활성화하세요. 배너가 제공되면 오른쪽 상단 모서리에 메뉴 아이콘이 표시됩니다. 이 아이콘을 클릭하면 광고주에 대한 정보와 토큰을 복사하기 위한 버튼이 표시됩니다(이 배너에 대한 라벨링을 활성화했거나 타사 토큰을 지정한 경우).
  
  배너 메뉴에는 권장 기술 사용 규칙에 대한 링크가 포함되어 있습니다. 이는 2006년 7월 27일 제정된 연방법 제149-FZ호 “정보, 정보 기술 및 정보 보호에 관한 법률” 10.2-2조 1항 3호의 준수를 위해 요구되는 사항입니다.
  
  Примечание
  
  배너에 라벨이 지정되어야 하는 경우, 배너가 사용자에게 제공될 때 토큰을 사용할 수 있도록 배너 메뉴를 활성화할 수 있습니다.
- Settings for Russian ad register: 이 섹션은 캠페인 설정에서 라벨링 절차로 Advertising labeling을 선택한 경우에만 사용할 수 있습니다. 이 섹션의 필드를 작성하여 Yandex 광고 데이터 운영자에게 크리에이티브를 등록하세요. 크리에이티브에는 자동으로 토큰이 할당됩니다. 광고 라벨링에 대한 자세한 내용은 Adfox 도움말을 참조하세요.
- 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: 종료 날짜와 시간을 설정하려면 먼저 옵션을 활성화하세요.
배너를 저장하려면 Add를 클릭하세요.

지원 문의

Was the article helpful?

미디어 네이티브

앱 네이티브 슬라이더

Media Native Deeplink

네이티브 배너 만들기

Adfox에 배너 추가

Was the article helpful?