Mostrar anuncios nativos en Android

Los anuncios nativos le ofrecen la posibilidad de crear anuncios personalizados que coincidan con el aspecto del resto de la aplicación. En esta página se describe nuestra API de Anuncios nativos en un nivel alto e incluye un ejemplo de uso.

Redes nativas admitidas a través de la mediación:

• Facebook
• AdMob y DFP

Para publicar anuncios nativos, enviará una solicitud de anuncio nativa y recibirá una respuesta de anuncio nativa. Para Android 9 y versiones posteriores y la API v. 28 y posteriores, la solicitud debe ser HTTPS de forma predeterminada para realizar un seguimiento preciso de la visualización. Puede habilitar HTTPS con useHttps(true).

En el código de ejemplo siguiente, se muestra lo siguiente:

• Configure un objeto de solicitud y proporcione lo siguiente:

  • El identificador de selección de ubicación (como se muestra en el código de ejemplo siguiente), OR

  • Una combinación de código de inventario e identificador de miembro:

    public NativeAdRequest nativeAdRequest= new NativeAdRequest(context, "PLACEMENT_ID");
    //public NativeAdRequest nativeAdRequest= new NativeAdRequest(context, "INVENTORY_CODE", MEMBER_ID);
    

• Opcionalmente, puede establecer para renderer_id este NativeAdRequest. (Para obtener más información, renderer_id consulte Servicio de diseño nativo). Debe renderer_id especificarse para que vastxml, likes, downloads, saleprice, phone, address y display URL se devuelvan en NativeAdResponse.

  nativeAdRequest.setRendererId(RENDERER_ID);
  

• Registre un agente de escucha que señale eventos de anuncios nativos, como clics (NativeAdEventListener).

• Registre un agente de escucha para indicar el estado de la solicitud nativa: correcto o error. El agente de escucha debe implementar la NativeAdRequestListener interfaz.

• Si la solicitud se realiza correctamente (es decir, NativeAdListener.onAdLoaded() se desencadena), los recursos de anuncios nativos se cargan en el NativeAdResponse objeto que se puede usar en vistas que coincidan con el aspecto nativo de la aplicación. A continuación, registre la vista principal o contenedor de estas vistas para habilitar el seguimiento de impresiones y clics.

• Anule el registro de la vista de anuncios nativa después de completar el flujo de trabajo. Cuando se llama al método unregister, el script de visualización de OMID del SDK de Xandr Mobile genera un informe masivo de la sesión de OMID durante el worflow. Por lo tanto, es importante que los publicadores implementen esta API, lo que facilita una medida precisa sobre la visibilidad.

public class MyActivity extends Activity {
 
    Context activityContext;
    NativeAdResponse nativeAdResponse;
    LinearLayout container;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
 
        activityContext = this;
 
        // Create a NativeAdRequest object
        NativeAdRequest adRequest = new NativeAdRequest(activityContext, "123456"); // Placement ID
         
        // Optionally set the renderer_id
        //adRequest.setRendererId(123);
 
        // Create a listener for ad events
        NativeAdEventListener adEventListener = new
                NativeAdEventListener() {
                    @Override
                    public void onAdWasClicked() {
                        // Do something when the view is clicked
                    }
 
                    @Override
                    public void onAdWillLeaveApplication() {
                        // Do something when the ad is taking user away from current app
                    }
 
                    @Override
                    public void onAdWasClicked(String clickUrl, String fallbackURL) {
                        // Handle Click URL
                    }
                };
 
        // Whether to pre-load the native ad's icon and main image
        adRequest.shouldLoadIcon(true);
        adRequest.shouldLoadImage(true);
 
        adRequest.setListener(new NativeAdRequestListener() {
            @Override
            public void onAdLoaded(NativeAdResponse response) {
                nativeAdResponse = response;
                // Cover image
                ImageView imageView = new ImageView(activityContext);
                imageView.setImageBitmap(response.getImage());
 
                // Icon image
                ImageView iconView = new ImageView(activityContext);
                iconView.setImageBitmap(response.getIcon());
 
                // Title
                TextView title = new TextView(activityContext);
                title.setText(response.getTitle());
 
                // Main text
                TextView description = new TextView(activityContext);
                description.setText(response.getDescription());
 
                // Text that indicates a call to action -- for example, to install an app
                TextView callToAction = new TextView(activityContext);
                callToAction.setText(response.getCallToAction());
 
                // Create a container (a parent view that holds all the
                // views for native ads)
                LinearLayout container = new LinearLayout(activityContext);
                container.addView(iconView);
                container.addView(title);
 
                // Add the native ad container to the view hierarchy
                LinearLayout ad_frame = findViewById(R.id.native_ad_frame);
                ad_frame.addView(container);
            }
 
            @Override
            public void onAdFailed(ResultCode errorcode) {
 
            }
        });
 
