Partager via


URL de clic sur Android

Le terme click-through fait référence à la capacité de notre Kit de développement logiciel (SDK) mobile à gérer ce qui se passe lorsque l’utilisateur clique sur une publicité. Ce document décrit le fonctionnement des clics et fournit des exemples sur la façon d’implémenter cette fonctionnalité.

Vue d’ensemble

Le Kit de développement logiciel (SDK) mobile de Xandr vous permet de déterminer comment la valeur de la click_url chaîne dans la réponse d’enchère sera gérée lorsque l’utilisateur clique sur une annonce.

Il existe trois possibilités :

  • Ouvrez l’URL cliquons dans le navigateur du Kit de développement logiciel (SDK).
  • Ouvrez l’URL de clic dans le navigateur d’appareil externe.
  • Retournez l’URL de l’environnement appelant sans ouvrir de navigateur.

Les cas qui ouvrent un navigateur notifient l’appelant via onAdClicked.

Dans le cas d’une demande de publicité native :

  • Deux URL sont retournées : click_url et click_url_fallback.

    Il est supposé que l’appelant gérera la ou les URL de clic de manière appropriée en affichant leur contenu à l’utilisateur. Le click_url_fallback, s’il est défini, est utilisé uniquement si click_url ne peut pas être résolu, pour une raison quelconque, par le système d’affichage du navigateur.

  • La méthode de rappel de l’écouteur/délégué est la suivante : onAdWasClicked(clickUrl, fallbackURL).

Structure du KIT de développement logiciel (SDK) mobile

  • Pour Bannière, Interstitial et Vidéo : AdListener définit la méthode onAdClicked(adView, clickUrl).
  • Pour Native : AdListener définit la méthode onAdWasClicked(clickUrl, fallbackURL).

Exemples

Si vous ne souhaitez pas extraire ClickURL, vous devez toujours implémenter une méthode onAdClicked qui retourne clickURL, mais elle peut être laissée vide.

Si vous souhaitez récupérer ClickURL, vous pouvez utiliser l’exemple de code suivant pour commencer :

// Enable RETURN_URL API
adObject.setClickThroughAction(ANClickThroughAction.RETURN_URL);

onAdClicked Ajoutez ensuite pour obtenir clickURL.

// Android: Java to handle ClickURL in ad response
package com.appnexus.opensdk;
 
import android.content.Context;
import android.os.Bundle;
import android.os.Handler;
import android.app.Activity;
import android.widget.FrameLayout;
import android.widget.ImageView;
import android.widget.RelativeLayout;
import android.widget.LinearLayout;
import android.widget.TextView;
 
import com.appnexus.opensdk.*;
import com.appnexus.opensdk.R.*;
 
public class PresentAdClickURL extends Activity {
 
    Context context;
    BannerAdView bav;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        context = this;
 
        // Create the AdView and set its placement ID.  Tweak a few other settings.
        bav = new BannerAdView(this);
        bav.setPlacementID("1326299");
        bav.setAdSize(300, 50);
        bav.setAdListener(adListener);
        // Enable RETURN_URL API
        bav.setClickThroughAction(ANClickThroughAction.RETURN_URL);
 
        //If auto-refresh is enabled
        bav.loadAd();
    }
 
 
 
 
    final AdListener adListener = new AdListener() {
        @Override
        public void onAdRequestFailed(AdView adView, ResultCode errorCode) {
        }
 
        @Override
        public void onAdLoaded(AdView adView) {
        }
 
        @Override
        public void onAdLoaded(NativeAdResponse response) { }
 
        @Override
        public void onAdExpanded(AdView adView) {
        }
 
        @Override
        public void onAdCollapsed(AdView adView) {
        }
 
        @Override
        public void onAdClicked(AdView adView) {
        }
 
        @Override
        public void onAdClicked(AdView adView, String clickUrl) {
        // the caller can handle it appropriately, displaying its content to the user.
        }
    };
 
 
    @Override
    protected void onDestroy() {
        super.onDestroy();
       }
}