Dirección URL de click-through en Android
El término click-through hace referencia a la funcionalidad de nuestro SDK móvil para controlar lo que ocurre cuando el usuario hace clic en un anuncio. En este documento se describe cómo funciona el click-through y se proporcionan ejemplos sobre cómo implementar esta característica.
Información general
El SDK móvil de Xandr le permite determinar cómo se controlará el valor de la click_url
cadena en la respuesta de la puja cuando el usuario haga clic en un anuncio.
Hay tres posibilidades:
- Abra la dirección URL de click-through en el explorador DEL SDK.
- Abra la dirección URL de click-through en el explorador de dispositivos externos.
- Devuelva la dirección URL al entorno de llamada sin abrir ningún explorador.
Los casos que abran un explorador notificarán al autor de la llamada a través de onAdClicked
.
En el caso de una solicitud de anuncio nativa:
Se devuelven dos direcciones URL:
click_url
yclick_url_fallback
.Se supone que el autor de la llamada controlará correctamente las direcciones URL de click-through mostrando su contenido al usuario. Si
click_url_fallback
se define , solo se usa siclick_url
el sistema de visualización del explorador no puede resolver, por cualquier motivo.El método de devolución de llamada listener/delegate es:
onAdWasClicked(clickUrl, fallbackURL).
Estructura del SDK móvil
- Para Banner, Intersticial y Video:
AdListener
define el métodoonAdClicked(adView, clickUrl)
. - Para Nativo:
AdListener
define el métodoonAdWasClicked(clickUrl, fallbackURL)
.
Ejemplos
Si no desea capturar ClickURL, debe implementar un método onAdClicked
que devuelva clickURL
, pero se puede dejar vacío.
Si desea capturar ClickURL, puede usar el ejemplo de código siguiente para empezar:
// Enable RETURN_URL API
adObject.setClickThroughAction(ANClickThroughAction.RETURN_URL);
A continuación, agregue onAdClicked
para obtener 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();
}
}