Crear una URL de clic directo

🚧

Este método requiere v2.4.0 o superior

📘

Este método es una extensión de Smart Script

Asegúrate de leer la implementación y los argumentos de Smart Script.

Resumen General

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.

Argumentos

Argumento Observaciones Ejemplo

afParameters

(obligatorio)

 

 

 


mediaSource

(obligatorio)

Objeto de configuración para la fuente de medios

  • Claves: ['incoming_mediasource’' 'utm_source']
  • Valores a sobrescribir: {twitter: 'twitter_int', orig_src: 'new_src'}
  • Valor predeterminado: ['any_source']

campaign

Objeto de configuración para la campaña

  • Claves: ['incoming_campaign', 'utm_campaign']
  • Valores a sobrescribir: {campaign_name: 'new_campaign_name'}
  • Valor predeterminado: ['any_campaign_name']

channel

Objeto de configuración para el canal

  • Claves: ['incoming_channel', 'utm_channel']
  • Valores a sobrescribir: {video: 'new_video'}
  • Valor predeterminado: ['any_video']

ad

Objeto de configuración para el anuncio

  • Claves: ['incoming_ad', 'utm_ad']
  • Valores a sobrescribir: {ad_name: 'new_ad_name'}
  • Valor predeterminado: ['any_ad_name']
adSet

Objeto de configuración para conjunto de anuncios

  • Claves: ['incoming_adset', 'utm_adset']
  • Valores a sobrescribir: {'adset_name': 'new_adset_name'}
  • Valor predeterminado: ['any_adset_name']
Otros parámetros de consulta (personalizados)
  • Lista de cualquier otro parámetro que desees incluir en la URL de OneLink saliente para atribución o enlaces profundos, junto con sus objetos de configuración.
  • El desarrollador enumera el nombre del parámetro personalizado como paramKey en el objeto de configuración.
  • paramKey: 'deep_link_sub1'
  • Claves: ['page_id']
  • Valores a sobrescribir: {page12: 'new_page12'}
  • Valor predeterminado: 'page1'
platform Una cadena describe la plataforma. DEBE ser de esta lista:
  • smartcast
  • tizen
  • Roku
  • webos
  • Vidaa
  • PlayStation
  • Android
  • iOS
  • Steam
  • quest
  • battlenet
  • nativepc
  • epic
  • switch
  • "steam"
    app_id ID de aplicación "123456"
    redirectURL La URL a la que se redirigirá al usuario "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.

    Ejemplo de código para un juego de 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;            
    }
    

    Consulta un ejemplo de la conversión de una URL entrante a una URL de clic directa saliente para un juego de Steam.