Cómo entender las funciones de los scripts inteligentes

Si la configuración se realiza de acuerdo con los requisitos del marketer, el script inteligente debe proporcionar una atribución precisa de la web hacia la aplicación. Sin embargo, el script se puede personalizar si el desarrollador necesita hacer cambios adicionales. Aquí encontrarás las diferentes propiedades y funciones de los scripts, junto con algunos ejemplos

Funciones de los scripts inteligentes

Establecer nivel de registro

Utiliza la función setLogLevel para establecer el nivel de registro en la consola de tu navegador, si es necesario. Llama esta función antes de llamar la función createLink. Los argumentos son debug, warn, error o none. El valor del nivel de registro predeterminado es debug.

AdjustSmartScript.setLogLevel('warn')

Crear link

Utiliza la función createLink para crear un link de Adjust con las propiedades de objeto de mapeo especificadas.

const mapping = { /* mapping object properties */ }
AdjustSmartScript.createLink(mapping)

Obtener versión del script

Utiliza la función getVersion para revisar la versión de los scripts inteligentes.

AdjustSmartScript.getVersion()

Cómo mapear las propiedades del objeto

Debes enviar un objeto mapping al método createLink. DEBES definir las siguientes propiedades en el objeto mapping.

defaultLinkToken (string)

el token del link que se debe utilizar cuando no haya ningún token del link de red aplicable o cuando no se haya proporcionado ninguna configuración de red.

campaign (object)

un objeto que contiene información sobre la campaña.

adgroup (object)

un objeto que contiene información sobre el grupo de anuncios.

creative (object)

un objeto que contiene información sobre el elemento creativo.

Los objetos campaign, adgroup y creative DEBEN contener la siguiente propiedad:

in (string | string[])

una cadena o una matriz de cadenas que sean claves de cadenas de consulta de búsqueda de URL que se deban utilizar como nombre de la campaña, el grupo de anuncios o el elemento creativo.

si se envía una matriz, el script busca los nombres entre los parámetros GET y envía todos a la función transform, si está presente. De lo contrario, el script escribe el primer valor que no esté vacío como nombre de la campaña, el grupo de anuncios o el elemento creativo.

También PUEDES proporcionar las siguientes propiedades:

transform (function)

una función llamada con el valor de in. Devuelve un valor de cadena que es el nombre final de la campaña, el grupo de anuncios o el elemento creativo. Si transform no devuelve una cadena, o si arroja un error, el script escribe el primer valor que no esté vacío como nombre de la campaña, el grupo de anuncios o el elemento creativo.

defaultValue (string)

se utiliza cuando la función transform no encuentra el valor de in.

Si implementaste el uso de deep links, DEBES definir los siguientes parámetros en el objeto mapping.

domain (string)

el dominio con marca.

puedes definir el dominio con marca si aún no implementas el uso de deep links. Si no se especifica ningún dominio, se crea un link app.adjust.com.

iosAppSchema (string)

el esquema de la aplicación de iOS.

androidAppSchema (string)

el esquema de la aplicación de Android.

Si implementaste el uso de deep links, PUEDES definir los siguientes parámetros.

iosDeeplinkPath (string)

la ruta del deep link de iOS.

androidDeeplinkPath (string)

la ruta del deep link de Android.

PUEDES definir los siguientes parámetros en el objeto mapping.

inputUrl (string)

la URL de la página de destino web móvil. Si no proporcionas ningún valor, el script utiliza el valor window.location.href como URL de la página actual.