        // Call loadAd() to request a response once
        adRequest.loadAd();
 
        // Register native views for click and impression tracking.  The
        // adEventListener is the listener created above; it can be null if
        // you don't want to receive notifications about click events.
        // Impressions and clicks won't be counted if the view is not registered.
        NativeAdSDK.registerTracking(nativeAdResponse, container, adEventListener);
 
        // It's your responsibility to keep a reference to the view
        // and NativeAdResponse object if necessary.
        // Once done with the native ad view, call the following method to
        // unregister that view.
        NativeAdSDK.unRegisterTracking(container);
    }
}
    

Campos admitidos en nativos

A partir de la versión 5.0 del SDK móvil, la compatibilidad con recursos nativos se alinea con la configuración de las creatividades nativas en la interfaz de usuario de Xandr.

Si sigue usando Nativo heredado en, tendrá que pasar a "Nuevo" Nativo para las creatividades.

A continuación se muestra una lista completa de los recursos nativos admitidos en los SDK.

OpenRTB Native

OpenRTB Native hace referencia al uso de la especificación de recursos nativos de OpenRTB en las clases NativeAdRequest y NativeAdResponse, lo que permite solicitudes y respuestas de anuncios más flexibles y estandarizadas. Para obtener más información sobre los estándares de especificación de OpenRTB Native 1.2, consulte OpenRTB Native Ads Specification.1.2.

ORTB en NativeAdRequest

Para usar OpenRTB Native, la aplicación debe especificar recursos nativos de OpenRTB en NativeAdRequest mediante el método setOpenRTBAssets(JSONObject openRTBAssets). El contenido de este campo debe ser una solicitud nativa de OpenRTB, siguiendo el marcado de solicitud de OpenRTB Native 1.2.

Código de ejemplo de Java para solicitud

