Dimensões de exportação de público-alvo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
As dimensões compatíveis com consultas aos métodos de exportação de público-alvo da API Analytics Data.
Os métodos de relatórios principais (RunReport, por exemplo) aceitam um conjunto diferente de dimensões e métricas do que os métodos de exportação de público-alvo.
Dimensões
As dimensões a seguir podem ser solicitadas nas exportações de público-alvo para qualquer propriedade.
Especifique o "Nome da API" no campo name de um recurso AudienceDimension para uma coluna da dimensão na resposta de exportação do público-alvo.
| Nome da API |
Nome da interface |
Descrição |
deviceId |
ID do dispositivo |
Um identificador com base no navegador ou app para dispositivos móveis de um único usuário pseudonomizado do site ou app. Para saber mais, consulte ID do dispositivo. |
isAdsPersonalizationAllowed |
A personalização de anúncios é permitida |
Se um usuário estiver qualificado para a personalização de anúncios, isAdsPersonalizationAllowed vai retornar true. Se um usuário não estiver qualificado para a personalização de anúncios, isAdsPersonalizationAllowed vai retornar false.
isAdsPersonalizationAllowed retorna (not set) se o Google Analytics não puder informar se esse usuário está qualificado para a personalização de anúncios. Os usuários em que isAdsPersonalizationAllowed retorna (not set) podem ou não ser qualificados para anúncios personalizados. Para anúncios personalizados, trate os usuários em que isAdsPersonalizationAllowed = (not set) como isAdsPersonalizationAllowed = false porque, no caso mais geral, algumas das linhas (not set) incluem usuários que não estão qualificados para personalização de anúncios.
Usuários em que isAdsPersonalizationAllowed = false ainda podem ser usados para casos de uso que não são de publicidade, como testes A/B e análises detalhadas de dados. |
isLimitedAdTracking |
O rastreamento de anúncios está limitado |
A configuração "Limitar o rastreamento de anúncios" do dispositivo. Os valores possíveis incluem true, false e (not set). isLimitedAdTracking retorna (not set) se o Google Analytics não puder retornar a configuração de Limitar o rastreamento de anúncios desse dispositivo. |
userId |
User-ID |
O ID do usuário especificado para esse usuário na inclusão de tags. Para saber mais, consulte Medir a atividade em várias plataformas com o User-ID.
Se a coleta de dados fornecidos pelo usuário estiver ativada, esses dados e o User-ID poderão ser enviados ao Google Analytics na inclusão de tags para melhorar a medição. Para saber mais, consulte Coleta de dados fornecidos pelo usuário. Independentemente de os dados fornecidos pelo usuário estarem ativados para sua propriedade, userId retorna o ID do usuário especificado na inclusão de tags. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 2025-07-26 UTC."],[[["\u003cp\u003eThe Analytics Data API's Audience Export methods use a specific set of dimensions for querying data, differing from the Core Reporting methods.\u003c/p\u003e\n"],["\u003cp\u003eAudience exports support dimensions such as Device ID, Ads Personalization status, Limited Ad Tracking status, and User ID for any Google Analytics property.\u003c/p\u003e\n"],["\u003cp\u003eThese dimensions provide insights into user characteristics, privacy settings, and identifiers for analysis and audience creation.\u003c/p\u003e\n"],["\u003cp\u003eYou can include these dimensions in your audience export requests by specifying their API names within the \u003ccode\u003eAudienceDimension\u003c/code\u003e resource.\u003c/p\u003e\n"]]],["Audience Export methods in the Analytics Data API support specific dimensions for queries, distinct from Core Reporting methods. These dimensions, specified by their API Name, include `deviceId`, a unique user identifier; `isAdsPersonalizationAllowed`, indicating a user's eligibility for personalized ads; `isLimitedAdTracking`, reflecting the device's ad tracking settings; and `userId`, the user ID defined in tagging. Each dimension's API Name is used in the `AudienceDimension` resource to retrieve corresponding data.\n"],null,["# Audience Export Dimensions\n\nThe dimensions supported in queries to the [Audience Export methods](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/create) of the Analytics Data API.\nThe Core Reporting methods ([`RunReport`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties/runReport)\nfor example) accept a different set of [Dimensions \\& Metrics](/analytics/devguides/reporting/data/v1/api-schema)\nthan the Audience Export methods.\n\nDimensions\n----------\n\nThe following dimensions can be requested in audience exports for any property.\nSpecify the \"API Name\" in an\n[`AudienceDimension`](/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports#AudienceDimension)\nresource's `name` field for a column of the dimension in the audience export\nresponse.\n\n| API Name | UI Name | Description |\n|-------------------------------|--------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceId` | Device ID | A browser-based or mobile-app-based identifier for a unique, pseudonymous website or mobile app user. To learn more, see [Device ID](//support.google.com/analytics/answer/9356035). |\n| `isAdsPersonalizationAllowed` | Is ads personalization allowed | If a user is eligible for ads personalization, isAdsPersonalizationAllowed returns `true`. If a user is not eligible for ads personalization, isAdsPersonalizationAllowed returns `false`. isAdsPersonalizationAllowed returns `(not set)` if Google Analytics can't return whether this user is eligible for ads personalization; users where isAdsPersonalizationAllowed returns `(not set)` may or may not be eligible for personalized ads. For personalized ads, you should treat users where isAdsPersonalizationAllowed = `(not set)` as isAdsPersonalizationAllowed = `false` because, in the most general case, some of the `(not set)` rows will include users that are not eligible for ads personalization. Users where isAdsPersonalizationAllowed = `false` can still be used for non-advertising use cases like A/B testing \\& data explorations. |\n| `isLimitedAdTracking` | Is limited ad tracking | The device's Limit Ad Tracking setting. Possible values include: `true`, `false`, and `(not set)`. isLimitedAdTracking returns `(not set)` if Google Analytics can't return this device's Limit Ad Tracking setting. |\n| `userId` | User ID | The User ID specified for this user in tagging. To learn more, see [Measure activity across platforms with User-ID](//support.google.com/analytics/answer/9213390). If user-provided data collection is turned on, user-provided data along with User-ID can be sent to Google Analytics in tagging to improve measurement. To learn more, see [user-provided data collection](//support.google.com/analytics/answer/14077171). Regardless of whether user-provided data is turned on for your property, `userId` returns the User ID specified in tagging. |"]]
