Show Menu
SUJETS×

Méthodes du module externe PhoneGap

Vous pouvez utiliser les méthodes du module externe PhoneGap iOS pour réaliser différentes tâches.
Dans les fichiers html pour lesquels vous voulez utiliser le suivi, ajoutez le code ci-après à la balise <head>  :
<script type="text/javascript" charset="utf-8" src="ADB_Helper.js"></script>

Méthodes de configuration

  • getPrivacyStatus
    Renvoie l’état de confidentialité pour l’utilisateur actuel. Vous trouverez ci-dessous les états disponibles :
    • ADB.optedIn  : les accès sont envoyés immédiatement.
    • ADB.optedOut , où les accès sont ignorés.
    • ADB.optUnknown Si la suite de rapports prend en charge l’horodatage, les accès sont enregistrés jusqu’à ce que l’état de confidentialité devienne « inclusion » (les accès sont envoyés) ou « exclusion » (les accès sont ignorés). Si la suite de rapports ne prend pas en charge l’horodatage, les accès sont ignorés jusqu’à ce que l’état de confidentialité soit défini sur « inclusion ». La valeur par défaut est définie dans le fichier ADBMobileConfig.json .
      • Voici l’exemple de code pour cette méthode :
        getPrivacyStatus(function (value){myTempVal = value;},function(){myTempVal = null;});
        
        
  • setPrivacyStatus
    Définit l’état de confidentialité pour l’utilisateur actuel sur status . Vous pouvez définir l’un des états suivants :
    • ADB.optedIn  : les accès sont envoyés immédiatement.
    • ADB.optedOut , où les accès sont ignorés.
    • ADB.optUnknown - Si la suite de rapports prend en charge l’horodatage, les accès sont enregistrés jusqu’à ce que l’état de confidentialité devienne « inclusion » (les accès sont envoyés) ou « exclusion » (les accès sont ignorés).
      Si la suite de rapports ne prend pas en charge l’horodatage, les accès sont ignorés jusqu’à ce que l’état de confidentialité soit défini sur « inclusion ».
    • Voici l’exemple de code pour cette méthode :
        ADB.setPrivacyStatus('ADB.optedIn'); 
      
      
  • getLifetimeValue
    Renvoie la valeur du cycle de vie de l’utilisateur actuel. La valeur par défaut est 0.
    • Voici l’exemple de code pour cette méthode :
      ADB.getLifetimeValue(function(value){myTempVal = value;},function(){myTempVal = null;});
      
      
  • setDebugLogging
    Active ( true ) ou désactive ( false ) l’affichage des informations de débogage. Par défaut, cette variable est définie sur false .
    • Voici l’exemple de code pour cette méthode :
      ADB.setDebugLogging(true);
      
      
  • getVersion
    Obtient la version de la bibliothèque.
    • Voici l’exemple de code pour cette méthode :
      ADB.getVersion(function(value){versionNum = value;},function(){versionNum=1.0;}); 
      
      
  • trackingIdentifier
    Renvoie l’identifiant visiteur généré automatiquement. Il s’agit d’un identifiant visiteur unique spécifique à une application généré au lancement initial de l’application, puis stocké et utilisé à partir de ce lancement. Cet identifiant est conservé d’une mise à niveau de l’application à l’autre, puis est supprimé à la désinstallation de l’application.
    Si votre application est mise à niveau du SDK Experience Cloud 3.x vers 4.x, l’identifiant visiteur précédent (personnalisé ou généré automatiquement) est récupéré et stocké en tant qu’identifiant utilisateur personnalisé (voir getUserIdentifier ci-dessous). Cela permet de conserver les données du visiteur entre les mises à niveau du SDK. Pour les nouvelles installations sur le SDK 4.x, l’identifiant de l’utilisateur a la valeur null et l’identifiant de suivi est utilisé.
    • Voici l’exemple de code pour cette méthode :
       ADB.trackingIdentifier(function(value){myTempVal = value;},function(){myTempVal = null;}); 
      
      
  • getUserIdentifier
    Renvoie l’identifiant d’utilisateur personnalisé si un identifiant personnalisé a été défini, puis renvoie la valeur null si aucun identifiant personnalisé n’a été défini. La valeur par défaut est null .
    • Voici l’exemple de code pour cette méthode :
      getUserIdentifier(function(value){myTempVal = value;},function(){myTempVal = null;}); 
      
      
  • setUserIdentifier
    Définit l’identifiant d’utilisateur sur identifier .
    • Voici l’exemple de code pour cette méthode :
      ADB.setUserIdentifier('testUser');
      
      
  • setPushIdentifier
    Définit le jeton d’appareil pour les notifications Push.
    • Voici la syntaxe de cette méthode :
      ADB.setPushIdentifier(pushIdentifier,success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.setPushIdentifier('test_push_identifier',function(value){alert('success');},function(value){alert('fail');
      
      
  • keepLifecycleSessionAlive
    Définit la préférence d’une session de cycle de vie persistante.
    L’appel de keepLifecycleSessionAlive empêche l’application de lancer une nouvelle session la prochaine fois qu’elle est reprise en arrière-plan. Utilisez cette méthode seulement si votre application est enregistrée pour les notifications en arrière-plan.
    • Voici l’exemple de code pour cette méthode :
      ADB.keepLifecycleSessionAlive();
      
      
  • trackingSendQueuedHits
    Force la bibliothèque à envoyer tous les accès mis en file d’attente, quelles que soient les options de lot en cours.
    • Voici l’exemple de code pour cette méthode :
      ADB.trackingSendQueuedHits();
      
      
  • trackingGetQueueSize
    Obtient ou définit le nombre d’appels de suivi stockés dans la file d’attente hors ligne.
    • Voici l’exemple de code pour cette méthode :
      ADB.trackingGetQueueSize(function(value){myTempVal = value;},function(){myTempVal = null;}); 
      
      
  • trackingClearQueue
    Supprime tous les appels de suivi stockés de la file d’attente hors ligne.
    faites attention lorsque vous effacez manuellement la file d’attente, car cette opération ne peut pas être annulée.
    • Voici l’exemple de code pour cette méthode :
      ADB.trackingClearQueue(function(value){myTempVal = value;},function(){myTempVal = null;}); 
      
      
  • keepLifecycleSessionAlive
    Indique au SDK que la prochaine reprise depuis l’arrière-plan ne doit pas commencer une nouvelle session, quelle que soit la valeur de temporisation de la session du cycle de vie dans le fichier de configuration.
    Important : Cette méthode est conçue pour les applications qui s’inscrivent aux notifications quand elles sont en arrière-plan et doit être appelée uniquement depuis votre code qui s’exécute pendant que votre application se trouve en arrière-plan.
    • Voici l’exemple de code pour cette méthode :
      ADB.keepLifecycleSessionAlive();
      
      
  • collectLifecycleData
    Indique au SDK que les données du cycle de vie doivent être collectées pour être utilisées à l’échelle de toutes les solutions dans le SDK. Pour en savoir plus, voir la section Mesures de cycle de vie .
    • Voici l’exemple de code pour cette méthode :
      ADB.collectLifecycleData(); 
      
      

Méthodes Pill

  • collectPII
    Envoie une demande de collecte PII.
    • Voici la syntaxe de cette méthode :
      ADB.collectPII(piiData,success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.collectPII({'k1':'v1','k2':'v2','k3':'v3'}, function (value) { alert('success'); },function (value) { alert('fail'); });
      
      

Méthodes de suivi

  • trackAdobeDeepLink
    Effectue le suivi d’un clic publicitaire de lien profond Adobe.
    Si l’appel du cycle de vie est un événement de lancement, les données de lien Adobe sont ajoutées ; sinon un appel supplémentaire est envoyé.
    • Voici la syntaxe de cette méthode :
      ADB.trackAdobeDeepLink(deeplinkURL,success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackAdobeDeepLink('xyz-deeplink-url',function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • trackPushMessageClickthrough
    Effectue le suivi d’un clic publicitaire de message push.
    • Voici la syntaxe de cette méthode :
      ADB.trackPushMessageClickthrough(userInfo,success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackPushMessageClickthrough({'k1':'v1','k2':'v2','k3':'v3'},function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • trackLocalNotificationClickThrough
    Effectue le suivi d’un clic publicitaire de message de notification locale.
    • Voici la syntaxe de cette méthode :
      ADB.trackLocalNotificationClickThrough(userInfo,success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackLocalNotificationClickThrough({'k1':'v1','k2':'v2','k3':'v3'},function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • trackState
    Contrôle l’état d’une application avec les données contextuelles facultatives. Les états sont les affichages disponibles dans l’application, par exemple home dashboard , app settings , cart , etc. Ces états sont semblables aux pages d’un site web ; les appels trackState incrémentent les pages vues. cData est un objet JSON doté de paires clé-valeur à envoyer dans les données contextuelles.
    • Voici la syntaxe de cette méthode :
      ADB.trackState(stringstateName[,JSONcData]); 
      
      
    • Voici des exemples de code pour cette méthode :
      ADB.trackState("loginpage");
      
      
        ADB.trackState("loginpage",{"user":"john","remember":"true"});
      
      
  • trackAction
    Effectue le suivi d’une action dans votre application. Les actions sont les événements qui se produisent dans votre application et que vous souhaitez mesurer, par exemple logins , banner taps , feed subscriptions et d’autres mesures.
    • Voici la syntaxe de cette méthode :
      ADB.trackAction(stringaction[,JSONcData]);
      
      
    • Voici des exemples de code pour cette méthode :
      ADB.trackAction("login");
      
      
      ADB.trackAction("login",{"user":"john","remember":"true"})
      
      
  • trackActionFromBackground
    Effectue le suivi d’une action survenue en arrière-plan. Ceci empêche les événements de cycle de vie de se déclencher dans certains scénarios.
    • Voici la syntaxe de cette méthode :
      ADB.trackActionFromBackground(stringaction[,JSONcData]); 
      
      
    • Voici des exemples de code pour cette méthode :
      ADB.trackActionFromBackground("login");
      
      
      ADB.trackActionFromBackground("login",{"user":"john","remember":"true"});
      
      
  • trackLocation
    Envoie les coordonnées x et y actuelles. Utilise en outre les points ciblés qui ont été définis dans le fichier ADBMobileConfig.json pour déterminer si l’emplacement fourni comme paramètre se trouve dans l’un de vos points ciblés. Si les coordonnées actuelles se trouvent dans un point ciblé défini, une variable de données contextuelle est renseignée et envoyée avec l’appel trackLocation .
    • Voici la syntaxe de cette méthode :
       ADB.trackLocation(x,y[,JSONcData]);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackLocation('40.431596','-111.893713');
      
      
  • trackLifetime​ValueIncrease
    Ajoute amount à la valeur de durée de vie de l’utilisateur.
    • Voici la syntaxe de cette méthode :
      ADB.trackLifetimeValueIncrease(amount[,JSONcData]);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackLifetimeValueIncrease('10.01');
      
      
  • trackTimed​ActionStart
    Commence une minutée portant le nom action action. Si vous appelez cette méthode pour une action qui a déjà commencé, l’action minutée précédente est écrasée.
    Cet appel n’envoie pas d’accès.
    • Voici la syntaxe de cette méthode :
      ADB.trackTimedActionStart(action[,JSONcData]);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackTimedActionStart("cartToCheckout"); 
      
      
  • trackTimed​ActionUpdate
    Transmet cData afin de mettre à jour les données contextuelles associées à l’ action donnée. Les cData (données) transmises sont ajoutées aux données existantes pour l’action donnée et remplacent les données si la même clé est déjà définie pour l’ action .
    Cet appel n’envoie pas d’accès.
    • Voici la syntaxe de cette méthode :
      ADB.trackTimedActionUpdate(Stringaction[,JSONcData]);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.trackTimedActionUpdate("cartToCheckout",{'SampleContextDataKey3':'SampleContextDataVal3','SampleContextDataKey4':'SampleContextDataVal4'}); 
      
      
  • trackTimed​ActionEnd
    Termine une action minutée.
    • Voici l’exemple de code pour cette méthode :
      ADB.trackTimedActionEnd("cartToCheckout");
      
      
  • trackingTimedActionExists
    Renvoie si une action minutée est ou non en cours.
    • Voici la syntaxe de cette méthode :
      ADB.trackingTimedActionExists(function(value){myTempVal = value;},function(){myTempVal = null;});
      
      

Méthodes Target

  • targetLoadRequest
    Envoie la demande à votre serveur Target configuré et renvoie la valeur de chaîne de l’offre.
    • Voici la syntaxe de cette méthode :
      ADB.targetLoadRequest(success,fail,name,defaultContent,parameters); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.targetLoadRequest(function (value)
      {myTempVal = value;},function() {myTempVal = null;},'bannerOffer','none',{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'}); 
      
      
  • targetLoadOrderConfirmRequest
    Envoie une demande au serveur Target configuré.
    • Voici la syntaxe de cette méthode :
      ADB.targetLoadOrderConfirmRequest(success,fail,name,orderId,orderTotal,productPurchaseId,parameters); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.targetLoadRequest(function(value){myTempVal=value;}
      ,function()
      {myTempVal = null; }
      ,'name','orderId','total','purchaseId'
      ,{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'}
      ); 
      
      
  • targetClearCookies
    Efface les cookies Target du stockage des cookies partagé.
    • Voici l’exemple de code pour cette méthode :
      ADB.targetClearCookies();
      
      
  • targetLoadRequestWithNameWithLocationParameters
    Traite une demande de service Target.
    • Voici la syntaxe de cette méthode :
      ADB.targetLoadRequestWithNameWithLocationParameters(success,fail,name,defaultContent,profileParameters,orderParameters,mboxParameters,requestLocationParameters
      ); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.targetLoadRequestWithNameWithLocationParameters(function(){alert('success');},function(){alert('fail');},'bannerOffer','none',{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'},{'hp':'hp_val_new','hp.company':'adobe','hp.val2':'hp_val2'}); 
      
      
  • targetLoadRequestWithName
    Traite une demande de service Target.
    • Voici la syntaxe de cette méthode :
      ADB.targetLoadRequestWithRequestName(success, fail, name, defaultContent, profileParameters, orderParameters, mboxParameters); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.targetLoadRequestWithName(
      function (value){ // handle target success} ,
      function() { // handle target failure }, 
      "mboxName",
      "defaultContent",
      {"profileParameters":"profileParametervalues"}
      {"orderId" : "32FGJ4XK" , "orderTotal" : "123.33" , "purchasedProductIds":"[46,34]" }
      {"mboxParameters":"mboxParametersvalues"}
      );
      
      
  • targetSessionID
    Obtient la valeur du cookie SessionID renvoyée pour ce visiteur par le serveur Target.
    • Voici la syntaxe de cette méthode :
      ADB.targetSessionID(success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
        ADB.targetSessionID(function(value){alert(value);},function(value){alert('fail');}); 
      
      
  • targetPcID
    Obtient la valeur du cookie PcID renvoyée pour ce visiteur par le serveur Target.
    • Voici la syntaxe de cette méthode :
      ADB.targetPcID(success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.targetPcID(function(value){alert(value);},function(value){alert('fail');});
      
      
  • targetSetThirdPartyID
    Définit l’identifiant visiteur personnalisé pour Target.
    • Voici la syntaxe de cette méthode :
      ADB.targetSetThirdPartyID(thirdPartyID,success,fail); 
      
      
    • Voici l’exemple de code pour ce groupe :
      ADB.targetSetThirdPartyID('test-third-party-id',function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • targetThirdPartyID
    Obtient l’identifiant visiteur personnalisé pour Target.
    • Voici la syntaxe de cette méthode :
      ADB.targetThirdPartyID(success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.targetThirdPartyID(function(value){alert(value);},function(value){alert('fail');}); 
      
      

Méthodes d’acquisition

  • acquisitionCampaignStartForApp
    Permet aux développeurs de lancer une campagne d’acquisition d’applications, comme si l’utilisateur avait cliqué sur un lien. Ceci s’avère utile pour créer des liens d’acquisition manuels et pour gérer vous-même les redirections de boutiques d’applications (comme avec un SKStoreView ).
    • Voici la syntaxe de cette méthode :
      ADB.acquisitionCampaignStartForApp(appId,data,success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.acquisitionCampaignStartForApp('0652024f-adcd-49f9-9bd7-2552a4564d2f',{'extraDataKey':'extraDataValue'},success,fail); 
      
      

Identifiant de publicité

Dans l’ AppDelegate généré par Cordova, appelez [ADBMobile setAdvertisingIdentifier:] dans la méthode déléguée application:didFinishLaunchingWithOptions: . Pour plus d’informations, voir Méthodes de configuration .

Méthodes Audience Manager

  • audienceGetVisitorProfile
    Obtient le profil du visiteur.
    • Voici la syntaxe de cette méthode :
      ADB.audienceGetVisitorProfile();
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.audienceGetVisitorProfile(function(value){profile = value;},function(){profile = null;}); 
      
      
  • audienceGetDpuuid
    Renvoie le DPUUID.
    • Voici la syntaxe de cette méthode :
      ADB.audienceGetDpuuid(success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
       ADB.audienceGetDpuuid(function(value){dpuuid=value;},function(){dpuuid=null;}); 
      
      
  • audienceGetDpid
    Renvoie le DPID.
    • Voici la syntaxe de cette méthode :
       ADB.audienceGetDpid(success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.audienceGetDpid(function(value){dpid = value;},function(){dpid = null;}); 
      
      
  • audienceSetDpidAndDpuuid
    Définit les DPID et DPUUID.
    • Voici la syntaxe de cette méthode :
      ADB.audienceSetDpidAndDpuuid(dpid,dpuuid,success,fail);
      
      
    • Voici des exemples de code pour cette méthode :
      ADB.audienceSetDpidAndDpuuid(‘dpid’,‘dpuuid’,function(){…},function(){…});
      
      
      ADB.audienceSetDpidAndDpuuid(‘dpid’,‘dpuuid’);
      
      
  • audienceSignalWithData
    Traite une demande de service Audience Manager.
    • Voici la syntaxe de cette méthode :
      ADB.audienceSignalWithData(success,fail,data);
      
      
    • Voici des exemples de code pour cette méthode :
      ADB.audienceSignalWithData(function(){},function(){},{‘key1’:’value1’,‘key2’:‘value2’});
      
      
      ADB.audienceSignalWithData({‘key1’:’value1’,‘key2’:‘value2’}); 
      
      
  • audienceReset
    Réinitialise l’UUID du gestionnaire d’audience et purge le profil du visiteur en cours.
    • Voici l’exemple de code pour cette méthode :
      ADB.audienceReset(); 
      
      

Méthodes du service d’identification

  • visitorGetMarketingCloudId
    Renvoie l’Experience Cloud ID du service d’identification.
    • Voici la syntaxe de cette méthode :
      ADB.visitorGetMarketingCloudId(success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.visitorGetMarketingCloudId(function(value){mcid=value;},function(){mcid=null;}); 
      
      
  • visitorSyncIdentifiers
    Synchronise les identifiants fournis avec le service d’identification.
    • Voici la syntaxe de cette méthode :
      ADB.visitorSyncIdentifiers(identifiers,success,fail);
      
      
    • Voici des exemples de code pour cette méthode :
      ADB.visitorSyncIdentifiers({‘key_id_1’:’value_id_1’},function(){…},function(){…})) 
      
      
      ADB.visitorSyncIdentifiers({‘key_id_1’:‘value_id_1’});
      
      
  • visitorSyncIdentifiersWithAuthenticationState
    Synchronise les identifiants fournis avec le service d’identification des visiteurs.
    • Voici la syntaxe de cette méthode :
      ADB.visitorSyncIdentifiersWithAuthenticationState(identifiers,authenticationState,success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.visitorSyncIdentifiersWithAuthenticationState({'k1':'v1','k2':'v2','k3':'v3'},ADB.mobileVisitorAuthenticationStateAuthenticated,function(value){alert('success');},function(value){alert('fail');});
      
      
  • visitorSyncIdentifierWithType
    Synchronise l’identifiant fourni avec le service d’identification des visiteurs.
    • Voici la syntaxe de cette méthode :
      ADB.visitorSyncIdentifierWithType(identifierType,identifier,authenticationState,success,fail); 
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.visitorSyncIdentifierWithType('test-identifier-type','test-identifier',ADB.mobileVisitorAuthenticationStateAuthenticated,function(value){alert('success');},function(value){alert('fail');}); 
      
      
  • visitorAppendToURL
    Ajoute les identifiants visiteur à l’URL donnée.
    • Voici la syntaxe de cette méthode :
      ADB.visitorAppendToURL(urlToAppend,success,fail);
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.visitorAppendToURL('test_visitor_url',function(value){alert(value);},'');
      
      
  • visitorGetIDs
    Renvoie tous les visitorIDs qui ont été synchronisés.
    • Voici la syntaxe de cette méthode :
      ADB.visitorGetIDs(success,fail)
      
      
    • Voici l’exemple de code pour cette méthode :
      ADB.visitorGetIDs(function(value){alert(value);},function(value){alert('fail');});