Création d'une URL de clic direct

🚧

Cette méthode requiert la version 2.4.0 et +.

📘

Cette méthode est une extension de Smart Script

Veuillez consulter les arguments de l'implémentation de Smart Script.

Vue d'ensemble

This method provides support for creating a click URLs, to be used mainly by non mobile platforms (e.g. Steam, CTVs etc). When the click is matched to an installation, an attribution will be noted.

Arguments

Argument Remarques Exemple

afParameters

(requis)

 

 

 


mediaSource

(requis)

Objet de configuration pour la source média

  • Clés : ['incoming_mediasource'' 'utm_source']
  • Remplacer les valeurs : {title: 'twitter_int', orig_src: 'new_src'}
  • Valeur par défaut : ['any_source']

campaign

Objet de configuration pour la campagne

  • Clés : ['incoming_campaign', 'utm_campaign']
  • Remplacer les valeurs : {campaign_name: 'new_campaign_name'}
  • Valeur par défaut : ['any_campaign_name']

channel

Objet de configuration pour le canal

  • Clés : ['incoming_channel', 'utm_channel']
  • Remplacer les valeurs : {video: 'new_video'}
  • Valeur par défaut : ['any_video']

ad

Objet de configuration pour la publicité

  • Clés : ['incoming_ad', 'utm_ad']
  • Remplacer les valeurs : {nom_ad : 'nouveau_nom_ad'}
  • Valeur par défaut : ['any_ad_name']
adSet

Objet de configuration pour l'adset

  • Clés  :: ['incoming_adset', 'utm_adset']
  • Remplacer les valeurs : {'adset_name': 'new_adset_name'}
  • Valeur par défaut : ['any_adset_name']
Autres paramètres de requête (personnalisés)
  • Listez tous les autres paramètres que vous souhaitez inclure dans l'URL OneLink sortante pour l'attribution ou le deep linking, avec leurs objets de configuration.
  • Le nom du paramètre personnalisé est répertorié par le développeur en tant que paramKey dans l'objet de configuration.
  • paramKey: 'deep_link_sub1'
  • Clés : ['page_id']
  • Remplacer les valeurs : {page12 : 'new_page12'}
  • Valeur par défaut : "page1".
platform Une chaîne qui décrit la plateforme. DOIT OBLIGATOIREMENT figurer dans cette liste :
  • smartcast
  • tizen
  • Roku
  • webos
  • Vidaa
  • PlayStation
  • Android
  • iOS
  • Steam
  • quest
  • battlenet
  • nativepc
  • epic
  • switch
  • "steam"
    app_id ID de l'app "123456"
    redirectURL L'URL où l'utilisateur sera redirigé "https://store.steampowered.com/app/123456/Team_Fortress_2/"

    Game landing page demo

    You can find here a fully functional demo landing page which demonstrates integrating the generateDirectClickURL Smart Script code.

    Exemple de code pour un jeu sur Steam

    //Initializing Smart Script arguments
    // If a media source key is NOT FOUND on the link and NO default value is found, the script will return a null string 
    var mediaSource = {keys: ["my_media_source"], defaultValue: "my_default_media_source"};
    var campaign = {keys: ["my_campaign"], defaultValue: "my_default_campaign"};
    
    //Calling the function after embedding the code will be through a global parameter on the window object called window.AF_SMART_SCRIPT
    //Onelink URL is generated
    
    var result = window.AF_SMART_SCRIPT.generateDirectClickURL({
      afParameters:{
        mediaSource: mediaSource,
        campaign: campaign
      },
      platform: 'steam',
      app_id: '123456',
      redirectURL:'https://store.steampowered.com/app/123456/Team_Fortress_2/'
    })
    
    var result_url = "No output from script"
    if (result) {
      result_url = result.clickURL;            
    }
    

    Voir un exemple montrant la conversion d'une URL entrante en URL de clic direct sortante pour un jeu sur Steam.