- Recurso: CuratedPackage
- Estado
- AccessControlSettings
- PackageTargeting
- DeviceType
- Ambiente
- CreativeFormat
- AcceleratedMobilePageType
- AuthorizedSellerStatus
- NativeInventoryType
- OpenMeasurementType
- RestrictedCategory
- RewardedType
- PackageVideoTargeting
- VideoMimeType
- MaximumVideoAdDuration
- PositionType
- ContentDeliveryMethod
- VideoPlcmtTargeting
- SelectionType
- VideoPlcmtType
- PlaybackMethod
- VideoPlayerSizeTargeting
- StringTargetingDimension
- AdSize
- Tipo
- CriteriaTargeting
- PackagePlacementTargeting
- PackagePublisherProvidedSignalsTargeting
- TaxonomyTargeting
- CurationFeeVisibility
- Métodos
Recurso: CuratedPackage
Representa um pacote selecionado de inventário criado e gerenciado por um curador.
| Representação JSON |
|---|
{ "name": string, "displayName": string, "description": string, "createTime": string, "updateTime": string, "floorPriceCpm": { object ( |
| Campos | |
|---|---|
name |
Identificador. O nome de recurso exclusivo do pacote selecionado. Formato: |
displayName |
Obrigatório. O nome de exibição atribuído ao pacote selecionado pelo curador. Pode ser usado para filtrar a resposta do método |
description |
Opcional. Uma descrição do pacote selecionado, fornecida pelo curador. |
createTime |
Apenas saída. O carimbo de data/hora em que o pacote selecionado foi criado. Pode ser usado para filtrar a resposta do método Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: |
updateTime |
Apenas saída. O carimbo de data/hora da última atualização do pacote selecionado. Pode ser usado para filtrar a resposta do método Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: |
floorPriceCpm |
Opcional. O CPM mínimo que um comprador precisa dar para participar de leilões de inventário neste pacote selecionado. Pode ser usado para filtrar a resposta do método |
state |
Apenas saída. O estado do pacote selecionado. Pode ser usado para filtrar a resposta do método |
accessSettings |
Obrigatório. Configurações para controlar o acesso ao pacote selecionado. O acesso a esse pacote selecionado é limitado aos planejadores de mídia na lista de permissões e ao criador de conteúdo. Os compradores e bidders não podem ser incluídos na lista de permissões nem ter acesso direto a esse recurso. |
targeting |
Opcional. Critérios de segmentação para o pacote selecionado. |
curationFeeVisibility |
Opcional. Imutável. A visibilidade da taxa combinada do pacote de curadoria e das taxas do segmento de dados (a taxa total de curadoria). |
| Taxa paga ao curador por este pacote. Confira a seguir uma lista de campos mutuamente exclusivos. No máximo um dos campos será definido em uma resposta: | |
feeCpm |
Opcional. A taxa de CPM cobrada pelo curador dos compradores que usam esse pacote selecionado. Pode ser usado para filtrar a resposta do método |
millipercentOfMediaFee |
Opcional. A taxa será cobrada como uma porcentagem do custo de impressão, representada em milésimos de porcentagem. Por exemplo, 1% é representado como 1000. |
| Fim dos campos mutuamente exclusivos. | |
Estado
O estado do pacote selecionado.
| Tipos enumerados | |
|---|---|
STATE_UNSPECIFIED |
Valor padrão. |
ACTIVE |
O pacote selecionado está ativo. |
INACTIVE |
O pacote selecionado está inativo. |
AccessControlSettings
Configurações para controlar o acesso a um pacote selecionado.
| Representação JSON |
|---|
{ "allowlistedMediaPlanners": [ string ] } |
| Campos | |
|---|---|
allowlistedMediaPlanners[] |
Obrigatório. Imutável. A lista de planejadores de mídia que receberam acesso explícito ao pacote selecionado. Os planejadores de mídia qualificados podem ser encontrados no método Formato: |
PackageTargeting
Critérios de segmentação para pacotes selecionados e de leilão.
| Representação JSON |
|---|
{ "includedDeviceTypes": [ enum ( |
| Campos | |
|---|---|
includedDeviceTypes[] |
Opcional. A lista de tipos de dispositivos incluídos para segmentação. Se estiver vazio, todos os tipos de dispositivo serão segmentados. |
includedEnvironment |
Opcional. O ambiente a ser segmentado. Se não for especificado, todos os ambientes serão segmentados. |
includedCreativeFormat |
Opcional. O formato do criativo a ser segmentado. Se não for definido, todos os tipos de marcação de criativo serão segmentados. |
includedAcceleratedMobilePageType |
Opcional. O tipo de Accelerated Mobile Page segmentado. Se não for definido, o inventário será segmentado independentemente do status de AMP. |
includedAuthorizedSellerStatuses[] |
Opcional. A lista incluída de status de vendedores autorizados segmentados. Se estiver vazio, o inventário será segmentado independentemente do status do vendedor. |
includedNativeInventoryTypes[] |
Opcional. Os tipos de inventário nativo segmentados. Se estiver vazio, o inventário será segmentado independentemente do tipo de inventário nativo. |
includedOpenMeasurementTypes[] |
Opcional. A lista de tipos de medição aberta segmentados. Se estiver vazio, o inventário será segmentado, independentemente do suporte ao Open Measurement. |
includedRestrictedCategories[] |
Opcional. A lista de categorias restritas segmentadas. Se estiver vazio, o inventário será segmentado independentemente das categorias restritas. |
includedRewardedType |
Opcional. O tipo de recompensa segmentado. Se não for definido, o inventário será segmentado independentemente do tipo de recompensa. |
videoTargeting |
Opcional. Critérios de segmentação específicos para vídeos. |
minimumPredictedViewabilityPercentage |
Opcional. A porcentagem mínima de visibilidade prevista segmentada. Esse valor precisa ser um múltiplo de 10 entre 10 e 90 (inclusive). Por exemplo, 10 é válido, mas 0, 15 e 100 não são. Um valor de 10 significa que a configuração só vai corresponder a espaços de anúncio com uma visibilidade prevista de pelo menos 10%. Um valor não definido indica que o inventário será segmentado, independentemente da visibilidade prevista. |
languageTargeting |
Opcional. Os idiomas a serem segmentados. Se não for definido, o inventário será segmentado independentemente do idioma. Consulte https://developers.google.com/google-ads/api/data/codes-formats#languages para ver a lista de códigos de idioma aceitos. |
includedAdSizes[] |
Opcional. A lista de tamanhos de anúncio a serem segmentados. Se não for definido, o inventário será segmentado independentemente do tamanho do anúncio. Os pacotes selecionados são compatíveis com os tamanhos de anúncio |
publisherTargeting |
Opcional. Os publishers segmentados. Se não for definido, o inventário será segmentado independentemente do editor. Os publishers são identificados pelo ID do publisher do ads.txt / app-ads.txt. Consulte https://iabtechlab.com/ads-txt/ e https://iabtechlab.com/app-ads-txt/ para mais detalhes. |
minimumPredictedClickThroughRatePercentageMillis |
Opcional. A taxa de cliques mínima prevista, com valores de [10, 10000] (0,01% a 10%). Um valor de 50 significa que a configuração só vai corresponder a espaços de anúncio em que prevemos uma taxa de cliques de pelo menos 0,05%. Um valor não definido indica que o inventário será segmentado independentemente da taxa de cliques prevista. |
verticalTargeting |
Opcional. As verticais incluídas ou excluídas, conforme definido em https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Se não for definido, o inventário será segmentado independentemente da vertical. |
geoTargeting |
Opcional. Os IDs de critérios geográficos a serem incluídos ou excluídos, conforme definido em https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Se não for definido, o inventário será segmentado independentemente da região geográfica. |
includedDataSegments[] |
Opcional. Os segmentos de dados ativos que serão segmentados. Se não for definido, o inventário será segmentado independentemente dos segmentos de dados. Formato: |
placementTargeting |
Opcional. Informações de segmentação por canal, por exemplo, URL, aplicativos para dispositivos móveis. |
publisherProvidedSignalsTargeting |
Opcional. Os indicadores fornecidos pelo publisher para segmentação. Se não for definido, o inventário será segmentado independentemente dos indicadores fornecidos pelo publisher. |
DeviceType
O tipo geral de dispositivo a ser segmentado.
| Tipos enumerados | |
|---|---|
DEVICE_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
DEVICE_TYPE_PERSONAL_COMPUTER |
Segmenta computadores ou laptops. |
DEVICE_TYPE_CONNECTED_TV |
Segmenta smart TVs: dispositivos que transmitem conteúdo de TV, incluindo smart TVs, consoles de jogos e dispositivos de streaming. |
DEVICE_TYPE_PHONE |
Segmenta dispositivos móveis de última geração. |
DEVICE_TYPE_TABLET |
Segmenta tablets. |
Ambiente
O ambiente a ser segmentado.
| Tipos enumerados | |
|---|---|
ENVIRONMENT_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
ENVIRONMENT_SITE |
Segmenta o inventário renderizado em um site com anúncios. |
ENVIRONMENT_APP |
Segmenta o inventário em um aplicativo para dispositivos móveis. |
CreativeFormat
O formato do criativo que pode ser segmentado.
| Tipos enumerados | |
|---|---|
CREATIVE_FORMAT_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
CREATIVE_FORMAT_DISPLAY |
Segmenta espaços do anúncio destinados a criativos de display HTML. |
CREATIVE_FORMAT_VIDEO |
Segmenta espaços do anúncio destinados a criativos de vídeo. |
CREATIVE_FORMAT_AUDIO |
Segmenta espaços do anúncio destinados a criativos em áudio. |
AcceleratedMobilePageType
O tipo de implementação de Accelerated Mobile Pages (AMP) a ser segmentado.
| Tipos enumerados | |
|---|---|
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP |
Segmenta o inventário em páginas da Web padrão que não usam nenhum framework de AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP |
Segmenta o inventário em páginas criadas com o framework principal de HTML para AMP. |
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY |
Segmenta o inventário em páginas que usam o formato de história em AMP (STAMP), otimizado para narrativas visuais (por exemplo, experiências em tela cheia que podem ser tocadas). |
AuthorizedSellerStatus
Representa a relação entre o publisher e o vendedor, conforme declarado em um arquivo ads.txt ou app-ads.txt.
| Tipos enumerados | |
|---|---|
AUTHORIZED_SELLER_STATUS_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
AUTHORIZED_SELLER_STATUS_DIRECT |
Segmenta o inventário em que o vendedor é declarado como "DIRECT". Isso indica que o publisher (proprietário do conteúdo) controla diretamente a conta do vendedor e tem um contrato comercial direto com o sistema de publicidade para essa conta. |
AUTHORIZED_SELLER_STATUS_RESELLER |
Segmenta o inventário em que o vendedor é declarado como "RESELLER". Isso indica que o publisher autorizou outra entidade a operar a conta do vendedor listada e revender o espaço publicitário. |
NativeInventoryType
Representa o tipo de renderização de criativo que um espaço do anúncio aceita, especificamente em relação a anúncios nativos.
| Tipos enumerados | |
|---|---|
NATIVE_INVENTORY_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
NATIVE_INVENTORY_TYPE_NATIVE_ONLY |
Segmenta espaços do anúncio que apenas aceitam e renderizam anúncios nativos. |
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER |
Segmenta espaços de anúncios que aceitam e renderizam anúncios nativos ou de banner. |
OpenMeasurementType
O tipo de Open Measurement Interface Definition (OMID) a ser segmentado.
| Tipos enumerados | |
|---|---|
OPEN_MEASUREMENT_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
OPEN_MEASUREMENT_TYPE_OMID_V1 |
Segmenta inventários compatíveis com a v1 da Open Measurement Interface Definition (OMID). |
RestrictedCategory
Representa as categorias específicas de anúncios que são restritas pela política de segmentação.
| Tipos enumerados | |
|---|---|
RESTRICTED_CATEGORY_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
RESTRICTED_CATEGORY_ALCOHOL |
Segmenta o inventário em que os anúncios de bebidas alcoólicas são permitidos pelo publisher. |
RESTRICTED_CATEGORY_GAMBLING |
Segmenta o inventário em que os anúncios de jogos de azar são permitidos pelo publisher. |
RewardedType
Define os critérios de segmentação com base no fato de o inventário de anúncios oferecer ou não uma recompensa ao usuário por visualizar um anúncio.
| Tipos enumerados | |
|---|---|
REWARDED_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
REWARDED_TYPE_NON_REWARDED |
Segmenta inventários que NÃO oferecem uma recompensa explícita ao usuário por assistir ou interagir com o anúncio. |
REWARDED_TYPE_REWARDED |
Segmenta o inventário que oferece uma recompensa ao usuário em troca de assistir ou interagir com o anúncio. |
PackageVideoTargeting
Critérios de segmentação específicos para vídeos.
| Representação JSON |
|---|
{ "includedMimeTypes": [ enum ( |
| Campos | |
|---|---|
includedMimeTypes[] |
Opcional. A lista de tipos MIME de vídeo segmentados usando as strings de tipo MIME publicadas pela IANA (https://www.iana.org/assignments/media-types/media-types.xhtml)). Se estiver vazio, o inventário será segmentado independentemente do tipo MIME do vídeo. |
includedMaximumAdDurationTargeting |
Opcional. A duração máxima segmentada do anúncio em vídeo. Se não for definido, o inventário será segmentado independentemente da duração máxima do anúncio em vídeo. |
includedPositionTypes[] |
Opcional. Os tipos de posição do anúncio em vídeo segmentados. Se estiver vazio, o inventário será segmentado independentemente do tipo de posição do anúncio em vídeo. |
includedContentDeliveryMethod |
Opcional. O método de exibição de vídeo segmentado. Se não for definido, o inventário será segmentado independentemente do método de exibição de vídeo. |
plcmtTargeting |
Opcional. Os tipos de posicionamento de vídeo segmentados. Se não for definido, o inventário será segmentado independentemente do tipo de plcmt de vídeo. |
includedPlaybackMethods[] |
Opcional. A lista de métodos de reprodução de vídeo segmentados. Se estiver vazio, o inventário será segmentado independentemente do método de reprodução de vídeo. |
minimumPredictedCompletionRatePercentage |
Opcional. A porcentagem mínima prevista de taxa de conclusão desejada. Esse valor precisa ser um múltiplo de 10 entre 10 e 90 (inclusive). Por exemplo, 10 é válido, mas 0, 15 e 100 não são. Um valor de 10 significa que a configuração só vai corresponder a espaços de anúncio em que prevemos uma taxa de conclusão de pelo menos 10%. Um valor não definido indica que o inventário será segmentado, seja qual for a taxa de conclusão prevista. |
includedPlayerSizeTargeting |
Opcional. O tamanho do player de vídeo segmentado. Se não for definido, o inventário será segmentado independentemente do tamanho do player de vídeo. |
VideoMimeType
Os tipos MIME de vídeo a serem segmentados.
| Tipos enumerados | |
|---|---|
VIDEO_MIME_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
VIDEO_MIME_TYPE_THREEGPP |
Formato de contêiner 3GPP usado em smartphones 3G. |
VIDEO_MIME_TYPE_APPLICATION_MPEGURL |
HLS/M3U8 |
VIDEO_MIME_TYPE_MP4 |
Contêiner MPEG-4, normalmente com codec H.264. |
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH |
DASH. |
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT |
JavaScript (usado para anúncios VPAID). |
VIDEO_MIME_TYPE_WEBM |
Contêiner WebM que assume o codec VP9. |
MaximumVideoAdDuration
O limite máximo da duração do criativo do anúncio em vídeo a ser segmentado. Os valores de tipo enumerado definem buckets, e selecionar um valor significa que a duração do criativo precisa ser menor ou igual ao tempo especificado.
| Tipos enumerados | |
|---|---|
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS |
Aplica-se a anúncios em vídeo com duração de até 15 segundos (0 < duração <= 15s). |
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS |
Aplica-se a anúncios em vídeo com duração de até 20 segundos (0 < duração <= 20s). |
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS |
Aplica-se a anúncios em vídeo com duração de até 30 segundos (0 < duração <= 30s). |
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS |
Aplica-se a anúncios em vídeo com duração de até 60 segundos (0 < duração <= 60s). |
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS |
Aplica-se a anúncios em vídeo com duração de até 90 segundos (0 < duração <= 90s). |
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS |
Aplica-se a anúncios em vídeo com duração de até 120 segundos (0 < duração <= 120s). |
PositionType
A posição segmentável do anúncio em um vídeo.
| Tipos enumerados | |
|---|---|
POSITION_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
POSITION_TYPE_MIDROLL |
O anúncio é reproduzido no meio do conteúdo em vídeo. |
POSITION_TYPE_POSTROLL |
O anúncio é reproduzido após o conteúdo em vídeo. |
POSITION_TYPE_PREROLL |
O anúncio é reproduzido antes do conteúdo em vídeo. |
ContentDeliveryMethod
Critérios de segmentação com base no método de exibição do conteúdo de vídeo.
| Tipos enumerados | |
|---|---|
CONTENT_DELIVERY_METHOD_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
CONTENT_DELIVERY_METHOD_STREAMING |
Segmenta conteúdo de vídeo que está sendo transmitido ao vivo. |
CONTENT_DELIVERY_METHOD_PROGRESSIVE |
Segmenta conteúdo de vídeo transferido de forma incremental conforme necessário para a reprodução do cliente. |
VideoPlcmtTargeting
Define os critérios de segmentação com base no tipo de posição do vídeo, geralmente correspondente ao campo "plcmt" do OpenRTB do IAB.
| Representação JSON |
|---|
{ "selectionType": enum ( |
| Campos | |
|---|---|
selectionType |
Obrigatório. O tipo de seleção para a lista de posições de vídeo. |
videoPlcmtTypes[] |
Obrigatório. A lista de tipos de posicionamentos de vídeo segmentados. Se estiver vazio, o inventário será segmentado independentemente do tipo de plcmt de vídeo. |
SelectionType
Tipo enumerado para os possíveis tipos de seleção usados pelas dimensões de segmentação.
| Tipos enumerados | |
|---|---|
SELECTION_TYPE_UNSPECIFIED |
Tipo de seleção não especificado. Não pode ser usado. |
SELECTION_TYPE_INCLUDE |
Os valores na dimensão de segmentação são incluídos. |
SELECTION_TYPE_EXCLUDE |
Os valores na dimensão de segmentação são excluídos. |
VideoPlcmtType
Representa o tipo de posição do vídeo, de acordo com os padrões do OpenRTB.
| Tipos enumerados | |
|---|---|
VIDEO_PLCMT_TYPE_UNSPECIFIED |
Valor padrão. Não deve ser usado em especificações de segmentação. |
INSTREAM |
Anúncios precedentes, intermediários e finais que são reproduzidos antes, durante ou depois do streaming de conteúdo em vídeo que o consumidor pediu. O vídeo in-stream precisa estar definido como "som ativado" por padrão no início do player ou ter uma intenção do usuário explicitamente clara de assistir o conteúdo do vídeo. Embora possa haver outro conteúdo ao redor do player, o conteúdo em vídeo precisa ser o foco da visita do usuário. Ele precisa continuar sendo o conteúdo principal da página e o único player de vídeo visível com áudio durante a reprodução. Se o player for convertido em flutuante/fixo, as chamadas de anúncio seguintes precisarão transmitir com precisão o tamanho atualizado do player. |
ACCOMPANYING_CONTENT |
Anúncios precedentes, intermediários e finais que são reproduzidos antes, durante ou depois do conteúdo de streaming de vídeo. O player de vídeo é carregado e reproduzido antes, entre ou depois de parágrafos de texto ou conteúdo gráfico, e só começa a ser reproduzido quando entra na janela de visualização. O conteúdo complementar só deve começar a ser reproduzido ao entrar na janela de visualização. Ele pode se transformar em um player flutuante/fixo ao sair da página. |
INTERSTITIAL |
Anúncios em vídeo reproduzidos sem conteúdo de vídeo. Durante a reprodução, ele precisa ser o foco principal da página, ocupar a maior parte da janela de visualização e não pode ser removido da tela ao rolar a página. Isso pode ser feito em posições como vídeos no app ou apresentações de slides. |
NO_CONTENT |
Anúncios em vídeo reproduzidos sem conteúdo de streaming de vídeo. Isso pode ser feito em posições como apresentações de slides, feeds nativos, no conteúdo ou fixos/flutuantes. |
PlaybackMethod
O método de reprodução a ser segmentado.
| Tipos enumerados | |
|---|---|
PLAYBACK_METHOD_UNSPECIFIED |
Método de reprodução de vídeo não especificado. Não pode ser usado. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON |
A reprodução começa automaticamente quando a página/conteúdo é carregado. |
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF |
A reprodução começa automaticamente quando a página/conteúdo é carregado, mas com o som desativado. |
PLAYBACK_METHOD_CLICK_TO_PLAY |
A reprodução é iniciada por uma ação do usuário (por exemplo, clicar em um botão de reprodução). |
VideoPlayerSizeTargeting
Representa o tamanho do player de vídeo que pode ser segmentado. A largura e a altura precisam ser definidas com valores diferentes de zero.
| Representação JSON |
|---|
{ "minimumWidth": string, "minimumHeight": string } |
| Campos | |
|---|---|
minimumWidth |
Obrigatório. A largura mínima do player de vídeo em pixels. |
minimumHeight |
Obrigatório. A altura mínima do player de vídeo em pixels. |
StringTargetingDimension
Segmentação genérica com valores de string.
| Representação JSON |
|---|
{
"selectionType": enum ( |
| Campos | |
|---|---|
selectionType |
Obrigatório. Como os itens desta lista devem ser segmentados. |
values[] |
Obrigatório. Os valores especificados. |
AdSize
Representa o tamanho de um único espaço do anúncio ou de um criativo.
| Representação JSON |
|---|
{
"width": string,
"height": string,
"type": enum ( |
| Campos | |
|---|---|
width |
A largura do espaço do anúncio em pixels. Este campo só estará presente quando o tipo de tamanho for |
height |
A altura do espaço do anúncio em pixels. Este campo só estará presente quando o tipo de tamanho for |
type |
O tipo de tamanho do espaço do anúncio. |
Tipo
Representa diferentes tipos de dimensionamento de espaço do anúncio/criativo.
| Tipos enumerados | |
|---|---|
TYPE_UNSPECIFIED |
Um marcador de posição para um tipo de tamanho indefinido. |
PIXEL |
Espaço do anúncio com tamanho especificado por altura e largura em pixels. |
INTERSTITIAL |
Tamanho especial para descrever um espaço do anúncio intersticial. |
NATIVE |
Anúncios nativos (para dispositivos móveis) renderizados pelo publisher. |
FLUID |
O tamanho fluido (tamanho responsivo) pode ser redimensionado automaticamente com a mudança do ambiente externo. |
CriteriaTargeting
Segmentação genérica usada para dimensões de segmentação que contêm uma lista de IDs numéricos incluídos e excluídos. Não é possível filtrar isso usando a sintaxe de filtro de lista.
| Representação JSON |
|---|
{ "targetedCriteriaIds": [ string ], "excludedCriteriaIds": [ string ] } |
| Campos | |
|---|---|
targetedCriteriaIds[] |
Uma lista de IDs numéricos a serem incluídos. |
excludedCriteriaIds[] |
Uma lista de IDs numéricos a serem excluídos. |
PackagePlacementTargeting
Representa a segmentação sobre onde os anúncios podem aparecer, por exemplo, em determinados sites ou apps para dispositivos móveis. Diferentes tipos de segmentação por canal serão logicamente combinados com "OU".
| Representação JSON |
|---|
{ "uriTargeting": { object ( |
| Campos | |
|---|---|
uriTargeting |
Opcional. A lista de URLs segmentados ou excluídos. Os domínios não podem ter http/https (por exemplo, google.com) e podem conter no máximo 5 caminhos por URL. |
mobileAppTargeting |
Opcional. A lista de IDs de aplicativos para dispositivos móveis segmentados ou excluídos que pertencem aos editores. No momento, apenas apps Android e Apple são aceitos. O ID do app Android, por exemplo, com.google.android.apps.maps, pode ser encontrado no URL da Google Play Store. O ID do app iOS (que é um número) pode ser encontrado no final do URL da iTunes Store. Os aplicativos próprios para dispositivos móveis são incluídos ou excluídos. |
includedMobileAppCategoryTargeting[] |
Opcional. A lista de categorias de apps para dispositivos móveis segmentadas. |
PackagePublisherProvidedSignalsTargeting
Representa a segmentação sobre indicadores fornecidos pelo publisher. Diferentes tipos de indicadores fornecidos pelo publisher serão combinados com o operador lógico OR.
| Representação JSON |
|---|
{ "audienceTargeting": { object ( |
| Campos | |
|---|---|
audienceTargeting |
Opcional. A lista de IDs de público-alvo segmentados ou excluídos. Com base na versão 1.1 da taxonomia de público-alvo do IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) |
contentTargeting |
Opcional. A lista de Content IDs segmentados ou excluídos. Com base na versão 2.2 da taxonomia de conteúdo do IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) |
videoAndAudioSignalsTargeting |
Opcional. A lista de IDs de sinais de áudio e vídeo segmentados e excluídos. Estes são outros indicadores compatíveis com os indicadores fornecidos pelo publisher. |
TaxonomyTargeting
Define os critérios de segmentação para processar o espaço de ID da taxonomia de público-alvo e conteúdo do IAB.
| Representação JSON |
|---|
{ "targetedTaxonomyIds": [ string ], "excludedTaxonomyIds": [ string ] } |
| Campos | |
|---|---|
targetedTaxonomyIds[] |
Opcional. A lista de IDs de taxonomia de conteúdo segmentados. |
excludedTaxonomyIds[] |
Opcional. A lista de IDs de taxonomia de conteúdo excluídos. |
CurationFeeVisibility
A visibilidade da taxa combinada do pacote de curadoria e das taxas do segmento de dados (a taxa total de curadoria). As taxas estão sempre visíveis para o criador do pacote.
| Tipos enumerados | |
|---|---|
CURATION_FEE_VISIBILITY_UNSPECIFIED |
A visibilidade da taxa total de curadoria não foi especificada. |
DISCLOSED |
A taxa total de curadoria fica visível para todos os compradores. Esse é o valor padrão se não for definido. |
NON_DISCLOSED |
A taxa total de curadoria não fica visível para todos os compradores. |
Métodos |
|
|---|---|
|
Ativa um pacote selecionado. |
|
Cria um novo pacote selecionado. |
|
Desativa um pacote selecionado. |
|
Recebe um pacote selecionado com base no nome do recurso. |
|
Lista os pacotes selecionados que pertencem ao curador especificado. |
|
Atualiza um pacote selecionado. |