Mappage d’ID utilisateur sur Android

Vue d’ensemble

Xandr vous offre la possibilité d’envoyer l’ID interne du serveur de publication et les ID d’utilisateur à partir de sources tierces dans les demandes publicitaires. Il s’agit de paramètres globaux et il suffit de définir le ou les ID utilisateur une fois par session d’application, car ces valeurs sont utilisées dans toutes les demandes publicitaires consécutives dans la même session. Notez que Xandr ne stocke pas ces valeurs dans différentes sessions d’application.

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

ID interne du serveur de publication

Vous pouvez définir Publisher(First Party) User ID à l’aide de la méthode dans la setPublisherUserId classe SDKSettings dans l’API du Kit de développement logiciel (SDK) mobile. GetPublisherUserId retourne la valeur définie, qui est l’ID utilisateur de l’éditeur pour l’utilisateur de l’application actuelle.

/**
 * Specifies a string that corresponds to the Publisher(First Party) User ID for the current application user.
 * @param publisherUserId
 */
SDKSettings.setPublisherUserId(String publisherUserId);
 
/**
 * Returns the Publisher User Id for the current application user, initially added using {@link #setPublisherUserId(String)}
 * @@return publisherUserId as String.
 */
SDKSettings.getPublisherUserId();

ID utilisateur

Xandr prend en charge les ID d’utilisateur des sources ci-dessous :

• Criteo
• Le Trade Desk
• NetID
• LiveRamp
• UID 2.0
• ID fourni par l’éditeur / PPID (les éditeurs peuvent inscrire leur propre source via l’API et passer l’ID utilisateur)

Vous pouvez définir l’ID utilisateur en

• création d’une liste d’objets ANUserId , et

• affectation de la liste à la méthode setUserIds() dans ANSDKSettings.

• La getUserIds()méthode retourne les valeurs définies sous la forme d’une liste pour l’utilisateur actuel.

     /**
       * A Map containing objects that hold External UserId parameters for the current application user.
       * @param userIdList
       */
      public static void setUserIds(List<ANUserId> userIdList){
          Settings.getSettings().userIds = userIdList;
      }
      /**
       * Returns the Map that hold External UserId parameters for the current application user, initially added using {@link #setExternalUserIds(Map<ANExternalUserIdSource,String>)}
       * @@return externalUserIds as Map.
       */
      public static List<ANUserId> getUserIds() {
          return Settings.getSettings().userIds;
      }

  // In ANUserId.java
  package com.appnexus.opensdk;
    
  public class ANUserId {
    
      public enum Source {
          CRITEO,
          THE_TRADE_DESK,
          NETID,
          LIVERAMP,
          UID2
      }
       
      public ANUserId(String source, String userId){};
    
      public ANUserId(ANUserId.Source source, String userId) {};
   
    
      public String getUserId() {
          return userId;
      }
    
      public String getSource() {
          return source;
      }
  }

Exemples

import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
 
import com.appnexus.opensdk.ANExtendedUserIdSource;
import com.appnexus.opensdk.BannerAdView;
import com.appnexus.opensdk.SDKSettings;
 
import java.util.HashMap;
import java.util.Map;
 
public class MyActivity extends Activity {
 
    Context context;
    BannerAdView bav;
 
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_my);
        context = this;
 
        List<ANUserId> userIds = new ArrayList<>();
        ANUserId tradeDeskUserID = new ANUserId(ANUserId.Source.THE_TRADE_DESK, "userid-ttd-foobar");
        userIds.add(tradeDeskUserID);
        ANUserId criteoUserId = new ANUserId(ANUserId.Source.CRITEO, "userid-Criteo-foobar");
        userIds.add(criteoUserId);
        ANUserId netIdUserID = new ANUserId(ANUserId.Source.NETID, "userid-netid-foobar");
        userIds.add(netIdUserID);
        ANUserId liveRampUserID = new ANUserId(ANUserId.Source.LIVERAMP, "userid-liveramp-foobar");
        userIds.add(liveRampUserID);
        ANUserId UID2UserId = new ANUserId(ANUserId.Source.UID2, "userid-uid2-foobar");
        userIds.add(UID2UserId);
        ANUserId genericUserID = new ANUserId("Generic Source", "userid-generic-foobar");
        userIds.add(genericUserID);
 
        SDKSettings.setUserIds(userIds);          // Set User Id from External Sources
 
        // Setting Publisher First Party Id
        SDKSettings.setPublisherUserId("PublisherUserId-foobar");
 
        // Load Banner Ad
        // Create the AdView and set its placement ID.  Tweak a few other settings.
        bav = new BannerAdView(context);
        bav.setPlacementID("Placement");
        bav.setAdSize(300, 50);
        bav.setAdListener(adListener);
 
        //If auto-refresh is enabled
        bav.loadAd();
    }
 
    @Override
    protected void onDestroy() {
        super.onDestroy();
    }
}