REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Recurso: AssignedSegmentaçãoOption

Uma única opção de segmentação atribuída, que define o estado de uma opção de segmentação para uma entidade com configurações de segmentação.

Representação JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Campos
name

string

Apenas saída. O nome do recurso dessa opção de segmentação atribuída.

assignedTargetingOptionId

string

Apenas saída. O ID exclusivo da opção de segmentação atribuída. O ID só é exclusivo em um determinado recurso e tipo de segmentação. Eles poderão ser reutilizados em outros contextos.

assignedTargetingOptionIdAlias

string

Apenas saída. Um alias para assignedTargetingOptionId. Esse valor pode ser usado no lugar de assignedTargetingOptionId ao recuperar ou excluir a segmentação existente.

Esse campo só é compatível com todas as opções de segmentação atribuídas dos seguintes tipos:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Este campo também é compatível com opções de segmentação atribuídas a itens de linha dos seguintes tipos:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Apenas saída. Identifica o tipo dessa opção de segmentação atribuída.

inheritance

enum (Inheritance)

Apenas saída. O status de herança da opção de segmentação atribuída.

Campo de união details. Informações detalhadas sobre a opção de segmentação que está sendo atribuída. Somente um campo detalhado pode ser preenchido, e precisa corresponder a targeting_type. details só pode ser uma das seguintes opções:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Detalhes do canal. Este campo será preenchido quando targetingType for TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Detalhes da categoria do app. Este campo será preenchido quando targetingType for TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Detalhes do app. Este campo será preenchido quando targetingType for TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Detalhes do URL. Este campo será preenchido quando targetingType for TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalhes de dia e hora. Este campo será preenchido quando targetingType for TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Detalhes da faixa etária. Este campo será preenchido quando targetingType for TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalhes da lista de locais regionais. Este campo será preenchido quando targetingType for TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalhes da lista de localização por proximidade. Este campo será preenchido quando targetingType for TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalhes do sexo. Este campo será preenchido quando targetingType for TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Detalhes do tamanho do player de vídeo. Este campo será preenchido quando targetingType for TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalhes do conteúdo com prêmio para o usuário. Este campo será preenchido quando targetingType for TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Detalhes do status parental. Este campo será preenchido quando targetingType for TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Detalhes da posição in-stream do conteúdo Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Detalhes da posição out-stream do conteúdo Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Detalhes do tipo de dispositivo. Este campo será preenchido quando targetingType for TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Detalhes da segmentação por público-alvo. Este campo será preenchido quando targetingType for TARGETING_TYPE_AUDIENCE_GROUP. Só é possível segmentar uma opção de grupo de público por recurso.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Detalhes do navegador. Este campo será preenchido quando targetingType for TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Detalhes da renda familiar. Este campo será preenchido quando targetingType for TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Detalhes sobre a posição na tela. Este campo será preenchido quando targetingType for TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalhes da operadora e do ISP. Este campo será preenchido quando targetingType for TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalhes da palavra-chave. Este campo será preenchido quando targetingType for TARGETING_TYPE_KEYWORD.

É possível atribuir no máximo 5.000 palavras-chave negativas diretas a um recurso. Não há limite para o número de palavras-chave positivas que podem ser atribuídas.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Detalhes da palavra-chave. Este campo será preenchido quando targetingType for TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

É possível atribuir no máximo quatro listas de palavras-chave negativas a um recurso.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Detalhes do sistema operacional. Este campo será preenchido quando targetingType for TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Detalhes da marca e do modelo do dispositivo Este campo será preenchido quando targetingType for TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Detalhes do ambiente. Este campo será preenchido quando targetingType for TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Detalhes da origem de inventário. Este campo será preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Detalhes da categoria. Este campo será preenchido quando targetingType for TARGETING_TYPE_CATEGORY.

A segmentação de uma categoria também segmenta suas subcategorias. Se uma categoria for excluída da segmentação e uma subcategoria for incluída, a exclusão prevalecerá.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalhes de visibilidade. Este campo será preenchido quando targetingType for TARGETING_TYPE_VIEWABILITY.

Só é possível segmentar uma opção de visibilidade por recurso.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Detalhes do status do vendedor autorizado. Este campo será preenchido quando targetingType for TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Só é possível segmentar uma opção de status de vendedor autorizado por recurso.

Se um recurso não tiver uma opção de status de vendedor autorizado, todos os vendedores autorizados indicados como DIRETO ou REVENDEDOR no arquivo ads.txt serão segmentados por padrão.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Detalhes do idioma. Este campo será preenchido quando targetingType for TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Detalhes da região geográfica. Este campo será preenchido quando targetingType for TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalhes do grupo de origem de inventário. Este campo será preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalhes da classificação de conteúdo digital Este campo será preenchido quando targetingType for TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

As classificações de conteúdo digital são exclusões de segmentação. As exclusões de classificação de conteúdo digital no nível do anunciante, se definidas, são sempre aplicadas na veiculação, mesmo que não estejam visíveis nas configurações de recursos. As configurações de recursos podem excluir classificações de conteúdo e de anunciantes, mas não podem modificá-las. Um item de linha não será veiculado se todas as classificações de conteúdo digital forem excluídas.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Detalhes da categoria sensível. Este campo será preenchido quando targetingType for TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

As categorias sensíveis são exclusões de segmentação. As exclusões de categoria sensível no nível do anunciante, se definidas, são sempre aplicadas na veiculação, mesmo que não estejam visíveis nas configurações de recursos. As configurações de recursos podem excluir categorias sensíveis, além de exclusões de anunciantes, mas não podem substituí-las.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalhes da troca. Este campo será preenchido quando targetingType for TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Detalhes da subtroca. Este campo será preenchido quando targetingType for TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Detalhes da verificação de terceiros. Este campo será preenchido quando targetingType for TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Detalhes do PDI. Este campo será preenchido quando targetingType for TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Detalhes da rede de negócios. Este campo será preenchido quando targetingType for TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Detalhes da duração do conteúdo. Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Detalhes da duração do conteúdo. Esse campo será preenchido quando o TargetingType for TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Detalhes da posição do conteúdo nativo. Este campo será preenchido quando targetingType for TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Detalhes do inventário com Open Measurement ativado. Este campo será preenchido quando targetingType for TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Detalhes do tipo de conteúdo de áudio. Este campo será preenchido quando targetingType for TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Detalhes do gênero do conteúdo. Este campo será preenchido quando targetingType for TARGETING_TYPE_CONTENT_GENRE.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Detalhes do vídeo do YouTube. Este campo será preenchido quando targetingType for TARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Detalhes do canal do YouTube. Este campo será preenchido quando targetingType for TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Detalhes sobre a posição na sessão. Este campo será preenchido quando targetingType for TARGETING_TYPE_SESSION_POSITION.

Herança

Indica se a opção de segmentação atribuída é herdada de uma entidade de nível superior, como um parceiro ou um anunciante. As opções de segmentação atribuídas herdadas têm precedência, são sempre aplicadas na veiculação em vez da segmentação atribuída no nível atual e não podem ser modificadas pelo serviço da entidade atual. Eles precisam ser modificados pelo serviço de entidade do qual são herdados. A herança só se aplica a canais segmentados negativamente, exclusões de categorias sensíveis e exclusões de classificação de conteúdo digital se elas forem configuradas no nível principal.

