La importación de conversiones sin conexión (OCI) realiza un seguimiento de las conversiones sin conexión de las importaciones con el GCLID. En los casos en que el GCLID no está disponible, los usuarios de OCI pueden usar otros identificadores, como los datos proporcionados por el usuario con codificación hash, wbraid/gbraid o session_attributes.
En esta página, encontrarás lo siguiente:
Acerca de session_attributes
session_attributes es un campo que proporciona más contexto y más indicadores sobre las interacciones de los usuarios con tu sitio web, lo que puede mejorar la medición de conversiones, los informes (incluido el desglose de uno o varios dispositivos) y la precisión de las ofertas. Puedes usar nuestra secuencia de comandos del frontend que aparece a continuación para crear la cadena codificada en base64 de session_attributes, pasarla a tu base de datos o CRM y enviarla a Google en tus importaciones de API. Si no puedes usar la secuencia de comandos del frontend, usa el campo session_attributes_key_value_pairs para enviar cada par clave-valor individualmente.
Te recomendamos que envíes todos los siguientes subcampos del campo session_attributes, aunque solo 4 de los 6 son obligatorios:
gad_source(obligatorio): Es un parámetro agregado que se publica en la URL para identificar la fuente del tráfico que proviene de los anuncios. Obtén más información sobre los parámetros de URL gad_*.gad_campaignid(obligatorio): Es el ID de la campaña publicitaria específica que generó el clic en el anuncio. Obtén más información sobre los parámetros de URL gad_*.session_start_time_usec(obligatorio): Es la marca de tiempo de cuándo comenzó la sesión del usuario en tu sitio web. Esto ayuda a hacer un seguimiento de la duración de las visitas de los usuarios. Es importante usar un formato de hora coherente en microsegundos de época de marca de tiempo UNIX.landing_page_user_agent(obligatorio): Es una cadena que identifica el navegador y el sistema operativo del usuario. Esta información puede ser útil para comprender el entorno técnico de tus usuarios.landing_page_url: Es la URL completa de la página de destino de tu sitio web. Indica la página específica a la que llegó el usuario por primera vez.landing_page_referrer: Es la URL de la página web que vinculó al usuario a tu sitio web. Esto te permite comprender las fuentes de tráfico que dirigen a los usuarios a tu sitio. Para obtener más información sobre las URLs de referencia, consulta este artículo. Si bien el artículo se enfoca en Analytics, el concepto de URL de referencia es universal en la Web.
El tamaño de almacenamiento recomendado para el campo session_attributes es de 5 KB, un límite que no se superará en la mayoría de los casos de uso. Si session_attributes supera los 5 KB, te recomendamos que trabajes con tu proveedor de CRM para modificar el tamaño del campo. También puedes quitar los parámetros landing_page_url y landing_page_referrer de la función auxiliar de JavaScript.
Cómo capturar session_attributes
Puedes usar la función auxiliar de JavaScript y el formulario HTML que se muestra a continuación en tu página de destino para capturar y conservar session_attributes.
Este código de ejemplo conserva los datos en localStorage. Antes de la implementación en tu sitio web, asegúrate de cumplir con los requisitos de consentimiento y retención de datos específicos de tu sitio web según sea necesario.
Formulario HTML
- Debes modificar cada página de envío de formulario para agregar un campo oculto para
session_attributes. Así es como se pasará el camposession_attributesa tu sistema de backend. A continuación, aparece un código de muestra para ilustrar esto.<form action="" name="myForm">
Nombre: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form> - Secuencia de comandos de muestra para capturar
session_attributes_encodedy configurarlo en el campo del formulario. Este código de ejemplo conserva los datos en localStorage.<script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}
function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>
Cómo enviar los datos a Google Ads
1. Campo session_attributes_encoded en la API de Google Ads
En el caso de los usuarios existentes de la importación de conversiones sin conexión (OCI) que utilizan JavaScript, para enviar estos datos, configura el campo session_attributes codificado que se capturó a partir del código JavaScript proporcionado en un campo nuevo llamado ClickConversion.session_attributes_encoded en tu esquema de carga existente. Luego, continúa usando tu proceso de OCI actual, pero establece este campo nuevo cuando realices importaciones. Google Ads usará session_attributes cuando no estén presentes tus otros identificadores.
Todos los usuarios nuevos deben usar la API de Data Manager. Si una cuenta no se incluyó en la lista de entidades permitidas para transmitir direcciones IP o atributos de sesión a través de la API de Google Ads, recibirás un mensaje de error para esas conversiones.
Avanzado
Si no puedes usar JavaScript, puedes capturar los pares clave-valor individuales y enviarlos con tus importaciones de conversiones sin conexión.
En el caso de los usuarios existentes de la importación de conversiones sin conexión (OCI) que no utilizan JavaScript, también puedes configurar el campo de par clave-valor llamado ClickConversion.session_attributes_key_value_pairs en tu esquema de carga existente. Te sugerimos que envíes pares clave-valor con estos campos cuando llames a la API. Consulta la documentación para desarrolladores en la que se explica cómo agregar pares clave-valor individuales a un campo ClickConversion.
Puedes revisar las siguientes recomendaciones y actualizar tu implementación para asegurarte de que se envíen datos válidos:
gad_campaignid (ID de campaña): Asegúrate de enviar siempre el ID de campaña de Google Ads válido asociado al clic en el anuncio. Es el ID de la campaña que se completa en la URL de clic en el anuncio como “gad_campaignid=1234”. Este es un atributo principal y fundamental para una atribución precisa.session_start_time_usec: Asegúrate de enviar el atributo de forma coherente (la marca de tiempo en la que comenzó la sesión del usuario).landing_page_url (URL): Asegúrate de enviar la URL completa y precisa de la página de destino. No envíes cadenas de marcador de posición, rutas de acceso internas de la aplicación ni URLs incompletas.- Nota: Si no está disponible la URL completa y precisa, se recomienda quitar todo el campo, ya que los datos incorrectos pueden afectar negativamente el modelado.
landing_page_user_agent (usuario agente): Asegúrate de que la cadena refleje con precisión el navegador y el sistema operativo del usuario, y evita enviar valores genéricos o codificados.
2. Campo session_attributes con el Administrador de datos
También puedes enviar el campo session_attributes con el Administrador de datos.
- IU del Administrador de datos: Usa el código JavaScript proporcionado para crear el campo
session_attributesy subirlo a través de la IU del Administrador de datos. - API de Data Manager: Puedes realizar la integración con la API de Data Manager para subir tus datos de forma programática. Consulta la documentación del Administrador de datos para obtener instrucciones específicas y detalles del esquema.
Si envías los datos correctos, Google Ads podrá usar esta información para atribuir las conversiones a las campañas adecuadas y proporcionarte un registro de conversiones más completo.