Esta página foi traduzida pela API Cloud Translation.

Atribuição de app em conformidade com a privacidade

Resumo

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

Apps Android

Escopo

Instalação de aplicativos e engajamento de aplicativos em todas as campanhas do Google Ads

Contexto

No momento, não é possível acompanhar os usuários do Android que desativaram a personalização de anúncios usando o ID de publicidade do Android (de acordo com a política do Google). Em vez disso, o Google usa gclid, um parâmetro de URL de clique que não persiste com o dispositivo.

Orientação

Os consumidores da API App Conversion Tracking and Remarketing precisam garantir que o gclid esteja corretamente armazenado e transmitido.

Cenários compatíveis

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

Quando uma instalação de app é impulsionada por um link direto que redireciona para a Google Play Store, e o usuário abre o aplicativo pela primeira vez, analise o valor gclid no campo API Play Install Referrer install_referrer e armazene-o no dispositivo ou no lado do servidor codificado por um identificador primário. Esse gclid precisa ser armazenado por 180 dias ou até que outro referenciador de instalação do Google Play mais recente gclid o substitua.Esse gclid pode ser transmitido pelo campo de solicitação de conversão market_referrer_gclid.

O ID de publicidade está disponível

Quando o ID de publicidade do Android estiver disponível, o market_referrer_gclid precisará ser enviado com o evento first_open correspondente. O market_referrer_gclid pode ser enviado com sessões downstream e eventos de app (por exemplo, session_start, add_to_cart, in_app_purchase etc.).

Exemplo: primeiro acesso

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
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

Exemplo: eventos de sessão e 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
       &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 ID de publicidade do Android NÃO estiver disponível, o market_referrer_gclid precisa ser enviado com o evento first_open correspondente e TODAS as sessões downstream e eventos do aplicativo (ou seja, session_start, add_to_cart, in_app_purchase etc.), além de outro campo/valor, gclid_only_request=1. Observação: o valor rdid precisa ser zeros (já que o usuário não deu consentimento).

Exemplo: primeiro acesso

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
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Exemplo: sessão e eventos do aplicativo

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
       &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 for orientada por um link direto, analise o valor gclid e armazene-o no dispositivo ou no servidor vinculado a um identificador próprio.
O gclid precisa ser armazenado por 180 dias ou até outro gclid mais recente substituí-lo. É possível transmitir esse valor pelo campo de solicitação de conversão gclid.

O ID de publicidade está disponível

Quando o ID de publicidade do Android está disponível, o gclid precisa ser enviado com o evento session_start correspondente. O gclid pode ser enviado com eventos do app, ou seja, add_to_cart, in_app_purchase etc. O gclid NÃO precisa ser transmitido com eventos session_start downstream.

Exemplo: sessão de 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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

Exemplo: eventos 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=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

O ID de publicidade NÃO está disponível

Quando o ID de publicidade do Android NÃO estiver disponível, o gclid é necessário para ser enviado com o evento session_start correspondente e TODAS as sessões e eventos de aplicativo downstream (ou seja, session_start, add_to_cart, in_app_purchase etc.). Observação: o valor rdid deve ser apenas zero (já que o usuário desativou a personalização de anúncios).

Exemplo: sessão de link direto

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1

Exemplo: eventos 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=advertisingid
       &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

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
       &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

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

Quando uma instalação de app é acionada por um link direto para a Google Play Store, seguida por uma sessão baseada em um link direto para o app, analise os valores gclid da API Play Install Referrer gclid e os valores de link direto gclid e armazene-os no dispositivo ou no servidor com chave por um identificador próprio. Esses valores gclid devem ser armazenados por 180 dias ou até que outro link direto mais recente gclid substitua o link direto existente gclid, ou uma API Play Install Referrer gclid substitua a API Play Install Referrer gclid. A API Play Install Referrer gclid precisa ser transmitida pelo market_referrer_gclid field, E o link direto gclid pelo campo gclid.

O ID de publicidade está disponível

Quando o ID de publicidade do Android está disponível, os market_referrer_gclid E gclid precisam ser enviados com os eventos session_start e apps correspondentes (ou seja, add_to_cart, in_app_purchase etc.). Para eventos session_start downstream, transmita o market_referrer_gclid, mas o (link direto) gclid NÃO NÃO pode ser transmitido.

Exemplo: sessão de 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
       &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

Exemplo: eventos 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=advertisingid
       &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

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
       &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

O ID de publicidade NÃO está disponível

Quando o ID de publicidade do Android NÃO estiver disponível, os market_referrer_gclid E gclid precisarão ser enviados com o evento session_start correspondente e TODAS os eventos de sessão e app downstream (ou seja, session_start, add_to_cart, in_app_purchase etc.). Observação: o valor rdid precisa ser zero (já que o usuário desativou a personalização de anúncios).

Exemplo: sessão de link direto

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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

Exemplo: eventos 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=advertisingid
       &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

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
       &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

Importante: a API Play Install Referrer gclid (transmitida como market_referrer_gclid) e um link direto gclid (transmitida como gclid) são duas fontes diferentes para gclid e não devem ser usadas de maneira intercambiável. Lembre-se de que esses valores gclid precisam ser armazenados por 180 dias ou até que outro link direto mais recente gclid substitua o link direto existente gclid ou uma API Play Install Referrer gclid substitua a API Play Install Referrer gclid.

Aplicativos para iOS

Escopo

Engajamento no aplicativo pela Pesquisa Google Ads, Shopping e ACi para iOS + links diretos

Contexto

Usuários do iOS 14.5 ou superior que não ativaram o acompanhamento de aplicativos não podem ser rastreados usando o IDFA (de acordo com a política ATT da Apple). Em vez disso, o Google utiliza o gbraid, um parâmetro de URL de clique agregado.

Orientação

Os consumidores da API App Conversion Tracking and Remarketing precisam garantir que todos os parâmetros de clique foram transmitidos corretamente, incluindo o gclid e a gbraid.

Cenários compatíveis

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

Quando uma sessão do app for orientada por um link direto, analise os valores gclid e gbraid e armazene-os no dispositivo ou no servidor codificado por um identificador próprio. Esses valores devem ser armazenados por 180 dias ou até serem substituídos por um valor mais recente. O valor gclid pode ser transmitido pelo campo de solicitação de conversão gclid, e o valor gbraid pode ser transmitido pelo campo de solicitação de conversão gbraid.

O IDFA está disponível

Quando IDFA está disponível, gclid E gbraid precisam ser enviados com o evento session_start correspondente, junto com o campo/valor adicional, app_open_source=ad_click. O gclid e o gbraid podem ser enviados com sessões downstream e eventos de app (por exemplo, session_start, add_to_cart, in_app_purchase etc.). Nas sessões downstream subsequentes, inclua o campo/valor adicional, app_open_source=organic.

Exemplo: sessão de 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=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=ad_click

Exemplo: evento 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=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u

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
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
       &app_open_source=organic

O IDFA NÃO está disponível

Quando IDFA NÃO estiver disponível, o gbraid precisa ser enviado com o evento session_start correspondente, junto com um 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 zero (já que o usuário não deu consentimento). O gbraid também é necessário para ser enviado com sessões downstream e eventos de app correspondentes (ou seja, session_start, add_to_cart, in_app_purchase etc.). Nas próximas sessões downstream, inclua o campo/valor adicional, app_open_source=organic.

Exemplo: sessão de link direto

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
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=ad_click

Exemplo: evento 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=idfa
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M

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
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=organic

Observação:gbraid não pode ser usado em cenários de instalação porque os usuários são redirecionados primeiro para o iTunes.