Resumen
Los consumidores de la API que aprovechan la API de remarketing y el seguimiento de conversiones de aplicaciones de Google Ads para pasar directamente las conversiones de aplicaciones deben seguir las siguientes orientaciones para Android y iOS. Esto garantizará que los clics de los usuarios que rechacen el seguimiento de anuncios o la personalización de anuncios solo se atribuyan con flujos de trabajo que cumplan con la privacidad. Consulta la Descripción general de las Especificaciones de Solicitud y Respuesta para obtener información adicional sobre las definiciones de parámetros y los valores esperados.
Aplicaciones de Android
Alcance
Instalaciones y participación en la aplicación a través de todas las campañas de Google Ads
Fondo
Actualmente, los usuarios de Android que inhabilitaron la personalización de anuncios no se pueden rastrear con el ID de publicidad de Android (según la política de Google). En cambio, Google utiliza el parámetro gclid
, una URL de clic que no persiste con el dispositivo. Además, Google puede usar el parámetro de URL de clic agregado gbraid en otros casos en los que no se haya otorgado el consentimiento a nivel del usuario.
Orientación
Los consumidores de la API de seguimiento de conversiones de aplicación y remarketing deben asegurarse de que los parámetros gclid
y gbraid
se almacenen y pasen correctamente.
Situaciones admitidas
Situación admitida: Instalación (el usuario no instaló la app anteriormente)
Cuando una instalación de la app se genera a partir de un vínculo directo que redirecciona a Google Play Store y el usuario abre la app por primera vez, analiza el valor de gclid
del campo install_referrer
de la API de Play Install Referrer y almacénalo en el dispositivo o en el servidor con una clave basada en un identificador propio.
Cada valor debe almacenarse durante 180 días o hasta que se reemplace por otro valor más reciente.
El valor de gclid
se debe pasar a través del campo de solicitud de conversión market_referrer_gclid
.
El ID de publicidad está disponible
Cuando el ID de publicidad de Android está disponible, se requiere que se envíe market_referrer_gclid
con el evento first_open correspondiente y TODOS los eventos de la app y las sesiones posteriores (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera).
Ejemplo: First Open
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=first_open &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Ejemplo: Eventos de sesión y de aplicación
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
El ID de publicidad NO está disponible
Cuando el ID de publicidad de Android NO está disponible, se requiere enviar el market_referrer_gclid
con el evento first_open
correspondiente y TODAS las sesiones y los eventos de la app posteriores (es decir, session_start
, add_to_cart
, in_app_purchase
, etc.), junto con el campo o valor adicional gclid_only_request=1
. Nota: El valor de rdid
debe ser todo ceros (ya que el usuario no dio su consentimiento).
Ejemplo: First Open
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=first_open &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1
Ejemplo: Eventos de sesión y de aplicación
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1
Situación admitida: Participación en la aplicación (el usuario ya instaló la aplicación)
Cuando una sesión de la app se basa en un vínculo directo, analiza los valores de gclid
y gbraid
de la URL de referencia y almacénalos en el dispositivo o en el servidor con una clave basada en un identificador propio.
Cada valor debe almacenarse durante 180 días o hasta que se reemplace por otro valor más reciente.
El valor del vínculo directo gclid
se debe pasar a través del campo de solicitud de conversión gclid
, y el valor del vínculo directo gbraid
se debe pasar a través del campo de solicitud de conversión gbraid
.
El ID de publicidad está disponible
Cuando el ID de publicidad de Android está disponible, se deben enviar gclid
y gbraid
con el evento session_start
correspondiente y TODOS los eventos de la app y las sesiones posteriores (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera).
Ejemplo: Sesión de vínculo directo
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Eventos de aplicaciones
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Sesión orgánica o posterior
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456&gclid=Cj0KEQjw0dy4BRCuuL_e5M&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
El ID de publicidad NO está disponible
Cuando el ID de publicidad de Android NO está disponible, se debe enviar gclid
con el evento session_start
correspondiente y TODAS las sesiones posteriores y los eventos de la app (es decir, session_start
, add_to_cart
, in_app_purchase
, etc.). Nota: El valor de rdid debe ser todo ceros (ya que el usuario inhabilitó la personalización de anuncios).
Ejemplo: Sesión de vínculo directo
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gclid_only_request=1 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Eventos de aplicaciones
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gclid_only_request=1 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Sesión orgánica o posterior
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gclid_only_request=1 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Situación admitida: Instalación y participación
Cuando una instalación de la app se genera a partir de un vínculo directo a Google Play Store, seguido de una sesión de la app generada a partir de un vínculo directo a la app, analiza el valor de gclid del campo install_referrer de la API de Play Install Referrer y los valores de gclid
y gbraid
de la URL de referencia, y almacénalos en el dispositivo o en el servidor con una clave de identificador de origen.
Cada valor debe almacenarse durante 180 días o hasta que se reemplace por otro valor más reciente.
Luego, el valor de referencia de instalación gclid
se debe pasar a través del campo de solicitud de conversión market_referrer_gclid
, el valor de vínculo directo gclid
se debe pasar a través del campo de solicitud de conversión gclid
y el valor de vínculo directo gbraid
se debe pasar a través del campo de solicitud de conversión gbraid
.
El ID de publicidad está disponible
Cuando el ID de publicidad de Android está disponible, se deben enviar market_referrer_gclid
Y gclid
con el evento session_start
correspondiente y los eventos de la app (es decir, add_to_cart
, in_app_purchase
, etcétera). Para los eventos session_start posteriores, pasa market_referrer_gclid
, pero NO se debe pasar gclid
(vínculo directo).
Ejemplo: Sesión de vínculo directo
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Eventos de aplicaciones
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Sesión orgánica o posterior
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=advertisingid &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 <&gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
El ID de publicidad NO está disponible
Cuando el ID de publicidad de Android NO está disponible, se deben enviar market_referrer_gclid
Y gclid
con el evento session_start
correspondiente, y TODOS los eventos de sesión y de aplicación posteriores (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera). Nota: El valor de rdid
debe ser todo ceros (ya que el usuario inhabilitó la personalización de anuncios).
Ejemplo: Sesión de vínculo directo
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Eventos de aplicaciones
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Sesión orgánica o posterior
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid_only_request=1 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Aplicaciones de iOS
Alcance
Participación en la aplicación a través de la Búsqueda, Shopping y las ACi de iOS de Google Ads, además de vínculos directos
Fondo
No se puede hacer un seguimiento de los usuarios de iOS 14.5 y versiones posteriores que no habilitaron el seguimiento de aplicaciones con el IDFA (según la política de ATT de Apple). En cambio, Google utiliza gbraid
, un parámetro de URL de clic agregado. Además, Google puede utilizar el gbraid
en otras situaciones en las que no se haya otorgado el consentimiento a nivel del usuario.
Orientación
Los consumidores de la API de Seguimiento de conversiones y Remarketing en aplicaciones deben asegurarse de que todos los parámetros de clics se pasen correctamente, incluidos gclid
y gbraid
.
Situaciones admitidas
Situación admitida: Participación en la aplicación (el usuario ya instaló la aplicación)
Cuando una sesión de la app se genera a partir de un vínculo directo, analiza los valores de gclid
y gbraid
de la URL de referencia y almacénalos en el dispositivo o en el servidor con una clave basada en un identificador de origen.
Cada valor debe almacenarse durante 180 días o hasta que se reemplace por otro valor más reciente.
El valor de gclid
se debe pasar a través del campo de solicitud de conversión gclid
, y el valor de gbraid
se debe pasar a través del campo de solicitud de conversión gbraid
.
El IDFA está disponible
Cuando el IDFA está disponible, se deben enviar gclid
Y gbraid
con el evento session_start correspondiente, junto con el campo o valor adicional app_open_source=ad_click
. También se deben enviar gclid
y gbraid
con las sesiones de transmisión descendente y los eventos de la app (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera). Para las sesiones posteriores, incluye el campo y el valor adicionales, app_open_source=organic
.
Ejemplo: Sesión de vínculo directo
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O &app_open_source=ad_click
Ejemplo: Evento de aplicación
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Sesión orgánica o posterior
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &eea=0 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O &app_open_source=organic
El IDFA NO está disponible
Cuando el IDFA NO está disponible, el gbraid
debe enviarse con el evento session_start
correspondiente junto con el campo o valor adicional, app_open_source=ad_click
. y TODOS los eventos de la app posteriores (es decir, add_to_cart
, in_app_purchase
, etc.). Nota: Se debe omitir el campo gclid
y el valor de rdid
debe ser todo ceros (ya que el usuario no dio su consentimiento).
El parámetro gbraid
TAMBIÉN se debe enviar con las sesiones de nivel inferior y los eventos de la app correspondientes (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera). Para las sesiones posteriores, incluye el campo y el valor adicionales app_open_source=organic
.
Ejemplo: Sesión de vínculo directo
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=idfa &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O &app_open_source=ad_click
Ejemplo: Evento de aplicación
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=idfa &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Ejemplo: Sesión orgánica o posterior
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=idfa &eea=0 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O &app_open_source=organic