Atribuição de app em conformidade com a privacidade

Resumo

Os consumidores de API que usam a API App Conversion Tracking and Remarketing do Google Ads para transmitir conversões de apps diretamente precisam seguir as orientações para Android e iOS. Isso garante que os cliques de usuários que desativam o rastreamento de anúncios ou a personalização de anúncios sejam atribuídos apenas usando fluxos de trabalho compatíveis com a privacidade. Consulte a Visão geral das especificações de solicitação e resposta para mais informações sobre definições de parâmetros e valores esperados.

Aplicativos Android

Escopo

Instalação e engajamento com apps em todas as campanhas do Google Ads

Contexto

No momento, os usuários do Android que desativaram a personalização de anúncios não podem ser rastreados usando o ID de publicidade do Android (de acordo com a política do Google). Em vez disso, o Google usa o gclid, um parâmetro de URL de clique que não persiste com o dispositivo. Além disso, o Google pode usar o gbraid, um parâmetro agregado de URL de clique, em outros cenários em que o consentimento no nível do usuário não foi concedido.

Orientação

Os consumidores da API de acompanhamento de conversões de app e remarketing precisam garantir que gclid e gbraid sejam armazenados e transmitidos corretamente.

Cenários compatíveis

Cenário compatível: instalação (o usuário não instalou o app antes)

Quando uma instalação de app é feita por um link direto que redireciona para a Google Play Store e o usuário abre o app pela primeira vez, analise o valor gclid do campo install_referrer da API Play Install Referrer e armazene-o no dispositivo ou no servidor usando um identificador próprio. Cada valor precisa ser armazenado por 180 dias ou até ser substituído por outro mais recente. O valor gclid precisa ser transmitido pelo campo de solicitação de conversão market_referrer_gclid.

O ID de publicidade está disponível

Quando o código de publicidade do Android está disponível, o market_referrer_gclid precisa ser enviado com o evento first_open correspondente e TODAS as sessões e eventos do app downstream (ou seja,session_start, add_to_cart, in_app_purchase etc.).

Exemplo: primeira abertura
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
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
Exemplo: eventos de sessão e de app
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
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
O ID de publicidade NÃO está disponível

Quando o código de publicidade do Android NÃO está disponível, o market_referrer_gclid é obrigatório para ser enviado com o evento first_open correspondente, e TODAS as sessões e eventos de app downstream (ou seja, session_start, add_to_cart, in_app_purchase etc.), junto com o campo/valor adicional, gclid_only_request=1. Observação: o valor rdid precisa ser zero (já que o usuário não deu consentimento).

Exemplo: primeira abertura
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
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
Exemplo: eventos de sessão e de app
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
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Cenário compatível: engajamento no app (o usuário já instalou o app)

Quando uma sessão do app é conduzida por um link direto, analise os valores gclid e gbraid do URL de referência e armazene-os no dispositivo ou do lado do servidor, usando um identificador próprio como chave. Cada valor precisa ser armazenado por 180 dias ou até ser substituído por outro mais recente. O valor do link direto gclid precisa ser transmitido pelo campo de solicitação de conversão gclid, e o valor do link direto gbraid precisa ser transmitido pelo campo de solicitação de conversão gbraid.

O ID de publicidade está disponível

Quando o Código de publicidade do Android está disponível, é necessário enviar gclid e gbraid com o evento session_start correspondente e TODAS as sessões downstream e eventos do app (ou seja,session_start, add_to_cart, in_app_purchase etc.).

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: eventos de app
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: sessão subsequente/orgânica
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
O ID de publicidade NÃO está disponível

Quando o código de publicidade do Android NÃO está disponível, o gclid é obrigatório para ser enviado com o evento session_start correspondente e TODAS as sessões downstream e os eventos do app (ou seja, session_start, add_to_cart, in_app_purchase etc.). Observação: o valor de rdid precisa ser todo zero, já que o usuário desativou a personalização de anúncios.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: eventos de app
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: sessão subsequente/orgânica
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Cenário compatível: instalação + engajamento