label (object`) Este parámetro te permite enviar datos personalizados. Para obtener más información, consulta la documentación correspondiente en el Centro de ayuda.

networks (object)

un objeto de clave y valor que contiene información sobre la red.

El objeto networks DEBE contener al menos una clave que represente el nombre de una red. Las siguientes claves son compatibles:

• Meta
• google_ads

El valor DEBE ser un objeto que contenga la siguiente propiedad:

linkToken (string)

el token del link de la red definida en la clave.

customParameters (object)

un objeto que contiene información de parámetros personalizados.

El objeto customParameters DEBE contener la siguiente propiedad:

in (string | string[])

una cadena o una matriz de cadenas que sean claves de cadenas de consulta de búsqueda de URL que se deban utilizar como nombre personalizado.

si se envía una matriz, el script busca los nombres entre los parámetros GET y envía todos a la función transform, si está presente. De lo contrario, el script escribe el primer valor que no esté vacío como nombre personalizado.

out (string)

una cadena que especifica el nombre del parámetro personalizado que se debe escribir en el link de Adjust.

También PUEDES proporcionar las siguientes propiedades:

transform (function)

una función llamada con el valor de in. Devuelve un valor de cadena que es el nombre personalizado final. Si transform no devuelve una cadena, o si arroja un error, el primer valor que no esté vacío se escribe como nombre personalizado.

defaultValue (string)

se utiliza cuando la función transform no encuentra el valor de in.

Ejemplos

const mapping = {
  inputUrl: "https://www.landing.com?campaign_name=Summer2024&ad_group=SomeGroup",
  defaultLinkToken: "abcd123",
  campaign: { in: "campaign_name" },
  adgroup: { in: "ad_group" },
  creative: { in: "element" }
}
const link = AdjustSmartScript.createLink(mapping);
console.log(link)
// expected output: https://app.adjust.com/abcd123?campaign=Summer2024&adgroup=SomeGroup

const mapping = {
  defaultLinkToken: "abcd1234",
  networks: {
    meta: { linkToken: 'efgh5678'},
    google_ads: { linkToken: 'ijkl9012' }
  },
  campaign: { in: "c" },
  adgroup: { in: "a" },
  creative: { in: "cr" }
}
const link1 = AdjustSmartScript.createLink({
  ...mapping,
  inputUrl: "https://www.landing.com?c=Summer2024&a=SomeGroup&cr=banner&gclid=CLICK_ID"
});
console.log(link1)
// expected output: https://app.adjust.com/ijkl9012?gclid=CLICK_ID&campaign=Summer2024&adgroup=SomeGroup&creative=banner
const link2 = AdjustSmartScript.createLink({
  ...mapping,
  inputUrl: "https://www.landing.com?c=Winter2025&a=AnotherGroup&cr=image&fbclid=FB_CLICK_ID"
});
console.log(link2)
// expected output: https://app.adjust.com/efgh5678?fbclid=FB_CLICK_ID&campaign=Winter2025&adgroup=AnotherGroup&creative=image

const mapping = {
  inputUrl: "https://www.landing.com?utm_content=logo_image&utm_medium=social&utm_source=some-source&utm_campaign=new_campaign",
  defaultLinkToken: "example123",
  domain: "branded.go.link",
  campaign: {
    in: "utm_campaign",
    defaultValue: "dummy-name"
  },
  adgroup: {
    in: ["utm_source", "utm_medium"],
    transform: function(values) { return (values[0] && values[1]) ? `${values[0]}: ${values[1]}` : undefined; }
  },
  creative: {
    in: "utm_content",
    transform: function(values) { return values[0] ? `ad_${values[0]}` : 'ad_default' }
  }
}
const link = AdjustSmartScript.createLink(mapping);
console.log(link)
// expected output: https://branded.go.link?adj_token=example123&adj_campaign=new_campaign&adj_adgroup=some-source%3A%20social&adj_creative=ad_logo_image

const mapping = {
  inputUrl: "https://www.landing.com?user_id=id&cr=logo_image&ad=some_adset&c=new_campaign&product=my_product",
  domain: "example.go.link",
  defaultLinkToken: "abcd1234",
  campaign: { in: "c" },
  adgroup: { in: "ad" },
  creative: { in: "cr" },
  customParameters: [{
    in: ['product', 'user_id'],
    out: 'ref_code',
    transform: function (values) {
      const product = values[0]
      const userId = values[1]
      if (product && userId) {
        return `${userId}+${product}`
      }
      return ''
    }
  }]
}
const link = AdjustSmartScript.createLink(mapping);
console.log(link)
// expected output: https://example.go.link?adj_token=abcd1234&adj_campaign=new_campaign&adj_adgroup=some_adset&adj_creative=logo_image&ref_code=id%2Bmy_product

const mapping = {
  inputUrl: "https://www.landing.com?&cr=logo_image&ad=some_adset&c=new_campaign",
  domain: "example.go.link",
  defaultLinkToken: "abcd1234",
  campaign: { in: "c" },
  adgroup: { in: "ad" },
  creative: { in: "cr" },
  iosAppSchema: "app",
  iosDeeplinkPath: "path/to/screen",
}
const link = AdjustSmartScript.createLink(mapping);
console.log(link)
// expected output: https://example.go.link/path/to/screen?adjust_t=abcd1234&adj_campaign=new_campaign&adj_adgroup=some_adset&adj_creative=logo_image

const mapping = {
  inputUrl: "https://www.landing.com?&cr=logo_image&ad=some_adset&c=new_campaign",
  domain: "example.go.link",
  defaultLinkToken: "abcd1234",
  campaign: { in: "c" },
  adgroup: { in: "ad" },
  creative: { in: "cr" },
  androidAppSchema: "scheme",
  androidDeeplinkPath: "some/path",
}
const link = AdjustSmartScript.createLink(mapping);
console.log(link)
// expected output: https://example.go.link/some/path?adjust_t=abcd1234&adj_campaign=new_campaign&adj_adgroup=some_adset&adj_creative=logo_image

const mapping = {
  inputUrl: "https://www.landing.com?&cr=logo_image&ad=some_adset&c=new_campaign",
  domain: "example.go.link",
  defaultLinkToken: "abcd1234",
  campaign: { in: "c" },
  adgroup: { in: "ad" },
  creative: { in: "cr" },
  androidAppSchema: "scheme",
  androidDeeplinkPath: "some/path",
  iosAppSchema: "app",
  iosDeeplinkPath: "path/to/screen",
}
const link = AdjustSmartScript.createLink(mapping);
console.log(link)
// expected output: https://hello.go.link/path/to/screen?adjust_t=abcd1234&adjust_deeplink=scheme%3A%2F%2Fsome%2Fpath&adj_campaign=new_campaign&adj_adgroup=some_adset&adj_creative=logo_image

Cómo testear los scripts inteligentes

Los scripts inteligentes muestran los resultados de sus registros en la consola del navegador. Te recomendamos testear el funcionamiento del script con el mapeo especificado y asegurarte de que se generen los links correctos.

1. En tu navegador, dirígete a la consola de herramientas para desarrolladores.
2. Dirígete a la página web en la que tengas implementados los scripts inteligentes.
3. Si no ves ningún registro con el prefijo [adjust-smart-script], actualiza la página. Si aún no ves ningún registro, asegúrate de que se cumplan los siguientes requisitos:
   • Tu código no debe impedir la creación de registros al llamar las funciones AdjustSmartScript.setLogLevel('error') o AdjustSmartScript.setLogLevel('none').
   • Tu código debe llamar la función AdjustSmartScript.createLink(params).

Puedes testear diferentes casos de uso con diferentes valores de la propiedad inputUrl. Por ejemplo, si ejecutas una campaña de Meta y también esperas que los usuarios orgánicos visiten tu página de destino, puedes tener una URL con los parámetros de la campaña y de Meta, y otra URL sin ningún parámetro adicional.

Ejemplos de registros:

[adjust-smart-script]: No networks configured
[adjust-smart-script]: Use defaultLinkToken to create adjust link
[adjust-smart-script]: Found value for campaign is new_campaign
[adjust-smart-script]: Found value for adgroup is some_adset
[adjust-smart-script]: Found value for creative is logo_image
[adjust-smart-script]: Transformed value for ref_code is id+my_product
[adjust-smart-script]: Misconfigured deep link: no valid androidAppSchema provided