REST Resource: advertisers.adGroups.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 para esta 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 é exclusivo em um determinado recurso e tipo de segmentação. Eles podem ser reutilizados em outros contextos.

assignedTargetingOptionIdAlias

string

Apenas saída. Um alias para o 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 aos seguintes tipos de segmentação:

  • 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

Esse campo também é compatível com opções de segmentação atribuídas ao item de linha dos seguintes tipos de segmentação:

  • 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 atribuída. Somente um campo nos detalhes pode ser preenchido e precisa corresponder a targeting_type; details só pode ser de um dos tipos a seguir:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalhes do dia e do horário. Esse campo será preenchido quando targetingType for TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

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

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalhes da lista de locais por proximidade. Esse campo será preenchido quando targetingType for TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalhes de gênero. Esse campo será preenchido quando targetingType for TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalhes do conteúdo premiado para usuários. Esse campo será preenchido quando targetingType for TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Nos detalhes da posição na tela. Esse campo será preenchido quando targetingType for TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalhes da palavra-chave. Esse 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. Esse 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. Esse campo será preenchido quando targetingType for TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

A segmentação de uma categoria também segmenta as subcategorias dela. Se uma categoria for excluída da segmentação e uma subcategoria for incluída, a exclusão terá precedência.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalhes de visibilidade. Esse 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. Esse 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 de idioma. Esse campo será preenchido quando targetingType for TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalhes do grupo de origens de inventário. Esse campo será preenchido quando targetingType for TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalhes da classificação de conteúdo digital. Esse 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 exclusões de anunciantes, mas não é possível substituí-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. Esse 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 e exclusões de anunciantes, mas não podem substituir essas categorias.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

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

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

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

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

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

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Detalhes da posição da sessão. Esse 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 anunciante. As opções herdadas de segmentação atribuídas prevalecem, 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. Elas precisam ser modificadas pelo serviço de entidade do qual são herdadas. A herança só se aplica a canais segmentados negativamente, exclusões de categorias sensíveis e de classificação de conteúdo digital se elas estiverem configuradas no nível pai.

Enums
INHERITANCE_UNSPECIFIED A herança não foi especificada ou é desconhecida.
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 por 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. Precisam se referir ao campo de ID em um recurso de canal de propriedade do parceiro ou de canal de propriedade 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 app 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 por 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 Play Store para Android usa um ID do pacote, por exemplo, com.google.android.gm. O ID do app 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 segmentado. Se esse campo não for especificado, a plataforma do app será considerada móvel (ou seja, Android ou iOS) e derivamos a plataforma para dispositivos móveis apropriada com base no ID do aplicativo.

AppPlatform

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

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

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 horários de início e 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 para essa configuração de segmentação por dia e hora.

startHour

integer

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

endHour

integer

Obrigatório. O horário de término para a segmentação por dia e horário. 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 o fuso horário a ser usado na 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 resolver o fuso horário.

Enums
TIME_ZONE_RESOLUTION_UNSPECIFIED A resolução do fuso horário não é específica ou é desconhecida.
TIME_ZONE_RESOLUTION_END_USER Os horários são calculados no fuso horário do usuário que viu o anúncio.
TIME_ZONE_RESOLUTION_ADVERTISER Os horários são calculados no 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 maior. O alcance de uma segmentação por faixa etária contínua pode ser expandido ao segmentar também 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 cujo 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 de proximidade. 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 por proximidade. Precisa se referir ao campo locationListId de um recurso LocationList cujo 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 NeighborRADIUS.

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 de distância real.
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 sexo atribuído. 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 por tamanho do player de vídeo. Isso será preenchido no campo videoPlayerSizeDetails quando targetingType for TARGETING_TYPE_VIDEO_PLAYER_SIZE. Não há suporte à segmentação explícita de todas as opções. Remova todas as opções de segmentação por tamanho do player de vídeo para alcançar 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 por conteúdo premiado do 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 por status parental atribuído. 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 de 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 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, imagem e HTML5.
AD_TYPE_VIDEO Criativos de vídeo, por exemplo anúncios em vídeo exibidos durante o conteúdo de streaming em players de vídeo.
AD_TYPE_AUDIO Criativos em áudio, por exemplo: anúncios em áudio tocados durante o conteúdo de á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. O multiplicador de lance permite exibir seus anúncios com maior ou menor frequência com base no tipo de dispositivo. Ele aplicará um multiplicador do preço do lance original. Quando esse campo é igual a 0, significa que ele não é aplicável em vez de multiplicar 0 pelo 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á US $15,0.

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