Quando uma instalação de app é impulsionada por um link direto para a Google Play Store, seguida por uma sessão de app impulsionada por um link direto para o app, analise o valor de gclid do campo Play Install Referrer API install_referrer e os valores gclid e gbraid do URL de referência. Armazene esses dados no dispositivo ou no servidor usando um identificador de terceiros. Cada valor precisa ser armazenado por 180 dias ou até ser substituído por outro mais recente. O valor do referenciador de instalação gclid precisa ser transmitido pelo campo de solicitação de conversão market_referrer_gclid. O valor do link direto gclid precisa ser transmitido pelo campo de solicitação de conversão gclid. O valor do link direto gbraid precisa ser transmitido pelo campo de solicitação de conversão gbraid.

O ID de publicidade está disponível

Quando o ID de publicidade do Android está disponível, é necessário enviar market_referrer_gclid E gclid com o evento session_start correspondente e os eventos do app (ou seja, add_to_cart, in_app_purchase etc.). Para eventos session_start downstream, transmita o market_referrer_gclid, mas NÃO transmita o gclid (link direto).

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: eventos de app
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: sessão subsequente/orgânica
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
       &timestamp=1432681913.123456
       <&gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
O ID de publicidade NÃO está disponível

Quando o código de publicidade do Android NÃO está disponível, é necessário enviar market_referrer_gclid E gclid com o evento session_start correspondente, além de TODOS os eventos de sessão e app downstream (ou seja, session_start, add_to_cart, in_app_purchase etc.). Observação:o valor de rdid precisa ser zero (já que o usuário desativou a personalização de anúncios).

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: eventos de app
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: sessão subsequente/orgânica
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

Aplicativos para iOS

Escopo

Engajamento com apps pela pesquisa, pelo Shopping e pelas ACi do iOS + links diretos do Google Ads

Contexto

Os usuários do iOS 14.5 ou versões mais recentes que não ativaram o rastreamento de apps não podem ser rastreados usando o IDFA (de acordo com a política de ATT da Apple). Em vez disso, o Google usa o gbraid, um parâmetro agregado de URL de clique. Além disso, o Google pode usar o gbraid em outros cenários em que o consentimento no nível do usuário não foi concedido.

Orientação

Os consumidores da API de acompanhamento de conversões e remarketing de apps precisam garantir que todos os parâmetros de clique sejam transmitidos corretamente, incluindo gclid e gbraid.

Cenários compatíveis

Cenário compatível: engajamento no app (o usuário já instalou o app)

Quando uma sessão de app é conduzida por um link direto, analise os valores gclid e gbraid do URL de referência e armazene-os no dispositivo ou no lado do servidor usando um identificador próprio como chave. Cada valor precisa ser armazenado por 180 dias ou até ser substituído por outro mais recente. O valor gclid precisa ser transmitido pelo campo de solicitação de conversão gclid, e o valor gbraid precisa ser transmitido pelo campo de solicitação de conversão gbraid.

O IDFA está disponível

Quando o IDFA está disponível, o gclid E o gbraid precisam ser enviados com o evento session_start correspondente, além do campo/valor adicional app_open_source=ad_click. Os eventos gclid e gbraid também precisam ser enviados com sessões downstream e eventos do app (ou seja, session_start, add_to_cart, in_app_purchase etc.). Para as sessões downstream subsequentes, inclua o campo/valor adicional app_open_source=organic.

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
Exemplo: evento do app
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: sessão subsequente/orgânica
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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic
O IDFA NÃO está disponível

Quando o IDFA NÃO está disponível, o gbraid é obrigatório para ser enviado com o evento session_start correspondente e com o campo/valor adicional app_open_source=ad_click. e TODOS os eventos de apps downstream (ou seja, add_to_cart, in_app_purchase etc.). Observação: o campo gclid precisa ser omitido, e o valor rdid precisa ser todo zeros (já que o usuário não deu consentimento). O gbraid TAMBÉM precisa ser enviado com sessões downstream e eventos de app correspondentes (ou seja, session_start, add_to_cart, in_app_purchase etc.). Para sessões downstream subsequentes, inclua o campo/valor adicional app_open_source=organic.

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
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=ad_click
Exemplo: evento do app
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
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Exemplo: sessão subsequente/orgânica
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
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic