Mappage d’ID utilisateur sur iOS

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

Remarque

Avis de dépréciation :

The externalUidla propriété de ANBannerAdView, ANNativeAdRequestInterstitialAdViewet ANInstreamVideoAd de la classe est désormais déconseillée. Vous pouvez utiliser publisherUserId la propriété décrite ci-dessous dans ANSDKSettings la classe à la place. Les méthodes déconseillées seront supprimées dans le SDK v8.0.

Vous pouvez définir l’ID interne du serveur de publication à l’aide de la publisherUserId propriété de ANSDKSettings dans l’API du Kit de développement logiciel (SDK) mobile.

IDFV en tant qu’ID interne de l’éditeur

En raison de l’introduction des modifications apportées à la transparence du suivi des applications (ATT) dans iOS 14.5 et versions ultérieures, le Kit de développement logiciel (SDK) Xandr Mobile propose aux éditeurs d’utiliser l’identificateur pour les fournisseurs (IDFV) de l’appareil dans les cas où il n’y a pas d’ID interne d’éditeur interne et d’identificateur pour les annonceurs (IDFA) n’est disponible. Cette fonctionnalité permet aux éditeurs de transmettre automatiquement IDFV dans les demandes d’annonces chaque fois que l’ID first party du serveur de publication et l’IDFA sont absents. Cette fonctionnalité est activée par défaut et si les éditeurs souhaitent la désactiver, ils peuvent utiliser disableIDFVUsage la propriété de dans l’API du Kit de ANSDKSettings développement logiciel (SDK) mobile.

/**
An AppNexus disableIDFVUsage  is a boolean value which exclude the IDFV field in ad request. Default value of disableIDFVUsage is set to NO and IDFV will be used in cases where IDFV and Publisher First Party ID is not present.
*/
@property (nonatomic, readwrite) BOOL disableIDFVUsage;

ID d'utilisateur

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

• NetID
• Utiq
• ID5
• Criteo
• ID unifié 1.0 ID trade desk
• Id d’hydron (Audigent)
• Publink (Epsilon)
• SharedID
• EUID
• Yahoo Connect ID
• Panorama ID
• 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’un tableau d’objets ANUserId , et
• affectation du tableau d’objets à la userIdArray propriété de dans l’API ANSDKSettings du Kit de développement logiciel (SDK) mobile.

// In ANSDKSettings.h: 
/**
 A Dictionary containing objects that hold UserId parameters.
 */ 
@property (nonatomic, readwrite, strong, nullable) NSArray<ANUserId *>  *userIdArray ;

// In ANUserId.h
 
/*
 *  Supported Third Party ID Sources
 * */
typedef NS_ENUM(NSUInteger, ANUserIdSource) {
    ANUserIdSourceLiveRamp,
    ANUserIdSourceNetId,
    ANUserIdSourceCriteo,
    ANUserIdSourceTheTradeDesk,
    ANUserIdSourceUID2
};
 
 
/**
 Defines the User Id Object from an Extended Third Party Source
 */
@interface ANUserId : NSObject
 
/**
 Source of the User Id
 */
@property (nonatomic, readwrite, strong, nonnull) NSString *source;
 
/**
 The User Id String
 */
@property (nonatomic, readwrite, strong, nonnull) NSString *userId;
 
 
- (nullable instancetype)initWithSource:(ANUserIdSource)source userId:(nonnull NSString *)userId; 
- (nullable instancetype)initWithStringSource:(nonnull NSString *)source userId:(nonnull NSString *)userId isFirstParytId:(BOOL)firstParytId;   
@end

Exemples d’utilisation

// iOS: ObjC to show a banner ad
#import "MyViewController.h"
#import "ANBannerAdView.h"
@interface MyViewController ()
@property (nonatomic, strong)  ANBannerAdView *banner;
@end
  
@implementation MyViewController
ANBannerAdView *banner = nil;
  
- (void) viewDidLoad
  
{
     
    // User Id from External Third Party Sources     
NSMutableArray<ANUserId *>  *userIdArray  = [[NSMutableArray<ANUserId *> alloc] init];
[userIdArray addObject:[[ANUserId alloc] initWithANUserIdSource:ANUserIdSourceNetId userId:@"userid-netid-foobar" ]];
[userIdArray addObject:[[ANUserId alloc] initWithANUserIdSource:ANUserIdSourceTheTradeDesk userId:@"userid-ttd-foobar" ]];
[userIdArray addObject:[[ANUserId alloc] initWithANUserIdSource:ANUserIdSourceUID2 userId:@"userid-uid2-foobar" ]];
[userIdArray addObject:[[ANUserId alloc] initWithANUserIdSource:ANUserIdSourceCriteo userId:@"userid-Criteo-foobar"]];
[userIdArray addObject:[[ANUserId alloc] initWithANUserIdSource:ANUserIdSourceLiveRamp userId:@"userid-liveramp-foobar" ]]; 
[userIdArray addObject:[[ANUserId alloc] initWithStringSource:@“Generic Source” userId:@“userid-generic-foobar” isFirstParytId:true]];    
ANSDKSettings.sharedInstance.userIdArray = userIdArray;
 
    // Publisher User Id
    ANSDKSettings.sharedInstance.publisherUserId = @"foobar-publisherfirstpartyid";      
        // IDFV as Publisher User Id
        ANSDKSettings.sharedInstance.disableIDFVUsage = NO;     
        // Load Banner Ad
    CGSize  size = CGSizeMake(300, 250); 
    // NOTE  Setting size is necessary only for fetching banner and video ad objects.
    // This field is ignored when the placement returns a native ad object.
    CGRect someRect = CGRectMake(...);
    // Create the banner ad view here, but wait until the delegate fires before displaying.
  
    self.banner = [ANBannerAdView adViewWithFrame:someRect placementId:@"13572468" adSize:size];
    //... Needed Setup
    // Load an ad!
    [self.banner loadAd];
  
}
  
@end