AudienceGroupAssignedTargetingOptionDetails

Detalhes da opção de segmentação do grupo de públicos-alvo 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 para excludedFirstAndThirdPartyAudienceGroup e excludedGoogleAudienceGroup, em que COMPLEMENT é usado como uma troca de aparelho 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 de público-alvo próprio e de terceiros e as recências dos grupos de público-alvo primários e de terceiros incluídos. Cada grupo de público-alvo próprio e de terceiros contém apenas IDs de público-alvo próprio e de terceiros. A relação entre cada grupo de público-alvo próprio e de terceiros é INTERNA, e o resultado é UNION com 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 grupo de público-alvo do Google incluído. Contém apenas IDs de público-alvo do Google.

includedCustomListGroup

object (CustomListGroup)

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

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 combinado.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Os códigos de público-alvo próprio e de terceiros e as recências do grupo de público-alvo primário e de terceiros excluído. Usado para segmentação negativa. O COMPLEMENTO da união desse grupo e de outros grupos de público-alvo excluídos é usado como uma seta para baixo para qualquer segmentação por público-alvo positiva. Todos os itens são logicamente "OU" entre si.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

FirstAndThirdPartyAudienceGroup

Detalhes do grupo de público-alvo próprio e de terceiros. Todas as configurações de segmentação por público-alvo primário e de terceiros são logicamente "OU" entre si.

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 nos grupos de público-alvo próprios e de terceiros. Configurações repetidas com o mesmo ID não são permitidas.

FirstAndThirdPartyAudienceTargetingSetting

Detalhes da configuração da segmentação por 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. Este ID é firstAndThirdPartyAudienceId.

recency

enum (Recency)

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

Tempo para retorno

Todos os valores de recência da audiência primária e de terceiros compatíveis.

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 uma hora.
RECENCY_2_HOURS O tempo para retorno é de 2 horas.
RECENCY_3_HOURS O tempo para retorno é de três 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 cinco 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 compartilhamento do Google. Todas as configurações de segmentação por público-alvo do Google usam logicamente "OU" entre si.

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. ID do público-alvo do Google da configuração de segmentação por público-alvo do Google. Este ID é googleAudienceId.

CustomListGroup

Detalhes do grupo de listas personalizadas. Todas as configurações de segmentação por lista personalizada têm "OR" entre si.

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

object (CustomListTargetingSetting)

Obrigatório. Todas as configurações de segmentação por 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 por lista personalizada. Este ID é customListId.

CombinedAudienceGroup

Detalhes do grupo de público-alvo combinado. Todas as configurações combinadas de segmentação por público-alvo usam logicamente "OU" entre si.

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

object (CombinedAudienceTargetingSetting)

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

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. ID do público-alvo combinado da configuração de segmentação por público-alvo combinado. Este 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 um 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 neste 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. 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 um 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 devem ter o mesmo valor neste 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 ofensiva. Precisa ser codificado em UTF-8 com 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ído. 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 por marca e modelo 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 veiculação.

InventorySourceAssignedTargetingOptionDetails

Detalhes da 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 TARGETING_TYPE_AUTHORIZED_SELLER_STATUS atribuída, ele usará a opção "Vendedores diretos e revendedores autorizados" é a melhor opção.

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 um 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 um 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 para esse 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 um 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 da 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 camada 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 por 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 de enumeração para a troca.

SubExchangeAssignedTargetingOptionDetails

Detalhes da opção de segmentação de subtroca 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 um TargetingOption do tipo TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Detalhes da opção de segmentação do verificador de terceiros atribuído. 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. É possível segmentar um verificador de terceiros para aplicar limites de brand safety às 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 do 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 de 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 aplicativos com a classificação etária.

appStarRating

object (AppStarRating)

Evite dar lances em apps com notas.

displayViewability

object (DisplayViewability)

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

videoViewability

object (VideoViewability)

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

fraudInvalidTraffic

object (FraudInvalidTraffic)

Evitar sites e aplicativos com histórico de fraude e Taxas de IVT.

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 enum é apenas um marcador 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 Incentivado/malware/sobrecarga.

MediumSeverityCategory

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

