Resumen
Los usuarios de API que aprovechan el seguimiento de conversiones de aplicaciones y la API de remarketing de Google Ads para pasar directamente las conversiones de aplicación deben seguir las siguientes instrucciones para Android y iOS. Esto garantizará que los clics de los usuarios que rechazan el seguimiento o la personalización de anuncios solo se atribuyan mediante flujos de trabajo que cumplan con la privacidad. Consulta la Descripción general de las especificaciones de respuestas y solicitudes para obtener información adicional sobre las definiciones de parámetros y los valores esperados.
Aplicaciones de Android
Alcance
Instalación de aplicación y participación en la aplicación a través de todas las campañas de Google Ads
Información general
Actualmente, no se puede realizar un seguimiento de los usuarios de Android que inhabilitaron la personalización de anuncios con el ID de publicidad de Android (según la política de Google). En cambio, Google utiliza gclid
, un parámetro de URL de clic que no persiste con el dispositivo.
Orientación
Los consumidores del Seguimiento de conversiones de aplicaciones y de la API de remarketing
deben asegurarse de que gclid
se almacene y se apruebe correctamente.
Situaciones admitidas
Situación compatible: Instalación (el usuario no instaló la aplicación anteriormente)
Cuando una instalación de app está controlada por un vínculo directo que redirecciona a Google Play Store y el usuario abre la app por primera vez, analiza el valor gclid
del campo API de referencia de instalación de Play install_referrer
y guárdalo en el dispositivo o en el servidor con clave de un identificador propio. Este gclid
debe almacenarse durante 180 días o hasta que otro referente de instalación de Play más reciente lo reemplace.Este gclid
puede pasarse a través del campo de solicitud de conversión market_referrer_gclid
.
El ID de publicidad está disponible
Cuando Android Advertising ID está disponible, se debe enviar market_referrer_gclid
con el evento first_open correspondiente. El market_referrer_gclid
se puede enviar con sesiones descendentes y eventos de la app (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera).
Ejemplo: Primer acceso
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 &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: Sesión y 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 &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 ID de publicidad de Android NO está disponible, se requiere que market_referrer_gclid
se envíe con el evento first_open
correspondiente y con TODOS los eventos de aplicación y eventos descendentes (es decir, session_start
, add_to_cart
, in_app_purchase
, etc.), junto con un campo/valor adicional, gclid_only_request=1
. Nota: El valor rdid
debe ser ceros (ya que el usuario no dio su consentimiento).
Ejemplo: Primer acceso
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 &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: Sesión y eventos de la 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 &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 compatible: participación en la aplicación (el usuario ya instaló la aplicación)
Cuando una sesión de app se controla mediante un vínculo directo, analiza el valor gclid
y guárdalo en el dispositivo o en el servidor con clave de un identificador propio.
El gclid
debe almacenarse durante 180 días o hasta que otro gclid
más reciente lo reemplace. Este valor se puede pasar mediante el campo de solicitud de conversión gclid
.
El ID de publicidad está disponible
Cuando el ID de publicidad de Android está disponible, se debe enviar el gclid
con el evento session_start
correspondiente. El gclid
se puede enviar con eventos de la app (es decir, add_to_cart
, in_app_purchase
, etc.). gclid
NO debe pasarse con eventos session_start
descendentes.
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 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M
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 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M
Ejemplo: Sesión orgánica 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 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456&gclid=Cj0KEQjw0dy4BRCuuL_e5M
El ID de publicidad NO está disponible
Cuando ID de publicidad de Android NO está disponible, se debe enviar gclid
con el evento session_start
correspondiente y con TODAS las sesiones y los eventos de app descendentes (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera). Nota: El valor de rdid debe ser cero (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 &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
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 &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
Ejemplo: Sesión orgánica 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 &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
Situación admitida: instalación y participación
Cuando una instalación de app es controlada por un vínculo directo a Google Play Store, seguido de una sesión de app impulsada por un vínculo directo a la app, analiza los valores de la gclid
de la API de referencia de instalación de Play y los de vínculo directo gclid
y almacénalos en el dispositivo o en el servidor con clave de un identificador propio. Estos valores de gclid
deben almacenarse durante 180 días, o hasta que otro gclid
de vínculo directo más reciente reemplace al vínculo directo gclid
existente o hasta que una API de referencia de instalación de Play gclid
reemplace a la de gclid
de referencia de instalación de Play existente. La gclid
de la API de referencia de instalación de Play se debe pasar a través del market_referrer_gclid field
, Y el vínculo directo gclid
se debe pasar a través del campo gclid
.
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 con eventos de la app (es decir, add_to_cart
, in_app_purchase
, etc.). Para los eventos session_start descendentes, pasa el market_referrer_gclid
, pero NO se debe pasar el 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 &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
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 &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
Ejemplo: Sesión orgánica 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 &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
El ID de publicidad NO está disponible
Cuando 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 descendentes (es decir, session_start
, add_to_cart
, in_app_purchase
, etc.). Nota: El valor de rdid
debe ser cero (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 &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
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 &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
Ejemplo: Sesión orgánica 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 &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
Aplicaciones de iOS
Alcance
Interacción de la aplicación a través de la Búsqueda de Google Ads, Shopping y ACi de iOS + vínculos directos
Información general
No se puede realizar un seguimiento de los usuarios de iOS 14.5+ que no hayan habilitado el seguimiento de apps mediante el IDFA (según la política ATT de Apple). En cambio, Google utiliza gbraid
, un parámetro de URL de clic agregado.
Orientación
Los consumidores del Seguimiento de conversiones de aplicaciones y de la API de remarketing deben asegurarse de que todos los parámetros de clics se pasen correctamente, incluidos gclid
y gbraid
.
Situaciones admitidas
Situación compatible: participación en la aplicación (el usuario ya instaló la aplicación)
Cuando una sesión de app es controlada por un vínculo directo, analiza los valores gclid
y gbraid
, y almacénalos en el dispositivo o en el servidor con clave de un identificador propio. Estos valores deben almacenarse durante 180 días o hasta que se reemplacen por un valor más reciente. El valor gclid
se puede pasar a través del campo de solicitud de conversión gclid
y el valor gbraid
se puede pasar a través del campo de solicitud de conversión gbraid
.
IDFA disponible
Cuando el IDFA está disponible, se debe enviar el gclid
Y el gbraid
con el evento session_start correspondiente, junto con el campo o valor adicional app_open_source=ad_click
. Los eventos gclid
y gbraid
se pueden enviar con sesiones descendentes y eventos de la app (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera). Para las sesiones posteriores, incluye un campo o valor adicional, 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 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=BX3QojHp4mY5MrJtFM_d1u &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=ad_click
Ejemplo: Evento de la 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 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=BX3QojHp4mY5MrJtFM_d1u
Ejemplo: Sesión orgánica 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 &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gbraid=BX3QojHp4mY5MrJtFM_d1u &app_open_source=organic
El IDFA NO está disponible
Cuando IDFA NO está disponible, se requiere que gbraid
se envíe con el evento session_start
correspondiente, junto con el campo/valor adicional, app_open_source=ad_click
. y TODOS los eventos de aplicación descendentes (es decir, add_to_cart
, in_app_purchase
, etcétera). Nota: Se debe omitir el campo gclid
y el valor rdid
debe ser cero (ya que el usuario no dio su consentimiento).
El gbraid
TAMBIÉN se requiere para enviarse con sesiones descendentes y eventos correspondientes de la app (es decir, session_start
, add_to_cart
, in_app_purchase
, etcétera). Para las sesiones descendentes posteriores, incluye un valor o campo adicional, 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 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=ad_click
Ejemplo: Evento de la 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 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
Ejemplo: Sesión orgánica 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 &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=organic