Enums
INHERITANCE_UNSPECIFIED A herança não foi especificada ou não é conhecida.
NOT_INHERITED A opção de segmentação atribuída não é herdada da entidade de nível superior.
INHERITED_FROM_PARTNER A opção de segmentação atribuída é herdada das configurações de segmentação do parceiro.
INHERITED_FROM_ADVERTISER A opção de segmentação atribuída é herdada das configurações de segmentação do anunciante.

ChannelAssignedTargetingOptionDetails

Detalhes da opção de segmentação do canal atribuído. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_CHANNEL.

Representação JSON
{
  "channelId": string,
  "negative": boolean
}
Campos
channelId

string (int64 format)

Obrigatório. ID do canal. Deve se referir ao campo de ID do canal em um recurso Canal do parceiro ou canal do anunciante.

negative

boolean

Indica se essa opção está sendo segmentada negativamente. Para a opção de segmentação atribuída no nível do anunciante, este campo precisa ser verdadeiro.

AppCategoryAssignedTargetingOptionDetails

Detalhes da opção de segmentação por categoria de aplicativo atribuída. Isso será preenchido no campo appCategoryDetails de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_APP_CATEGORY.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição da categoria do app.

targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

AppAssignedTargetingOptionDetails

Detalhes da opção de segmentação de app atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_APP.

Representação JSON
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Campos
appId

string

Obrigatório. O ID do aplicativo.

O app da Play Store no Android usa o ID do pacote, por exemplo, com.google.android.gm. O ID do aplicativo da App Store da Apple usa uma string de nove dígitos, por exemplo, 422689480.

displayName

string

Apenas saída. O nome de exibição do app.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

appPlatform

enum (AppPlatform)

Indica a plataforma do aplicativo de destino. Se este campo não for especificado, será considerado que a plataforma do aplicativo é móvel (por exemplo, Android ou iOS), e derivaremos a plataforma móvel adequada do ID do aplicativo.

AppPlatform

Possíveis opções de segmentação de plataformas de aplicativos.

Enums
APP_PLATFORM_UNSPECIFIED Valor padrão quando a plataforma do app não está especificada nesta versão. Esse enum é um marcador de posição para o valor padrão e não representa uma opção de plataforma real.
APP_PLATFORM_IOS A plataforma do aplicativo é iOS.
APP_PLATFORM_ANDROID A plataforma do app é Android.
APP_PLATFORM_ROKU A plataforma de apps é a Roku.
APP_PLATFORM_AMAZON_FIRETV A plataforma do app é o Amazon FireTV.
APP_PLATFORM_PLAYSTATION A plataforma do app é o Playstation.
APP_PLATFORM_APPLE_TV A plataforma do app é a Apple TV.
APP_PLATFORM_XBOX A plataforma do app é Xbox.
APP_PLATFORM_SAMSUNG_TV A plataforma do app é a Samsung TV.
APP_PLATFORM_ANDROID_TV A plataforma do app é a Android TV.
APP_PLATFORM_GENERIC_CTV A plataforma do app é uma plataforma de smart TV que não está listada explicitamente em outro lugar.

UrlAssignedTargetingOptionDetails

Detalhes da opção de segmentação por URL atribuído Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_URL.

Representação JSON
{
  "url": string,
  "negative": boolean
}
Campos
url

string

Obrigatório. O URL, por exemplo: example.com.

O DV360 é compatível com dois níveis de segmentação de subdiretório, por exemplo, www.example.com/one-subdirectory-level/second-level, e cinco níveis de segmentação de subdomínio, por exemplo, five.four.three.two.one.example.com.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

DayAndTimeAssignedTargetingOptionDetails

Representação de um segmento de tempo definido em um dia específico da semana e com um horário de início e de término. O horário representado por startHour precisa ser anterior ao horário representado por endHour.

Representação JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Campos
dayOfWeek

enum (DayOfWeek)

Obrigatório. É o dia da semana dessa configuração de segmentação por dia e hora.

startHour

integer

Obrigatório. É a hora de início da segmentação por dia e hora. Precisa ser entre 0 (início do dia) e 23 (1 hora antes do fim do dia).

endHour

integer

Obrigatório. A hora de término da segmentação por dia e hora. Precisa ser entre 1 (1 hora após o início do dia) e 24 (fim do dia).

timeZoneResolution

enum (TimeZoneResolution)

Obrigatório. O mecanismo usado para determinar qual fuso horário usar para essa configuração de segmentação de dia e hora.

DayOfWeek

Representa um dia da semana.

Enums
DAY_OF_WEEK_UNSPECIFIED O dia da semana não é especificado.
MONDAY Segunda-feira
TUESDAY Terça-feira
WEDNESDAY Quarta-feira
THURSDAY Quinta-feira
FRIDAY Sexta-feira
SATURDAY Sábado
SUNDAY Domingo

TimeZoneResolution

Possíveis abordagens para determinar o fuso horário.

Enums
TIME_ZONE_RESOLUTION_UNSPECIFIED A resolução de fuso horário não é específica ou é desconhecida.
TIME_ZONE_RESOLUTION_END_USER Os horários são definidos de acordo com o fuso horário do usuário que viu o anúncio.
TIME_ZONE_RESOLUTION_ADVERTISER Os horários são definidos de acordo com o fuso horário do anunciante que veiculou o anúncio.

AgeRangeAssignedTargetingOptionDetails

Representa uma faixa etária segmentável. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_AGE_RANGE.

Representação JSON
{
  "ageRange": enum (AgeRange)
}
Campos
ageRange

enum (AgeRange)

Obrigatório. A faixa etária de um público-alvo. Só é possível segmentar uma faixa etária contínua de um público-alvo. Assim, a faixa etária representada neste campo pode ser 1) segmentada apenas ou, 2) parte de uma faixa etária contínua mais ampla. O alcance de uma segmentação contínua por faixa etária pode ser ampliado com a segmentação de um público-alvo de idade desconhecida.

RegionalLocationListAssignedTargetingOptionDetails

Detalhes de segmentação para a lista de locais regionais. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_REGIONAL_LOCATION_LIST.

Representação JSON
{
  "regionalLocationListId": string,
  "negative": boolean
}
Campos
regionalLocationListId

string (int64 format)

Obrigatório. ID da lista de locais regionais. Precisa se referir ao campo locationListId de um recurso LocationList com o tipo TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

ProximityLocationListAssignedTargetingOptionDetails

Detalhes de segmentação para a lista de locais próximos. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

Representação JSON
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Campos
proximityLocationListId

string (int64 format)

Obrigatório. ID da lista de locais próximos. Precisa se referir ao campo locationListId de um recurso LocationList com o tipo TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadius

number

Obrigatório. Raio expresso nas unidades de distância definidas em proximityRadiusUnit. Representa o tamanho da área ao redor de um local escolhido que será segmentado. O raio deve estar entre 1 e 500 milhas ou 800 quilômetros.

proximityRadiusUnit

enum (ProximityRadiusUnit)

Obrigatório. Unidades de distância do raio.

ProximityRadiusUnit

Enumeração de unidades de distância para NearbyRadius.

Enums
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Valor padrão quando as unidades de distância não são especificadas nesta versão. Esse tipo enumerado é um espaço reservado para o valor padrão e não representa uma unidade real de distância.
PROXIMITY_RADIUS_UNIT_MILES Unidade de distância do raio em milhas.
PROXIMITY_RADIUS_UNIT_KILOMETERS Unidade de distância do raio em quilômetros

GenderAssignedTargetingOptionDetails

Detalhes da opção de segmentação por gênero atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_GENDER.

Representação JSON
{
  "gender": enum (Gender)
}
Campos
gender