Enums
MEDIUM_SEVERITY_UNSPECIFIED Este enum é apenas um marcador 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 controversos: estilos de vida alternativos.
CELEBRITY_GOSSIP Assuntos controversos: fofocas sobre celebridades.
GAMBLING Assuntos controversos: jogos de azar.
OCCULT Assuntos controversos: 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 não padrão: outro idioma.
PARKING_PAGE Conteúdo não padrão: página de estacionamento.
UNMODERATED_UGC UGC não moderado: fóruns, imagens e Vídeo
INFLAMMATORY_POLITICS_AND_NEWS Assuntos controversos: notícias e assuntos políticos 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 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 para adolescentes (maiores de 12 anos).
APP_AGE_RATE_17_PLUS Aplicativos para 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 apps com notas.

avoidInsufficientStarRating

boolean

Evite dar lances em apps com notas insuficientes.

StarRating

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

Enums
APP_STAR_RATE_UNSPECIFIED Esse tipo enumerado é apenas um marcador e não especifica as opções de nota do app.
APP_STAR_RATE_1_POINT_5_LESS Aplicativos oficiais com classificação < 1,5 estrela.
APP_STAR_RATE_2_LESS Aplicativos oficiais com classificação < Duas estrelas.
APP_STAR_RATE_2_POINT_5_LESS Aplicativos oficiais com classificação < 2,5 estrelas.
APP_STAR_RATE_3_LESS Aplicativos oficiais com classificação < Três estrelas.
APP_STAR_RATE_3_POINT_5_LESS Aplicativos oficiais com classificação < 3,5 estrelas.
APP_STAR_RATE_4_LESS Aplicativos oficiais com classificação < Quatro estrelas.
APP_STAR_RATE_4_POINT_5_LESS Aplicativos oficiais com classificação < 4,5 estrelas.

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 inventários da Web e de apps para maximizar a duração visível de 100%.

IAB

Opções possíveis para a taxa visível do IAB.

Enums
IAB_VIEWED_RATE_UNSPECIFIED Este enum é apenas um marcador 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 de visibilidade 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 de visibilidade 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 de visibilidade do IAB em 30% ou mais.

ViewableDuring

Opções possíveis para 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 inventários da Web e de apps para maximizar 100% de duração visível de cinco segundos ou mais.
AVERAGE_VIEW_DURATION_10_SEC Segmente inventários da Web e de apps para maximizar 100% de duração da visibilidade por 10 segundos ou mais.
AVERAGE_VIEW_DURATION_15_SEC Segmente inventários da Web e de apps para maximizar 100% de duração da visibilidade 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 tamanho de player de 400 x 300 ou maior.

VideoIAB

Opções possíveis de taxa visível do IAB.

Enums
VIDEO_IAB_UNSPECIFIED Este enum é apenas um marcador e não especifica nenhuma opção de taxa visível do IAB para 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 de visibilidade do IAB em 55% ou mais.
IAB_VIEWABILITY_50_PERCENT_HIGHER Segmente o inventário da Web e do app para maximizar a taxa de visibilidade 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 de visibilidade do IAB em 30% ou mais.

VideoViewableRate

Possíveis opções de taxa de visibilidade total.

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ões.
PLAYER_SIZE_400X300_95 Sites com mais de 95%de impressões.
PLAYER_SIZE_400X300_70 Sites com mais de 70%das impressões.
PLAYER_SIZE_400X300_25 Sites com mais de 25%de impressões.
PLAYER_SIZE_400X300_5 Sites com mais de 5%das impressões.

FraudInvalidTraffic

Fraude DoubleVerify e Configurações de tráfego inválidas.

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

enum (FraudOption)

Evitar sites e aplicativos com histórico de fraude e IVT

avoidInsufficientOption

boolean

Histórico insuficiente de fraude e Estatísticas de IVT.

FraudOption

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

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

IntegralAdScience

Detalhes das configurações do 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 verdadeira da publicidade (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 - Bebidas alcoólicas.

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 do 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 real da publicidade) da Integral Ad Science.

Enums
TRAQ_UNSPECIFIED Esse tipo enumerado é apenas um marcador e não especifica Índices de qualidade de publicidade verdadeiros.
TRAQ_250 TRAQ score 250-1000.
TRAQ_500 TRAQ score 500-1000.
TRAQ_600 TRAQ score 600-1000.
TRAQ_700 TRAQ score 700-1000.
TRAQ_750 TRAQ score 750-1000.
TRAQ_875 TRAQ score 875-1000.
TRAQ_1000 TRAQ score 1000.

Adulto

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

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

Bebidas alcoólicas

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

