Afficher les publicités natives sur Android

Les publicités natives vous donnent la possibilité de créer des annonces personnalisées pour correspondre à l’apparence du reste de votre application. Cette page décrit notre API Native Ads à un niveau élevé et inclut un exemple d’utilisation.

Réseaux natifs pris en charge par la médiation :

• Facebook
• AdMob et DFP

Pour diffuser des publicités natives, vous allez envoyer une demande de publicité native et recevoir une réponse publicitaire native. Pour Android 9 et versions ultérieures et l’API v. 28 et versions ultérieures, la requête doit être HTTPS par défaut afin de suivre avec précision la visibilité. Vous pouvez activer HTTPS avec useHttps(true).

Dans l’exemple de code ci-dessous, nous :

• Configurez un objet de requête et fournissez-le avec :

  • ID de placement (comme indiqué dans l’exemple de code ci-dessous), OR

  • Combinaison de code d’inventaire et d’ID de membre :

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

• Si vous le souhaitez, vous pouvez définir pour renderer_id ce NativeAdRequest. (Pour plus d’informations, renderer_id consultez Service de disposition native.) Le renderer_id doit être spécifié pour que vastxml, j’aime, téléchargements, saleprice, téléphone, adresse et URL d’affichage soient retournés dans .NativeAdResponse

  nativeAdRequest.setRendererId(RENDERER_ID);
  

• Inscrivez un écouteur qui signalera les événements publicitaires natifs tels que les clics (NativeAdEventListener).

• Inscrivez un écouteur pour signaler l’état de la demande native : réussite ou échec. L’écouteur doit implémenter l’interface NativeAdRequestListener .

• Si la demande réussit (c’est-à-dire qu’elle NativeAdListener.onAdLoaded() est déclenchée), les ressources publicitaires natives sont chargées dans l’objet NativeAdResponse qui peut être utilisée dans les vues qui correspondent à l’apparence native de l’application. Inscrivez ensuite la vue parente ou conteneur de ces vues pour activer le suivi de l’impression et des clics.

• Annulez l’inscription de la vue publicitaire native une fois que vous avez terminé le flux de travail. Lorsque la méthode unregister est appelée, le script d’affichage OMID du Kit de développement logiciel (SDK) Xandr Mobile génère un rapport en bloc de la session OMID pendant le flux de travail. Par conséquent, il est important que les éditeurs implémentent cette API qui facilite une mesure précise de la visibilité.

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);
    }
}
    

Champs pris en charge en mode natif

À compter de la version 5.0 du Kit de développement logiciel (SDK) mobile, la prise en charge des ressources natives est alignée sur la façon dont les créations natives sont configurées dans l’interface utilisateur de Xandr.

Si vous utilisez toujours la version native héritée dans, vous devez passer à « Nouveau » natif pour vos créations.

Voici une liste complète des ressources natives prises en charge dans les sdk.

Voir aussi

• Instructions d’intégration du Kit de développement logiciel (SDK) Android
• Obtenir Facebook demande native sur Android
• Mediate with Android SDK Instructions