REST Resource: curators.curatedPackages

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 (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Campos
name

string

Identificador. O nome de recurso exclusivo do pacote selecionado. Formato: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Obrigatório. O nome de exibição atribuído ao pacote selecionado pelo curador. Pode ser usado para filtrar a resposta do método curatedPackages.list.

description

string

Opcional. Uma descrição do pacote selecionado, fornecida pelo curador.

createTime

string (Timestamp format)

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 curatedPackages.list.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

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 curatedPackages.list.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

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 curatedPackages.list.

state

enum (State)

Apenas saída. O estado do pacote selecionado. Pode ser usado para filtrar a resposta do método curatedPackages.list.

accessSettings

object (AccessControlSettings)

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

object (PackageTargeting)

Opcional. Critérios de segmentação para o pacote selecionado.

curationFeeVisibility

enum (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

object (Money)

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 curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

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[]

string

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 mediaPlanners.list. No momento, apenas um planejador de mídia pode ser incluído na lista de permissões.

Formato: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Critérios de segmentação para pacotes selecionados e de leilão.

Representação JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Campos
includedDeviceTypes[]

enum (DeviceType)

Opcional. A lista de tipos de dispositivos incluídos para segmentação. Se estiver vazio, todos os tipos de dispositivo serão segmentados.

includedEnvironment

enum (Environment)

Opcional. O ambiente a ser segmentado. Se não for especificado, todos os ambientes serão segmentados.

includedCreativeFormat

enum (CreativeFormat)

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

enum (AcceleratedMobilePageType)

Opcional. O tipo de Accelerated Mobile Page segmentado. Se não for definido, o inventário será segmentado independentemente do status de AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

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[]

enum (NativeInventoryType)

Opcional. Os tipos de inventário nativo segmentados. Se estiver vazio, o inventário será segmentado independentemente do tipo de inventário nativo.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

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[]

enum (RestrictedCategory)

Opcional. A lista de categorias restritas segmentadas. Se estiver vazio, o inventário será segmentado independentemente das categorias restritas.

includedRewardedType

enum (RewardedType)

Opcional. O tipo de recompensa segmentado. Se não for definido, o inventário será segmentado independentemente do tipo de recompensa.

videoTargeting

object (PackageVideoTargeting)

Opcional. Critérios de segmentação específicos para vídeos.

minimumPredictedViewabilityPercentage

string (int64 format)

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

object (StringTargetingDimension)

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[]

object (AdSize)

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 PIXEL e INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

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

string (int64 format)

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

object (CriteriaTargeting)

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

object (CriteriaTargeting)

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[]

string

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: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Opcional. Informações de segmentação por canal, por exemplo, URL, aplicativos para dispositivos móveis.

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

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 (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Campos
includedMimeTypes[]

enum (VideoMimeType)

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

enum (MaximumVideoAdDuration)

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[]

enum (PositionType)

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

enum (ContentDeliveryMethod)

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

object (VideoPlcmtTargeting)

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[]

enum (PlaybackMethod)

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

string (int64 format)

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

object (VideoPlayerSizeTargeting)

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 (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Campos
selectionType

enum (SelectionType)

Obrigatório. O tipo de seleção para a lista de posições de vídeo.

videoPlcmtTypes[]

enum (VideoPlcmtType)

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

string (int64 format)

Obrigatório. A largura mínima do player de vídeo em pixels.

minimumHeight

string (int64 format)

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 (SelectionType),
  "values": [
    string
  ]
}
Campos
selectionType

enum (SelectionType)

Obrigatório. Como os itens desta lista devem ser segmentados.

values[]

string

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 (Type)
}
Campos
width

string (int64 format)

A largura do espaço do anúncio em pixels. Este campo só estará presente quando o tipo de tamanho for PIXEL.

height

string (int64 format)

A altura do espaço do anúncio em pixels. Este campo só estará presente quando o tipo de tamanho for PIXEL.

type

enum (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[]

string (int64 format)

Uma lista de IDs numéricos a serem incluídos.

excludedCriteriaIds[]

string (int64 format)

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 (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Campos
uriTargeting

object (StringTargetingDimension)

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

object (StringTargetingDimension)

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[]

string (int64 format)

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 (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Campos
audienceTargeting

object (TaxonomyTargeting)

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

object (TaxonomyTargeting)

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

object (StringTargetingDimension)

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[]

string

Opcional. A lista de IDs de taxonomia de conteúdo segmentados.

excludedTaxonomyIds[]

string

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

activate

Ativa um pacote selecionado.

create

Cria um novo pacote selecionado.

deactivate

Desativa um pacote selecionado.

get

Recebe um pacote selecionado com base no nome do recurso.

list

Lista os pacotes selecionados que pertencem ao curador especificado.

patch

Atualiza um pacote selecionado.