NativeAdRequest nativeAdRequest = new NativeAdRequest(context, "PLACEMENT_ID");
String ortbJSONString = "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":300}},{\"id\":2,\"required\":1,\"data\":{\"type\":2}},{\"id\":3,\"required\":1,\"data\":{\"type\":1}},{\"id\":4,\"required\":1,\"image\":{\"type\":3}},{\"id\":5,\"required\":0,\"data\":{\"type\":555,\"len\":45}}]}";
nativeAdRequest.setOpenRTBAssets(new JSONObject(ortbJSONString));

Kotlin de ejemplo de código para solicitud

var nativeAdRequest = NativeAdRequest(context, "PLACEMENT_ID")
val ortbJSONString = "{\"ver\":\"1.2\",\"assets\":[{\"id\":1,\"required\":1,\"title\":{\"len\":300}},{\"id\":2,\"required\":1,\"data\":{\"type\":2}},{\"id\":3,\"required\":1,\"data\":{\"type\":1}},{\"id\":4,\"required\":1,\"image\":{\"type\":3}},{\"id\":5,\"required\":0,\"data\":{\"type\":555,\"len\":45}}]}"
nativeAdRequest.openRTBAssets = JSONObject(ortbJSONString);

ORTB en NativeAdResponse

ORTB en respuesta corresponde al JSON nativo de ORTB sin procesar, que se expone a la aplicación mediante el método público JSONObject getOpenRTBNative() en la clase NativeAdResponse. Al igual que la solicitud, la respuesta JSONObject seguirá el marcado de respuesta de OpenRTB Native 1.2; consulte OpenRTB Native Ads Specification.1.2 para obtener más información.

Además de exponer la respuesta nativa ORTB sin procesar JSONObject a través de getOpenRTBNative(), el SDK también analiza y pone a disposición recursos de respuesta nativos de ORTB estándar (img, title, video y data) mediante métodos como getTitle(), getDescription(), getImageUrl(), getImage(), getImageSize(), getIconUrl(), getIconUrl(), getIconSize(), getCallToAction(), getAdStarRating(), getSponsoredBy(), getVastXml() y getPrivacyLink(). El SDK también controla automáticamente la impresión, la visualización y el seguimiento de clics.

Java de ejemplo de código para la respuesta

@Override
public void onAdLoaded(NativeAdResponse nativeAdResponse) {

    // Network type Network.APPNEXUS_ORTB indicates the response is ORTB
    if (nativeAdResponse.getNetworkIdentifier() == NativeAdResponse.Network.APPNEXUS_ORTB) {
        JSONObject ortbNativeResponseJSON = nativeAdResponse.getOpenRTBNative();

        // App has the option to either
        // 1. Use the parsed title, description, etc., which the SDK readily makes available
        // and dip into the ORTB Native response JSON for non-parsed/custom values
        // OR
        // 2. Handle all the ORTB Native response JSON response parsing in the app

        // Accessing title, description etc using the getters exposed in
        // NativeAdResponse class
        String title = nativeAdResponse.getTitle();
        String description = nativeAdResponse.getDescription();
        String imageUrl = nativeAdResponse.getImageUrl();
        NativeAdResponse.ImageSize imageSize = nativeAdResponse.getImageSize();
        
        
        // Parsing ORTB Native resposnse JSON
        // Extract "assets" array
        JSONArray assetsArray = ortbNativeResponseJSON.getJSONArray("assets");
        for (int i = 0; i < assetsArray.length(); i++) {
            JSONObject asset = assetsArray.getJSONObject(i);
            // This id will match the id provided in the request.
            // This id is essential for matching the various data assets in the request
            // with the response.            
            int id = asset.getInt("id");
            System.out.println("Asset ID: " + id); 

            // Check for "title"
            if (asset.has("title")) {
                String assetTitle = asset.getJSONObject("title").getString("text");
                System.out.println("Title: " + assetTitle);
            }

            // Check for "data"
            if (asset.has("data")) {
                String data = asset.getJSONObject("data").getString("value");
                System.out.println("Data: " + data);
            }

            // Check for "image"
            if (asset.has("image")) {
                JSONObject image = asset.getJSONObject("image");
                String url = image.getString("url");
                int width = image.getInt("w");
                int height = image.getInt("h");
                System.out.println("Image URL:"+url+",Width:"+width+",Height:"+height);
            }
        }
    }
}

Kotlin de ejemplo de código para la respuesta

override fun onAdLoaded(nativeAdResponse: NativeAdResponse) {

    // Network type Network.APPNEXUS_ORTB indicate the response is ORTB
    if(nativeAdResponse.networkIdentifier == NativeAdResponse.Network.APPNEXUS_ORTB) {
        var ortbNativeResponseJSON = nativeAdResponse.openRTBNative

        // App has the option to either
        // 1. Use the parsed title,description etc which the SDK readily makes available
        // and dip into the ORTB Native response JSON for non-parsed/custom values
        // OR
        // 2. Handle all the ORTB Native response JSON response parsing in the app

        // Accessing title, description etc using the getters exposed in
        // NativeAdResponse class
        nativeAdResponse.title
        nativeAdResponse.description
        nativeAdResponse.imageUrl
        nativeAdResponse.imageSize


        // Parsing ORTB Native resposnse JSON
        // Extract "assets" array
        val assetsArray = ortbNativeResponseJSON.getJSONArray("assets")
        for (i in 0 until assetsArray.length()) {
            val asset = assetsArray.getJSONObject(i)
            // This id will match the id provide in request,
            // This id is essential for matching the various data assets in req with response            
            val id = asset.getInt("id")
            println("Asset ID: $id") 

            // Check for "title"
            if (asset.has("title")) {
                val title = asset.getJSONObject("title").getString("text")
                println("Title: $title")
            }

            // Check for "data"
            if (asset.has("data")) {
                val data = asset.getJSONObject("data").getString("value")
                println("Data: $data")
            }

            // Check for "image"
            if (asset.has("image")) {
                val image = asset.getJSONObject("image")
                val url = image.getString("url")
                val width = image.getInt("w")
                val height = image.getInt("h")
                println("Image URL: $url, Width: $width, Height: $height")
            }
        }
    }

Ejemplo: Estructura JSONObject de respuesta nativa de ORTB en NativeAdResponse

 {
       "ver": "1.2",
       "assets": [
      {
          "id": 1,
          "title": {
              "text": "Sample Title here."
          }
       },{    
          "id": 2,
          "data": {
              "value": "Sample description text here."
           }
      }, {
          "id": 3,
          "data": {
              "value": "Sample Sponsored by text here."
          }
      }, {
          "id": 4,
          "image": {
              "url": "https://sample.img.url/here.jpg",
              "w": 123,
              "h": 234
          }
      }, {
          "id": 5,
          "data": {
              "value": "Sample disclaimer value here."
          }
      }
   ],
  // remaining ortb native 1.2 response fields would be here;
  // ie for link,privacy etc if available
} 

Temas relacionados

• Instrucciones de integración de Android SDK
• Obtener Facebook demanda de nativo en Android
• Mediar con instrucciones del SDK de Android