Enums
ALCOHOL_UNSPECIFIED Esse enum é apenas um marcador e não especifica nenhuma opção de bebida alcoólica.
ALCOHOL_HR Álcool: excluir risco alto.
ALCOHOL_HMR Álcool: exclua risco alto e moderado.

IllegalDownloads

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

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

Drogas

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

Enums
DRUGS_UNSPECIFIED Esse tipo enumerado é apenas um marcador e não especifica opções de medicamentos.
DRUGS_HR Drogas: exclua risco alto.
DRUGS_HMR Drogas: exclua risco alto e moderado.

HateSpeech

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

Enums
HATE_SPEECH_UNSPECIFIED Esse tipo enumerado é apenas um marcador 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: exclua risco alto e moderado.

OffensiveLanguage

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

Enums
OFFENSIVE_LANGUAGE_UNSPECIFIED Esse enum é apenas um marcador e não especifica nenhuma opção de idioma.
OFFENSIVE_LANGUAGE_HR Linguagem ofensiva: excluir risco alto.
OFFENSIVE_LANGUAGE_HMR Linguagem ofensiva: excluir risco alto e moderado.

Violência

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

Enums
VIOLENCE_UNSPECIFIED Esse 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: exclua risco alto e moderado.

Jogos de azar

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

Enums
GAMBLING_UNSPECIFIED Esse enum é apenas um marcador e não especifica nenhuma opção de jogos de azar.
GAMBLING_HR Jogos de azar: excluir risco alto.
GAMBLING_HMR Jogos de azar: exclua risco alto e moderado.

AdFraudPrevention

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

Enums
SUSPICIOUS_ACTIVITY_UNSPECIFIED Esse tipo enumerado é apenas um marcador 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 risco alto e moderado.

DisplayViewability

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

Enums
PERFORMANCE_VIEWABILITY_UNSPECIFIED Esse tipo enumerado é apenas um marcador e não especifica nenhuma opção 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 do vídeo da Integral Ad Science.

Enums
VIDEO_VIEWABILITY_UNSPECIFIED Esse enum é apenas um marcador e não especifica nenhuma opção de visibilidade do vídeo.
VIDEO_VIEWABILITY_40 mais de 40%de impressões visualizadas (padrão IAB de visibilidade de vídeo).
VIDEO_VIEWABILITY_50 mais de 50%de impressões visualizadas (padrão IAB de visibilidade de vídeo).
VIDEO_VIEWABILITY_60 mais de 60%de impressões visualizadas (padrão IAB de visibilidade de vídeo).
VIDEO_VIEWABILITY_70 mais de 70%de impressões visualizadas (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 seu endereço completo, se disponível.

targetingOptionId

string

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

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

Se a segmentação de uma coordenada específica de latitude/longitude for removida de um nome de endereço ou PDI, será possível gerar o ID da opção de segmentação necessário arredondando os valores das coordenadas desejadas para a sexta 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 código de opção de segmentação "40741469;-74003387". Após a criação, esse valor de campo será atualizado para acrescentar um ponto e vírgula e um valor de hash alfanumérico se apenas as coordenadas de latitude/longitude forem fornecidas.

latitude

number

Apenas saída. Latitude do PDI arredondando para a sexta casa decimal.

longitude

number

Apenas saída. Longitude do PDI arredondada 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 foi especificado ou é desconhecido nesta versão.
DISTANCE_UNIT_MILES Milhas
DISTANCE_UNIT_KILOMETERS Quilômetros.

BusinessChainAssignedTargetingOptionDetails

Detalhes da opção de segmentação por 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 negócios. Por exemplo, "KFC", "Chase Bank".

targetingOptionId

string

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

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

proximityRadiusAmount

number

Obrigatório. O raio da área ao redor da rede de negócios 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 passará a ser 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 por duração do conteúdo. Isso será preenchido no campo contentDurationDetails quando targetingType for TARGETING_TYPE_CONTENT_DURATION. Não há suporte à segmentação explícita de 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 stream de conteúdo. Isso será preenchido no campo contentStreamTypeDetails quando targetingType for TARGETING_TYPE_CONTENT_STREAM_TYPE. Não há suporte à segmentação explícita de 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 há suporte à segmentação explícita de 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 do Open Measurement ativado. 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 o 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 há suporte à segmentação explícita de 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 há suporte à segmentação explícita de 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 a vídeos 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 que 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 um grupo de anúncios.

list

Lista as opções de segmentação atribuídas a um grupo de anúncios.