enum (Gender)

Obrigatório. O gênero do público.

VideoPlayerSizeAssignedTargetingOptionDetails

Detalhes da opção de segmentação do tamanho do player de vídeo. Isso será preenchido no campo videoPlayerSizeDetails quando targetingType for TARGETING_TYPE_VIDEO_PLAYER_SIZE. Não é possível segmentar explicitamente todas as opções. Remova todas as opções de segmentação por tamanho do player de vídeo para conseguir esse efeito.

Representação JSON
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Campos
videoPlayerSize

enum (VideoPlayerSize)

Obrigatório. É o tamanho do player de vídeo.

UserRewardedContentAssignedTargetingOptionDetails

Detalhes da opção de segmentação de conteúdo premiado pelo usuário. Isso será preenchido no campo userRewardedContentDetails quando targetingType for TARGETING_TYPE_USER_REWARDED_CONTENT.

Representação JSON
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
Campos
targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_USER_REWARDED_CONTENT.

userRewardedContent

enum (UserRewardedContent)

Apenas saída. Status do conteúdo premiado pelo usuário para anúncios em vídeo.

ParentalStatusAssignedTargetingOptionDetails

Detalhes da opção de segmentação de status parental atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_PARENTAL_STATUS.

Representação JSON
{
  "parentalStatus": enum (ParentalStatus)
}
Campos
parentalStatus

enum (ParentalStatus)

Obrigatório. O status parental do público-alvo.

ContentInstreamPositionAssignedTargetingOptionDetails

Detalhes da opção de segmentação por posição in-stream do conteúdo atribuído. Isso será preenchido no campo contentInstreamPositionDetails quando targetingType for TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Representação JSON
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
Campos
contentInstreamPosition

enum (ContentInstreamPosition)

Obrigatório. A posição do in-stream do conteúdo para anúncios em vídeo ou áudio.

adType

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Aplicável somente à segmentação de pedidos de inserção, e os novos itens de linha compatíveis com o tipo de anúncio especificado herdarão essa opção de segmentação por padrão. Os valores possíveis são:

  • AD_TYPE_VIDEO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Representa o tipo de criativo associado aos anúncios.

Enums
AD_TYPE_UNSPECIFIED O tipo de anúncio não foi especificado ou é desconhecido nesta versão.
AD_TYPE_DISPLAY Criativos de display, por exemplo, de imagem e HTML5.
AD_TYPE_VIDEO Criativos de vídeo, por exemplo, anúncios em vídeo reproduzidos durante o streaming de conteúdo em players de vídeo.
AD_TYPE_AUDIO Criativos em áudio, por exemplo, anúncios em áudio reproduzidos durante um conteúdo em áudio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Detalhes da opção de segmentação por posição out-stream do conteúdo atribuído Isso será preenchido no campo contentOutstreamPositionDetails quando targetingType for TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Representação JSON
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Campos
contentOutstreamPosition

enum (ContentOutstreamPosition)

Obrigatório. A posição out-stream do conteúdo.

adType

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Aplicável somente à segmentação de pedidos de inserção, e os novos itens de linha compatíveis com o tipo de anúncio especificado herdarão essa opção de segmentação por padrão. Os valores possíveis são:

  • AD_TYPE_DISPLAY, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Detalhes de segmentação por tipo de dispositivo. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_DEVICE_TYPE.

Representação JSON
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
Campos
deviceType

enum (DeviceType)

Obrigatório. O nome de exibição do tipo de dispositivo.

youtubeAndPartnersBidMultiplier

number

Apenas saída. Com o multiplicador de lances, você pode exibir seus anúncios com maior ou menor frequência com base no tipo de dispositivo. Ele vai aplicar um multiplicador ao preço do lance original. Quando esse campo é 0, significa que ele não é aplicável, em vez de multiplicar 0 no preço do lance original.

Por exemplo, se o preço do lance sem multiplicador for US $10,0 e o multiplicador for 1,5 para "Tablet", o preço do lance resultante para "Tablet" será de US $15,0.

Aplicável somente a itens de linha do YouTube e parceiros.

AudienceGroupAssignedTargetingOptionDetails

Detalhes da opção de segmentação do grupo de compartilhamento atribuído. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_AUDIENCE_GROUP. A relação entre cada grupo é UNION, exceto o "excludedFirstAndThirdPartyAudienceGroup" e de "excludedGoogleAudienceGroup", em que COMPLEMENT é usado como um drawable com outros grupos.

Representação JSON
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
Campos
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

Os IDs e os recebimentos de público-alvo primário e de terceiros e os grupos de público-alvo próprios e de terceiros incluídos. Cada grupo de público-alvo primário e de terceiros contém somente IDs de público-alvo próprios e de terceiros. A relação entre cada grupo de público-alvo primário e de terceiros é objetiva e o resultado é unido a outros grupos de público-alvo. Grupos repetidos com as mesmas configurações serão ignorados.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Os IDs de público-alvo do Google do grupo de público-alvo do Google incluído. Contém apenas IDs de público-alvo do Google.

includedCustomListGroup

object (CustomListGroup)

Os IDs das listas personalizadas do grupo de listas personalizadas incluído. Contém apenas IDs de listas personalizados.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Os IDs de público-alvo combinado do grupo de público-alvo combinado incluído. Contém apenas IDs de público-alvo combinados.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Os IDs de público-alvo primário e de terceiros e as atualizações do grupo de públicos-alvo primário e de terceiros excluído. Usado para segmentação negativa. O COMPLEMENTO da união desse e de outros grupos de públicos-alvo excluídos é usado como um incentivo para qualquer segmentação positiva por público-alvo. Todos os itens são logicamente "OU" uns dos outros.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Os IDs de público-alvo do Google do grupo de público-alvo excluído. Usado para segmentação negativa. O COMPLEMENTO da união desse e de outros grupos de públicos-alvo excluídos é usado como um incentivo para qualquer segmentação positiva por público-alvo. Contém somente públicos-alvo do Google de afinidade, no mercado e apps instalados. Todos os itens são logicamente "OU" uns dos outros.

FirstAndThirdPartyAudienceGroup

Detalhes do grupo de público-alvo próprio e de terceiros. Todas as configurações de segmentação por público-alvo próprias e de terceiros usam "OU" logicamente umas das outras.

Representação JSON
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
Campos
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação por público-alvo próprio e de terceiros no grupo de público-alvo próprio e de terceiros. Configurações repetidas com o mesmo ID não são permitidas.

FirstAndThirdPartyAudienceTargetingSetting

Detalhes da configuração da segmentação de público-alvo próprio e de terceiros.

Representação JSON
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
Campos
firstAndThirdPartyAudienceId

string (int64 format)

Obrigatório. ID do público-alvo próprio e de terceiros da configuração de segmentação por público-alvo próprio e de terceiros. Esse ID é firstAndThirdPartyAudienceId.

recency

enum (Recency)

O tempo para retorno da configuração de segmentação de público-alvo próprio e de terceiros. Aplicável apenas a públicos-alvo próprios. Caso contrário, ele será ignorado. Para mais informações, consulte https://support.google.com/displayvideo/answer/2949947#recency. Quando não for especificado, nenhum limite de tempo para retorno será usado.

Tempo para retorno

Todos os valores de recência da audiência primária e de terceiros suportados.

Enums
RECENCY_NO_LIMIT Sem limite de tempo para retorno.
RECENCY_1_MINUTE O tempo para retorno é de 1 minuto.
RECENCY_5_MINUTES O tempo para retorno é de 5 minutos.
RECENCY_10_MINUTES O tempo para retorno é de 10 minutos.
RECENCY_15_MINUTES O tempo para retorno é de 15 minutos.
RECENCY_30_MINUTES O tempo para retorno é de 30 minutos.
RECENCY_1_HOUR O tempo para retorno é de 1 hora.
RECENCY_2_HOURS O tempo para retorno é de 2 horas.
RECENCY_3_HOURS O tempo para retorno é de 3 horas.
RECENCY_6_HOURS O tempo para retorno é de 6 horas.
RECENCY_12_HOURS O tempo para retorno é de 12 horas.
RECENCY_1_DAY O tempo para retorno é de 1 dia.
RECENCY_2_DAYS O tempo para retorno é de dois dias.
RECENCY_3_DAYS O tempo para retorno é de três dias.
RECENCY_5_DAYS O tempo para retorno é de 5 dias.
RECENCY_7_DAYS O tempo para retorno é de 7 dias.
RECENCY_10_DAYS O tempo para retorno é de 10 dias.
RECENCY_14_DAYS O tempo para retorno é de 14 dias.
RECENCY_15_DAYS O tempo para retorno é de 15 dias.
RECENCY_21_DAYS O tempo para retorno é de 21 dias.
RECENCY_28_DAYS O tempo para retorno é de 28 dias.
RECENCY_30_DAYS O tempo para retorno é de 30 dias.
RECENCY_40_DAYS O tempo para retorno é de 40 dias.
RECENCY_45_DAYS O tempo para retorno é de 45 dias.
RECENCY_60_DAYS O tempo para retorno é de 60 dias.
RECENCY_90_DAYS O tempo para retorno é de 90 dias.
RECENCY_120_DAYS O tempo para retorno é de 120 dias.
RECENCY_180_DAYS O tempo para retorno é de 180 dias.
RECENCY_270_DAYS O tempo para retorno é de 270 dias.
RECENCY_365_DAYS O tempo para retorno é de 365 dias.

GoogleAudienceGroup

Detalhes do grupo de público-alvo do Google. Todas as configurações de segmentação por público-alvo do Google usam "OU" umas das outras de maneira lógica.

Representação JSON
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Campos
settings[]

object (GoogleAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação por público-alvo do Google no grupo de público-alvo do Google. Configurações repetidas com o mesmo ID serão ignoradas.

GoogleAudienceTargetingSetting

Detalhes da configuração da segmentação por público-alvo do Google.

Representação JSON
{
  "googleAudienceId": string
}
Campos
googleAudienceId

string (int64 format)

Obrigatório. É o ID de público-alvo do Google referente à configuração de segmentação por público-alvo do Google. Esse ID é googleAudienceId.

CustomListGroup

Detalhes do grupo de listas personalizadas. Todas as configurações de segmentação de listas personalizadas são logicamente "OU" umas das outras.

Representação JSON
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Campos
settings[]

object (CustomListTargetingSetting)

Obrigatório. Todas as configurações de segmentação de lista personalizada no grupo de listas personalizadas. Configurações repetidas com o mesmo ID serão ignoradas.

CustomListTargetingSetting

Detalhes da configuração da segmentação por lista personalizada

Representação JSON
{
  "customListId": string
}
Campos
customListId

string (int64 format)

Obrigatório. ID personalizado da configuração de segmentação da lista personalizada. Esse ID é customListId.

CombinedAudienceGroup

Detalhes do grupo de público-alvo combinado. Todas as configurações de segmentação por público-alvo combinada são logicamente "OU" umas das outras.

Representação JSON
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Campos
settings[]

object (CombinedAudienceTargetingSetting)

Obrigatório. Todas as configurações de segmentação por público-alvo combinada no grupo de públicos-alvo combinados. Configurações repetidas com o mesmo ID serão ignoradas. O número de configurações de público-alvo combinado não pode ser maior que cinco. Caso contrário, um erro será gerado.

CombinedAudienceTargetingSetting

Detalhes da configuração da segmentação por público-alvo combinado.

Representação JSON
{
  "combinedAudienceId": string
}
Campos
combinedAudienceId

string (int64 format)

Obrigatório. É o ID do público-alvo combinado da configuração da segmentação por público-alvo combinado. Esse ID é combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Detalhes da opção de segmentação por navegador atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_BROWSER.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição do navegador.

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_BROWSER.

negative

boolean

Indica se essa opção está sendo segmentada negativamente. Todas as opções de segmentação por navegador atribuídas no mesmo recurso precisam ter o mesmo valor nesse campo.

HouseholdIncomeAssignedTargetingOptionDetails

Detalhes da opção de segmentação por renda familiar atribuída Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_HOUSEHOLD_INCOME.

Representação JSON
{
  "householdIncome": enum (HouseholdIncome)
}
Campos
householdIncome

enum (HouseholdIncome)

Obrigatório. A renda familiar do público-alvo.

OnScreenPositionAssignedTargetingOptionDetails

Detalhes da opção de segmentação por posição na tela. Isso será preenchido no campo onScreenPositionDetails quando targetingType for TARGETING_TYPE_ON_SCREEN_POSITION.

Representação JSON
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
Campos
targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Apenas saída. A posição na tela.

adType

enum (AdType)

Apenas saída. O tipo de anúncio a ser segmentado. Aplicável somente à segmentação de pedidos de inserção, e os novos itens de linha compatíveis com o tipo de anúncio especificado herdarão essa opção de segmentação por padrão. Os valores possíveis são:

  • AD_TYPE_DISPLAY, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, a configuração será herdada pelo novo item de linha quando lineItemType for LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Detalhes da opção de segmentação por operadora e ISP atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_CARRIER_AND_ISP.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição da operadora ou do ISP.

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Indica se essa opção está sendo segmentada negativamente. Todas as opções de segmentação por operadora e ISP atribuídas no mesmo recurso precisam ter o mesmo valor para esse campo.

KeywordAssignedTargetingOptionDetails

Detalhes da opção de segmentação por palavras-chave atribuídas. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_KEYWORD.

Representação JSON
{
  "keyword": string,
  "negative": boolean
}
Campos
keyword

string

Obrigatório. A palavra-chave, por exemplo: car insurance.

A palavra-chave positiva não pode ser uma palavra ofensiva. Ser codificado em UTF-8 com um tamanho máximo de 255 bytes. O número máximo de caracteres é 80. O número máximo de palavras é 10.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

NegativeKeywordListAssignedTargetingOptionDetails

Detalhes de segmentação da lista de palavras-chave negativas. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Representação JSON
{
  "negativeKeywordListId": string
}
Campos
negativeKeywordListId

string (int64 format)

Obrigatório. ID da lista de palavras-chave negativas. Precisa se referir ao campo negativeKeywordListId de um recurso NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Detalhes da opção de segmentação por sistema operacional atribuída. Isso será preenchido no campo operatingSystemDetails quando targetingType for TARGETING_TYPE_OPERATING_SYSTEM.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição do sistema operacional.

targetingOptionId

string

Obrigatório. O ID da opção de segmentação preenchido no campo targetingOptionId quando targetingType é TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

DeviceMakeModelAssignedTargetingOptionDetails

Detalhes da opção de segmentação do modelo e da marca do dispositivo atribuído. Isso será preenchido no campo deviceMakeModelDetails quando targetingType for TARGETING_TYPE_DEVICE_MAKE_MODEL.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição da marca e do modelo do dispositivo.

targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

EnvironmentAssignedTargetingOptionDetails

Detalhes da opção de segmentação por ambiente atribuído. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_ENVIRONMENT.

Representação JSON
{
  "environment": enum (Environment)
}
Campos
environment

enum (Environment)

Obrigatório. O ambiente de exibição.

InventorySourceAssignedTargetingOptionDetails

Detalhes de segmentação da origem de inventário. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE.

Representação JSON
{
  "inventorySourceId": string
}
Campos
inventorySourceId

string (int64 format)

Obrigatório. ID da origem de inventário. Precisa se referir ao campo inventorySourceId de um recurso InventorySource.

CategoryAssignedTargetingOptionDetails

Detalhes da opção de segmentação por categoria atribuída. Isso será preenchido no campo categoryDetails quando targetingType for TARGETING_TYPE_CATEGORY.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição da categoria.

targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CATEGORY.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

ViewabilityAssignedTargetingOptionDetails

Detalhes da opção de segmentação de visibilidade atribuída Isso será preenchido no campo viewabilityDetails de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_VIEWABILITY.

Representação JSON
{
  "viewability": enum (Viewability)
}
Campos
viewability

enum (Viewability)

Obrigatório. É a porcentagem de visibilidade prevista.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Representa um status de vendedor autorizado atribuído. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Se um recurso não tiver uma opção de segmentação atribuída a TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, ele está usando a opção "Vendedores diretos e revendedores autorizados".

Representação JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
Campos
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Apenas saída. O status do vendedor autorizado a ser segmentado.

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Detalhes da opção de segmentação por idioma atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_LANGUAGE.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição do idioma (por exemplo, "francês").

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_LANGUAGE.

negative

boolean

Indica se essa opção está sendo segmentada negativamente. Todas as opções de segmentação por idioma atribuídas no mesmo recurso precisam ter o mesmo valor neste campo.

GeoRegionAssignedTargetingOptionDetails

Detalhes da opção de segmentação por região geográfica atribuída Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_GEO_REGION.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
Campos
displayName

string

Apenas saída. O nome de exibição da região geográfica (por exemplo, "Ontário, Canadá").

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

Apenas saída. O tipo de segmentação por região geográfica.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

InventorySourceGroupAssignedTargetingOptionDetails

Detalhes de segmentação do grupo de origem de inventário. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

Representação JSON
{
  "inventorySourceGroupId": string
}
Campos
inventorySourceGroupId

string (int64 format)

Obrigatório. ID do grupo de origem de inventário. Precisa se referir ao campo inventorySourceGroupId de um recurso InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Detalhes de segmentação para classificação de conteúdo digital. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Representação JSON
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
Campos
excludedContentRatingTier

enum (ContentRatingTier)

Obrigatório. O nome de exibição da classificação de classificação de conteúdo digital a ser EXCLUÍDA.

SensitiveCategoryAssignedTargetingOptionDetails

Detalhes de segmentação da categoria sensível. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Representação JSON
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
Campos
excludedSensitiveCategory

enum (SensitiveCategory)

Obrigatório. Uma enumeração para o conteúdo da categoria sensível do DV360 classificado como EXCLUÍDO.

ExchangeAssignedTargetingOptionDetails

Detalhes da opção de segmentação de troca atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_EXCHANGE.

Representação JSON
{
  "exchange": enum (Exchange)
}
Campos
exchange

enum (Exchange)

Obrigatório. O valor da enumeração para a troca.

SubExchangeAssignedTargetingOptionDetails

Detalhes da opção de segmentação de subtrocas atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_SUB_EXCHANGE.

Representação JSON
{
  "targetingOptionId": string
}
Campos
targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Detalhes da opção de segmentação do verificador de terceiros atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Representação JSON
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Campos
Campo de união verifier. Pode segmentar um verificador de terceiros para impor limites de brand safety para impressões. verifier pode ser apenas de um dos tipos a seguir:
adloox

object (Adloox)

Verificador de marca de terceiros: Adloox.

doubleVerify

object (DoubleVerify)

Verificador de marca de terceiros: DoubleVerify.

integralAdScience

object (IntegralAdScience)

Verificador de marca de terceiros: Integral Ad Science.

Adloox

Detalhes das configurações da Adloox.

Representação JSON
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
Campos
excludedAdlooxCategories[]

enum (AdlooxCategory)

Configurações de brand safety da Adloox.

AdlooxCategory

Possíveis opções do Adloox.

Enums
ADLOOX_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica nenhuma opção da Adloox.
ADULT_CONTENT_HARD Conteúdo adulto (difícil).
ADULT_CONTENT_SOFT Conteúdo adulto (leve).
ILLEGAL_CONTENT Conteúdo ilegal.
BORDERLINE_CONTENT Conteúdo duvidoso.
DISCRIMINATORY_CONTENT Conteúdo discriminatório.
VIOLENT_CONTENT_WEAPONS Conteúdo violento e armas.
LOW_VIEWABILITY_DOMAINS Domínios com baixa visibilidade.
FRAUD Fraude.

DoubleVerify

Detalhes das configurações da DoubleVerify.

Representação JSON
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Campos
brandSafetyCategories

object (BrandSafetyCategories)

Controles de brand safety da DV.

avoidedAgeRatings[]

enum (AgeRating)

Evite dar lances em apps com classificação etária.

appStarRating

object (AppStarRating)

Evite dar lances em aplicativos com notas.

displayViewability

object (DisplayViewability)

Configurações de visibilidade de display (aplicáveis somente a itens de linha de display).

videoViewability

object (VideoViewability)

Configurações de visibilidade dos vídeos (aplicáveis somente a itens de linha de vídeo).

fraudInvalidTraffic

object (FraudInvalidTraffic)

Evite sites e apps com histórico de fraudes e taxas de tráfego inválido.

customSegmentId

string (int64 format)

O ID do segmento personalizado fornecido pela DoubleVerify. O ID precisa começar com "51" e ter oito dígitos. O ID do segmento personalizado não pode ser especificado com nenhum dos seguintes campos:

BrandSafetyCategories

Configurações dos controles de brand safety.

Representação JSON
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Campos
avoidUnknownBrandSafetyCategory

boolean

Desconhecido ou sem classificação.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Categorias de rejeição de alta gravidade de brand safety.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Categorias de rejeição de gravidade média de brand safety.

HighSeverityCategory

Possíveis opções para categorias de alta gravidade.

Enums
HIGHER_SEVERITY_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica nenhuma categoria de gravidade alta.
ADULT_CONTENT_PORNOGRAPHY Conteúdo adulto: pornografia, tópicos adultos e nudez.
COPYRIGHT_INFRINGEMENT Violação de direitos autorais.
SUBSTANCE_ABUSE Drogas/álcool/substâncias controladas: abuso de substâncias.
GRAPHIC_VIOLENCE_WEAPONS Imagens extremas/violência explícita/armas.
HATE_PROFANITY Ódio/Linguagem obscena.
CRIMINAL_SKILLS Atividades ilegais: habilidades criminosas.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Conteúdo incentivado/Malware/Deslocamento.

MediumSeverityCategory

Possíveis opções para categorias de gravidade média.

Enums
MEDIUM_SEVERITY_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica nenhuma categoria de gravidade média.
AD_SERVERS Servidores de anúncios.
ADULT_CONTENT_SWIMSUIT Conteúdo adulto: maiô.
ALTERNATIVE_LIFESTYLES Assuntos polêmicos: estilos de vida alternativos.
CELEBRITY_GOSSIP Assuntos controversos: fofocas sobre celebridades.
GAMBLING Assuntos polêmicos: jogos de azar.
OCCULT Assuntos polêmicos: ocultismo.
SEX_EDUCATION Assuntos controversos: educação sexual.
DISASTER_AVIATION Desastre: aviação.
DISASTER_MAN_MADE Desastre: causado pelo homem.
DISASTER_NATURAL Desastre: natural.
DISASTER_TERRORIST_EVENTS Desastre: eventos terroristas.
DISASTER_VEHICLE Desastre: veículo.
ALCOHOL Drogas/álcool/substâncias controladas: álcool.
SMOKING Drogas/álcool/substâncias controladas: fumo.
NEGATIVE_NEWS_FINANCIAL Notícias negativas: finanças.
NON_ENGLISH Conteúdo padrão: não inglês.
PARKING_PAGE Conteúdo não padrão: página de estacionamento.
UNMODERATED_UGC UGC não moderado: fóruns, imagens e vídeos.
INFLAMMATORY_POLITICS_AND_NEWS Assuntos polêmicos: notícias e assuntos polêmicos.
NEGATIVE_NEWS_PHARMACEUTICAL Notícias negativas: produtos farmacêuticos.

AgeRating

Possíveis opções de classificação etária.

Enums
AGE_RATING_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de classificação etária.
APP_AGE_RATE_UNKNOWN Apps com classificação etária desconhecida.
APP_AGE_RATE_4_PLUS Aplicativos para todos (maiores de 4 anos).
APP_AGE_RATE_9_PLUS Aplicativos para todos (maiores de 9 anos).
APP_AGE_RATE_12_PLUS Aplicativos classificados para adolescentes (maiores de 12 anos).
APP_AGE_RATE_17_PLUS Aplicativos para adultos (maiores de 17 anos).
APP_AGE_RATE_18_PLUS Aplicativos somente para adultos (maiores de 18 anos).

AppStarRating

Detalhes das configurações de avaliação com estrelas da DoubleVerify.

Representação JSON
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Campos
avoidedStarRating

enum (StarRating)

Evite dar lances em aplicativos com notas.

avoidInsufficientStarRating

boolean

Evite dar lances em aplicativos com avaliações insuficientes.

StarRating

Possíveis opções de avaliação com estrelas.

Enums
APP_STAR_RATE_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de avaliação com estrelas do app.
APP_STAR_RATE_1_POINT_5_LESS Aplicativos oficiais com avaliação de 1,5 estrela.
APP_STAR_RATE_2_LESS Aplicativos oficiais com avaliação de < 2 estrelas.
APP_STAR_RATE_2_POINT_5_LESS Aplicativos oficiais com avaliação de 2,5 estrelas ou menos.
APP_STAR_RATE_3_LESS Aplicativos oficiais com avaliação de 3 estrelas ou menos.
APP_STAR_RATE_3_POINT_5_LESS Aplicativos oficiais com avaliação de 3,5 estrelas ou menos.
APP_STAR_RATE_4_LESS Aplicativos oficiais com avaliação de < 4 estrelas.
APP_STAR_RATE_4_POINT_5_LESS Aplicativos oficiais com avaliação de 4,5 estrelas ou menos.

DisplayViewability

Detalhes das configurações de visibilidade de exibição da DoubleVerify.

Representação JSON
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Campos
iab

enum (IAB)

Segmente o inventário da Web e do app para maximizar a taxa visível do IAB.

viewableDuring

enum (ViewableDuring)

Segmente o inventário da Web e do app para maximizar 100% da duração da visualização.

IAB

Possíveis opções de taxa visível do IAB.

Enums
IAB_VIEWED_RATE_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica nenhuma opção de taxa visualizada do IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 80% ou mais.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 75% ou mais.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 70% ou mais.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 65% ou mais.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 60% ou mais.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa visível do IAB em 55% ou mais.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa visível do IAB em 50% ou mais.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 40% ou mais.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa visível do IAB em 30% ou mais.

ViewableDuring

Possíveis opções de duração visível.

Enums
AVERAGE_VIEW_DURATION_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de duração média da visualização.
AVERAGE_VIEW_DURATION_5_SEC Segmente o inventário da Web e do app para maximizar 100% de duração visível por 5 segundos ou mais.
AVERAGE_VIEW_DURATION_10_SEC Segmente o inventário da Web e do app para maximizar 100% de duração da visualização por 10 segundos ou mais.
AVERAGE_VIEW_DURATION_15_SEC Segmente o inventário da Web e do app para maximizar 100% de duração visível por 15 segundos ou mais.

VideoViewability

Detalhes das configurações de visibilidade de vídeos da DoubleVerify.

Representação JSON
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Campos
videoIab

enum (VideoIAB)

Segmente o inventário da Web para maximizar a taxa visível do IAB.

videoViewableRate

enum (VideoViewableRate)

Segmente o inventário da Web para maximizar a taxa de visibilidade total.

playerImpressionRate

enum (PlayerImpressionRate)

Segmente o inventário para maximizar as impressões com um player de 400 x 300 ou mais.

VideoIAB

Possíveis opções de taxa visível do IAB.

Enums
VIDEO_IAB_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica opções de taxa visível do IAB de vídeo.
IAB_VIEWABILITY_80_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 80% ou mais.
IAB_VIEWABILITY_75_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 75% ou mais.
IAB_VIEWABILITY_70_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 70% ou mais.
IAB_VIEWABILITY_65_PERCENT_HIHGER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 65% ou mais.
IAB_VIEWABILITY_60_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 60% ou mais.
IAB_VIEWABILITY_55_PERCENT_HIHGER Segmente o inventário da Web e do app para maximizar a taxa visível do IAB em 55% ou mais.
IAB_VIEWABILITY_50_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa visível do IAB em 50% ou mais.
IAB_VIEWABILITY_40_PERCENT_HIHGER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade do IAB em 40% ou mais.
IAB_VIEWABILITY_30_PERCENT_HIHGER Segmente o inventário da Web e do app para maximizar a taxa visível do IAB em 30% ou mais.

VideoViewableRate

Possíveis opções de taxa totalmente visível.

Enums
VIDEO_VIEWABLE_RATE_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de taxa de visibilidade do vídeo.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Segmente o inventário da Web para maximizar a taxa de visibilidade total em 40% ou mais.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Segmente o inventário da Web para maximizar a taxa de visibilidade total em 35% ou mais.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Segmente o inventário da Web para maximizar a taxa de visibilidade total em 30% ou mais.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Segmente o inventário da Web para maximizar a taxa de visibilidade total em 25% ou mais.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Segmente o inventário da Web para maximizar a taxa de visibilidade total em 20% ou mais.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Segmente o inventário da Web para maximizar a taxa de visibilidade total em 10% ou mais.

PlayerImpressionRate

Possíveis opções de impressões.

Enums
PLAYER_SIZE_400X300_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de impressão.
PLAYER_SIZE_400X300_95 Sites com mais de 95%das impressões.
PLAYER_SIZE_400X300_70 Sites com mais de 70%das impressões.
PLAYER_SIZE_400X300_25 Sites com mais de 25%das impressões.
PLAYER_SIZE_400X300_5 Sites com mais de 5%das impressões.

FraudInvalidTraffic

Configurações de fraude e tráfego inválido da DoubleVerify.

Representação JSON
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Campos
avoidedFraudOption

enum (FraudOption)

Evite sites e apps com histórico de fraudes e tráfego inválido.

avoidInsufficientOption

boolean

Histórico insuficiente de fraudes e estatísticas de tráfego inválido.

FraudOption

Possíveis opções de histórico de fraude e taxa de IVT.

Enums
FRAUD_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_100 100% de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_50 50% ou mais de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_25 25% ou mais de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_10 10% ou mais de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_8 8% ou mais de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_6 6% ou mais de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_4 4% ou mais de fraude e tráfego inválido.
AD_IMPRESSION_FRAUD_2 2% ou mais de fraude e tráfego inválido.

IntegralAdScience

Detalhes das configurações da Integral Ad Science.

Representação JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
Campos
traqScoreOption

enum (TRAQScore)

Qualidade de publicidade real (aplicável somente a itens de linha de display).

excludeUnrateable

boolean

Brand safety: sem classificação.

excludedAdultRisk

enum (Adult)

Brand safety: conteúdo adulto.

excludedAlcoholRisk

enum (Alcohol)

Brand safety: álcool.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Brand safety: downloads ilegais.

excludedDrugsRisk

enum (Drugs)

Brand safety: drogas.

excludedHateSpeechRisk

enum (HateSpeech)

Brand safety: discurso de ódio.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Brand safety: linguagem ofensiva.

excludedViolenceRisk

enum (Violence)

Brand safety: violência.

excludedGamblingRisk

enum (Gambling)

Brand safety: jogos de azar.

excludedAdFraudRisk

enum (AdFraudPrevention)

Configurações de fraude de anúncios.

displayViewability

enum (DisplayViewability)

Seção "Visibilidade de exibição" (aplicável somente a itens de linha de display).

videoViewability

enum (VideoViewability)

Seção "Visibilidade de vídeo" (aplicável somente a itens de linha de vídeo).

customSegmentId[]

string (int64 format)

O ID do segmento personalizado fornecido pela Integral Ad Science. O ID precisa estar entre 1000001 e 1999999.

TRAQScore

Possíveis intervalos de pontuação TRAQ (qualidade da publicidade verdadeira) da Integral Ad Science.

Enums
TRAQ_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica nenhum verdadeiro Índice de qualidade de publicidade.
TRAQ_250 TRAQ Score de 250-1000.
TRAQ_500 TRAQ Score de 500-1000.
TRAQ_600 TRAQ Score de 600-1000.
TRAQ_700 TRAQ Score de 700-1000.
TRAQ_750 TRAQ Score de 750-1000.
TRAQ_875 TRAQ Score de 875-1000.
TRAQ_1000 TRAQ Score de 1.000.

Adulto

Possíveis opções para adultos do Integral Ad Science.

Enums
ADULT_UNSPECIFIED Este enum é apenas um marcador de posição e não especifica opções para adultos.
ADULT_HR Adulto: excluir risco alto.
ADULT_HMR Adulto: excluir risco alto e moderado.

Bebidas alcoólicas

Possíveis opções de bebidas alcoólicas da Integral Ad Science.

Enums
ALCOHOL_UNSPECIFIED Esta enumeração é apenas um marcador de posição e não especifica opções de bebidas alcoólicas.
ALCOHOL_HR Álcool: excluir risco alto.
ALCOHOL_HMR Álcool: exclua risco alto e moderado.

IllegalDownloads

Possíveis opções de download do Integral Ad Science Illegal.

Enums
ILLEGAL_DOWNLOADS_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica opções de download ilegais.
ILLEGAL_DOWNLOADS_HR Downloads ilegais: exclua risco alto.
ILLEGAL_DOWNLOADS_HMR Downloads ilegais: exclua o risco alto e moderado.

Drogas

Possíveis opções da Integral Ad Science Drugs.

Enums
DRUGS_UNSPECIFIED Esta enumeração é apenas um marcador de posição e não especifica opções de medicamentos.
DRUGS_HR Drogas: excluir risco alto.
DRUGS_HMR Drogas: excluir risco alto e moderado.

HateSpeech

Possíveis opções de discurso de ódio da Integral Ad Science.

Enums
HATE_SPEECH_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica opções de discurso de ódio.
HATE_SPEECH_HR Discurso de ódio: excluir risco alto.
HATE_SPEECH_HMR Discurso de ódio: excluir risco alto e moderado.

OffensiveLanguage

Possíveis opções de linguagem ofensiva do Integral Ad Science.

Enums
OFFENSIVE_LANGUAGE_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de idioma.
OFFENSIVE_LANGUAGE_HR Linguagem ofensiva: excluir risco alto.
OFFENSIVE_LANGUAGE_HMR Linguagem ofensiva: exclua risco alto e moderado.

Violência

Possíveis opções de violência do Integral Ad Science.

Enums
VIOLENCE_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica opções de violência.
VIOLENCE_HR Violência: excluir risco alto.
VIOLENCE_HMR Violência: excluir risco alto e moderado.

Jogos de azar

Possíveis opções de jogos de azar da Integral Ad Science.

Enums
GAMBLING_UNSPECIFIED Este tipo enumerado é apenas um marcador de posição e não especifica opções de jogos de azar.
GAMBLING_HR Jogos de azar: excluir risco alto.
GAMBLING_HMR Jogos de azar: excluir risco alto e moderado.

AdFraudPrevention

Possíveis opções de prevenção contra fraudes do Integral Ad Science Ad.

Enums
SUSPICIOUS_ACTIVITY_UNSPECIFIED Esse tipo enumerado é apenas um marcador de posição e não especifica opções de prevenção contra fraudes de anúncios.
SUSPICIOUS_ACTIVITY_HR Fraude de anúncio: excluir risco alto.
SUSPICIOUS_ACTIVITY_HMR Fraude de anúncio: exclua o risco alto e moderado.

DisplayViewability

Possíveis opções de visibilidade da Rede de Display do Integral Ad Science.

Enums
PERFORMANCE_VIEWABILITY_UNSPECIFIED Esse tipo enumerado é apenas um marcador e não especifica opções de visibilidade de exibição.
PERFORMANCE_VIEWABILITY_40 Segmentar 40% ou mais de visibilidade.
PERFORMANCE_VIEWABILITY_50 Segmentar 50% ou mais de visibilidade.
PERFORMANCE_VIEWABILITY_60 Segmentar 60% ou mais de visibilidade.
PERFORMANCE_VIEWABILITY_70 Segmentar 70% ou mais de visibilidade.

VideoViewability

Possíveis opções de visibilidade de vídeo da Integral Ad Science.

Enums
VIDEO_VIEWABILITY_UNSPECIFIED Esse tipo enumerado é apenas um marcador e não especifica opções de visibilidade de vídeo.
VIDEO_VIEWABILITY_40 Mais de 40%visível (padrão IAB de visibilidade de vídeo).
VIDEO_VIEWABILITY_50 Mais de 50%visível (padrão de visibilidade de vídeo do IAB).
VIDEO_VIEWABILITY_60 Mais de 60%visível (padrão IAB de visibilidade de vídeo).
VIDEO_VIEWABILITY_70 Mais de 70%visível (padrão IAB de visibilidade de vídeo).

PoiAssignedTargetingOptionDetails

Detalhes da opção de segmentação de PDI atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_POI.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Campos
displayName

string

Apenas saída. O nome de exibição de um PDI, por exemplo, "Times Square", "Space Needle", seguido pelo endereço completo, se disponível.

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_POI.

Os IDs das opções de segmentação por PDI aceitos podem ser recuperados usando targetingTypes.targetingOptions.search.

Se você segmentar uma coordenada específica de latitude/longitude removida de um nome de endereço ou PDI, é possível gerar o ID da opção de segmentação necessária arredondando os valores de coordenadas desejados para a 6a casa decimal, removendo os decimais e concatenando os valores da string separados por ponto e vírgula. Por exemplo, você pode segmentar o par de latitude/longitude de 40.7414691, -74.003387 usando o ID de opção de segmentação "40741469;-74003387". Após a criação, o valor desse campo será atualizado para acrescentar um ponto e vírgula e um valor de hash alfanumérico se forem fornecidas apenas coordenadas de latitude/longitude.

latitude

number

Apenas saída. Latitude do PDI do arredondamento para a 6a casa decimal.

longitude

number

Apenas saída. Longitude do PDI com arredondamento para a 6a casa decimal.

proximityRadiusAmount

number

Obrigatório. O raio da área ao redor do PDI que será segmentado. As unidades do raio são especificadas por proximityRadiusUnit. Precisa ser de 1 a 800 se a unidade for DISTANCE_UNIT_KILOMETERS e de 1 a 500 se a unidade for DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

Obrigatório. A unidade de distância pela qual o raio de segmentação é medido.

DistanceUnit

Possíveis opções de unidade de distância.

Enums
DISTANCE_UNIT_UNSPECIFIED O valor do tipo não está especificado ou é desconhecido nesta versão.
DISTANCE_UNIT_MILES Milhas.
DISTANCE_UNIT_KILOMETERS Quilômetros.

BusinessChainAssignedTargetingOptionDetails

Detalhes da opção de segmentação da rede de negócios atribuída. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_BUSINESS_CHAIN.

Representação JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Campos
displayName

string

Apenas saída. O nome de exibição de uma rede de empresas, por exemplo, "KFC", "Chase Bank".

targetingOptionId

string

Obrigatório. O targetingOptionId de uma TargetingOption do tipo TARGETING_TYPE_BUSINESS_CHAIN.

Os IDs de opção de segmentação da rede de negócios aceitos podem ser recuperados usando SearchTargetingOptions.

proximityRadiusAmount

number

Obrigatório. O raio da área ao redor da rede de empresas que será segmentada. As unidades do raio são especificadas por proximityRadiusUnit. Precisa ser de 1 a 800 se a unidade for DISTANCE_UNIT_KILOMETERS e de 1 a 500 se a unidade for DISTANCE_UNIT_MILES. O incremento mínimo para ambos os casos é 0,1. As entradas serão arredondadas para o valor aceitável mais próximo se forem muito granulares (por exemplo, 15,57 se torna 15,6).

proximityRadiusUnit

enum (DistanceUnit)

Obrigatório. A unidade de distância pela qual o raio de segmentação é medido.

ContentDurationAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída à duração do conteúdo. Isso será preenchido no campo contentDurationDetails quando targetingType for TARGETING_TYPE_CONTENT_DURATION. Não é possível segmentar explicitamente todas as opções. Remova todas as opções de segmentação por duração do conteúdo para conseguir esse efeito.

Representação JSON
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
Campos
targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CONTENT_DURATION.

contentDuration

enum (ContentDuration)

Apenas saída. A duração do conteúdo.

ContentStreamTypeAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída ao tipo de fluxo de conteúdo Isso será preenchido no campo contentStreamTypeDetails quando targetingType for TARGETING_TYPE_CONTENT_STREAM_TYPE. Não é possível segmentar explicitamente todas as opções. Remova todas as opções de segmentação por tipo de fluxo de conteúdo para conseguir esse efeito.

Representação JSON
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
Campos
targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CONTENT_STREAM_TYPE.

contentStreamType

enum (ContentStreamType)

Apenas saída. O tipo de stream de conteúdo.

NativeContentPositionAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída à posição do conteúdo nativo Isso será preenchido no campo nativeContentPositionDetails quando targetingType for TARGETING_TYPE_NATIVE_CONTENT_POSITION. Não é possível segmentar explicitamente todas as opções. Remova todas as opções de segmentação por posição de conteúdo nativo para conseguir esse efeito.

Representação JSON
{
  "contentPosition": enum (NativeContentPosition)
}
Campos
contentPosition

enum (NativeContentPosition)

Obrigatório. A posição do conteúdo.

OmidAssignedTargetingOptionDetails

Representa um tipo de inventário segmentável ativado para o Open Measurement. Isso será preenchido no campo de detalhes de uma AssignedSegmentaçãoOption quando targetingType for TARGETING_TYPE_OMID.

Representação JSON
{
  "omid": enum (Omid)
}
Campos
omid

enum (Omid)

Obrigatório. O tipo de inventário ativado para Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída ao tipo de conteúdo de áudio. Isso será preenchido no campo audioContentTypeDetails quando targetingType for TARGETING_TYPE_AUDIO_CONTENT_TYPE. Não é possível segmentar explicitamente todas as opções. Remova todas as opções de segmentação por tipo de conteúdo de áudio para conseguir esse efeito.

Representação JSON
{
  "audioContentType": enum (AudioContentType)
}
Campos
audioContentType

enum (AudioContentType)

Obrigatório. O tipo de conteúdo de áudio.

ContentGenreAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída a gênero de conteúdo Isso será preenchido no campo contentGenreDetails quando targetingType for TARGETING_TYPE_CONTENT_GENRE. Não é possível segmentar explicitamente todas as opções. Remova todas as opções de segmentação por gênero de conteúdo para conseguir esse efeito.

Representação JSON
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Campos
targetingOptionId

string

Obrigatório. O campo targetingOptionId quando targetingType é TARGETING_TYPE_CONTENT_GENRE.

displayName

string

Apenas saída. É o nome de exibição do gênero do conteúdo.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

YoutubeVideoAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída ao vídeo do YouTube. Isso será preenchido no campo youtubeVideoDetails quando targetingType for TARGETING_TYPE_YOUTUBE_VIDEO.

Representação JSON
{
  "videoId": string,
  "negative": boolean
}
Campos
videoId

string

ID do vídeo do YouTube como aparece na página de exibição do YouTube.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

YoutubeChannelAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída ao canal do YouTube. Isso será preenchido no campo youtubeChannelDetails quando targetingType for TARGETING_TYPE_YOUTUBE_CHANNEL.

Representação JSON
{
  "channelId": string,
  "negative": boolean
}
Campos
channelId

string

O ID do canal do usuário que fez o envio do YouTube ou o código de um canal do YouTube.

negative

boolean

Indica se essa opção está sendo segmentada negativamente.

SessionPositionAssignedTargetingOptionDetails

Detalhes da opção de segmentação atribuída à posição da sessão. Isso será preenchido no campo sessionPositionDetails quando targetingType for TARGETING_TYPE_SESSION_POSITION.

Representação JSON
{
  "sessionPosition": enum (SessionPosition)
}
Campos
sessionPosition

enum (SessionPosition)

A posição em que o anúncio será exibido em uma sessão.

SessionPosition

Posições possíveis em uma sessão.

Enums
SESSION_POSITION_UNSPECIFIED Este é um marcador de posição e não indica nenhuma posição.
SESSION_POSITION_FIRST_IMPRESSION A primeira impressão da sessão.

Métodos

get

Recebe uma única opção de segmentação atribuída a uma campanha.

list

Lista as opções de segmentação atribuídas a uma campanha para um tipo de segmentação especificado.