Anúncios

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Contém propriedades de um anúncio do Campaign Manager.

{
  "kind": "dfareporting#ad",
  "id": long,
  "idDimensionValue": dimensionValues Resource,
  "campaignId": long,
  "campaignIdDimensionValue": dimensionValues Resource,
  "advertiserId": long,
  "advertiserIdDimensionValue": dimensionValues Resource,
  "subaccountId": long,
  "accountId": long,
  "name": string,
  "active": boolean,
  "archived": boolean,
  "comments": string,
  "startTime": datetime,
  "endTime": datetime,
  "placementAssignments": [
    {
      "placementId": long,
      "placementIdDimensionValue": dimensionValues Resource,
      "active": boolean,
      "sslRequired": boolean
    }
  ],
  "eventTagOverrides": [
    {
      "id": long,
      "enabled": boolean
    }
  ],
  "clickThroughUrlSuffixProperties": {
    "overrideInheritedSuffix": boolean,
    "clickThroughUrlSuffix": string
  },
  "defaultClickThroughEventTagProperties": {
    "overrideInheritedEventTag": boolean,
    "defaultClickThroughEventTagId": long
  },
  "createInfo": {
    "time": long
  },
  "lastModifiedInfo": {
    "time": long
  },
  "sslRequired": boolean,
  "sslCompliant": boolean,
  "type": string,
  "geoTargeting": {
    "excludeCountries": boolean,
    "countries": [
      countries Resource
    ],
    "regions": [
      regions Resource
    ],
    "cities": [
      cities Resource
    ],
    "metros": [
      metros Resource
    ],
    "postalCodes": [
      postalCodes Resource
    ]
  },
  "technologyTargeting": {
    "operatingSystems": [
      operatingSystems Resource
    ],
    "browsers": [
      browsers Resource
    ],
    "platformTypes": [
      platformTypes Resource
    ],
    "mobileCarriers": [
      mobileCarriers Resource
    ],
    "connectionTypes": [
      connectionTypes Resource
    ],
    "operatingSystemVersions": [
      operatingSystemVersions Resource
    ]
  },
  "dayPartTargeting": {
    "userLocalTime": boolean,
    "daysOfWeek": [
      string
    ],
    "hoursOfDay": [
      integer
    ]
  },
  "deliverySchedule": {
    "hardCutoff": boolean,
    "priority": string,
    "impressionRatio": long,
    "frequencyCap": {
      "impressions": long,
      "duration": long
    }
  },
  "creativeRotation": {
    "type": string,
    "weightCalculationStrategy": string,
    "creativeOptimizationConfigurationId": long,
    "creativeAssignments": [
      {
        "creativeId": long,
        "creativeIdDimensionValue": dimensionValues Resource,
        "active": boolean,
        "weight": integer,
        "startTime": datetime,
        "endTime": datetime,
        "sequence": integer,
        "clickThroughUrl": {
          "defaultLandingPage": boolean,
          "landingPageId": long,
          "customClickThroughUrl": string,
          "computedClickThroughUrl": string
        },
        "creativeGroupAssignments": [
          {
            "creativeGroupId": long,
            "creativeGroupNumber": string
          }
        ],
        "richMediaExitOverrides": [
          {
            "exitId": long,
            "enabled": boolean,
            "clickThroughUrl": {
              "defaultLandingPage": boolean,
              "landingPageId": long,
              "customClickThroughUrl": string,
              "computedClickThroughUrl": string
            }
          }
        ],
        "companionCreativeOverrides": [
          {
            "creativeId": long,
            "clickThroughUrl": {
              "defaultLandingPage": boolean,
              "landingPageId": long,
              "customClickThroughUrl": string,
              "computedClickThroughUrl": string
            }
          }
        ],
        "applyEventTags": boolean,
        "sslCompliant": boolean
      }
    ]
  },
  "remarketingListExpression": {
    "expression": string
  },
  "audienceSegmentId": long,
  "keyValueTargetingExpression": {
    "expression": string
  },
  "clickThroughUrl": {
    "defaultLandingPage": boolean,
    "landingPageId": long,
    "customClickThroughUrl": string,
    "computedClickThroughUrl": string
  },
  "creativeGroupAssignments": [
    {
      "creativeGroupId": long,
      "creativeGroupNumber": string
    }
  ],
  "size": sizes Resource,
  "compatibility": string,
  "dynamicClickTracker": boolean,
  "languageTargeting": {
    "languages": [
      languages Resource
    ]
  },
  "targetingTemplateId": long
}
Nome da propriedade Valor Descrição Notas
accountId long É o ID da conta deste anúncio. Este é um campo somente leitura que pode ser deixado em branco.
active boolean Indica se este anúncio está ativo. Quando verdadeiro, archived precisa ser falso.
advertiserId long É o ID do anunciante deste anúncio. Este é um campo obrigatório na inserção.
advertiserIdDimensionValue nested object É o valor da dimensão do ID do anunciante. Este é um campo somente leitura gerado automaticamente.
archived boolean Indica se este anúncio está arquivado. Quando verdadeiro, active precisa ser falso.
audienceSegmentId long É o ID do segmento de público-alvo que está sendo segmentado para este anúncio. Aplicável quando type é AD_SERVING_STANDARD_AD.
campaignId long É o ID da campanha deste anúncio. Este é um campo obrigatório na inserção.
campaignIdDimensionValue nested object É o valor da dimensão do ID da campanha. Este é um campo somente leitura gerado automaticamente.
clickThroughUrl nested object É o URL de clique para este anúncio. Este é um campo obrigatório na inserção. Aplicável quando type é AD_SERVING_CLICK_TRACKER.
clickThroughUrl.computedClickThroughUrl string É o campo de conveniência somente leitura que representa o URL real que será usado para esse clique. O URL é calculado da seguinte forma:
  • Se defaultLandingPage estiver ativado, o URL da página de destino padrão da campanha será atribuído a este campo.
  • Se defaultLandingPage não estiver ativado e um landingPageId for especificado, aquele URL da página de destino será atribuído a este campo.
  • Se nenhum dos casos acima se aplicar, o customClickThroughUrl será atribuído a este campo.
clickThroughUrl.customClickThroughUrl string É o URL de clique personalizado. Aplicável se o campo defaultLandingPage estiver definido como falso e o campo landingPageId não estiver definido.
clickThroughUrl.defaultLandingPage boolean Indica se a página de destino padrão da campanha é usada.
clickThroughUrl.landingPageId long É o ID da página de destino do URL de clique. Aplicável se o campo defaultLandingPage estiver definido como falso.
clickThroughUrlSuffixProperties nested object São as propriedades de sufixo do URL de clique para este anúncio. Aplicam-se ao URL no anúncio ou ao URL no criativo, caso você modifique as propriedades do anúncio.
clickThroughUrlSuffixProperties.clickThroughUrlSuffix string É o sufixo do URL de clique para aplicar a todos os anúncios no escopo desta entidade. Precisa ter menos de 128 caracteres.
clickThroughUrlSuffixProperties.overrideInheritedSuffix boolean Indica se essa entidade deve modificar o sufixo do URL de clique herdado por seu próprio valor definido.
comments string São os comentários para este anúncio.
compatibility string É a compatibilidade deste anúncio. Aplicável quando type é AD_SERVING_DEFAULT_AD. DISPLAY e DISPLAY_INTERSTITIAL referem-se à renderização em computadores, dispositivos móveis ou apps para dispositivos móveis para anúncios normais ou intersticiais, respectivamente. APP e APP_INTERSTITIAL são usados somente para anúncios default existentes. As novas posições em dispositivos móveis precisam receber DISPLAY ou DISPLAY_INTERSTITIAL, e os anúncios default criados para essas posições serão limitados a esses tipos de compatibilidade. IN_STREAM_VIDEO refere-se à renderização de anúncios em vídeo in-stream desenvolvidos com o padrão VAST.

Os valores aceitáveis são os seguintes:
  • "APP"
  • "APP_INTERSTITIAL"
  • "DISPLAY"
  • "DISPLAY_INTERSTITIAL"
  • "IN_STREAM_AUDIO"
  • "IN_STREAM_VIDEO"
createInfo nested object São as informações sobre a criação deste anúncio. Este é um campo somente leitura.
createInfo.time long É o carimbo de data/hora da última mudança em milissegundos desde a época.
creativeGroupAssignments[] list São as atribuições do grupo de criativos para este anúncio. Aplicável quando type é AD_SERVING_CLICK_TRACKER. Somente uma atribuição por número de grupo de criativos é permitida para um máximo de duas atribuições.
creativeGroupAssignments[].creativeGroupId long É o ID do grupo de criativos a ser atribuído.
creativeGroupAssignments[].creativeGroupNumber string É o número do grupo de criativos da atribuição do grupo de criativos.

Os valores aceitáveis são os seguintes:
  • "CREATIVE_GROUP_ONE"
  • "CREATIVE_GROUP_TWO"
creativeRotation nested object É a rotação de criativos para este anúncio. Aplicável quando type é AD_SERVING_DEFAULT_AD, AD_SERVING_STANDARD_AD ou AD_SERVING_TRACKING. Quando type for AD_SERVING_DEFAULT_AD, este campo deverá ter exatamente um creativeAssignment.
creativeRotation.creativeAssignments[] list São as atribuições do criativo nesta rotação de criativos.
creativeRotation.creativeAssignments[].active boolean Indica se a atribuição do criativo está ativa. Quando verdadeiro, o criativo será incluído na rotação do anúncio.
creativeRotation.creativeAssignments[].applyEventTags boolean Indica se as tags de evento aplicáveis deverão ser disparadas quando a atribuição do criativo for renderizada. Se esse valor não for definido quando o anúncio for inserido ou atualizado, o padrão será verdadeiro para todos os tipos de criativo, EXCETO para INTERNAL_REDIRECT, INTERSTITIAL_INTERNAL_REDIRECT e INSTREAM_VIDEO.
creativeRotation.creativeAssignments[].clickThroughUrl nested object É o URL de clique da atribuição do criativo.
creativeRotation.creativeAssignments[].clickThroughUrl.computedClickThroughUrl string É o campo de conveniência somente leitura que representa o URL real que será usado para esse clique. O URL é calculado da seguinte forma:
  • Se defaultLandingPage estiver ativado, o URL da página de destino padrão da campanha será atribuído a este campo.
  • Se defaultLandingPage não estiver ativado e um landingPageId for especificado, aquele URL da página de destino será atribuído a este campo.
  • Se nenhum dos casos acima se aplicar, o customClickThroughUrl será atribuído a este campo.
creativeRotation.creativeAssignments[].clickThroughUrl.customClickThroughUrl string É o URL de clique personalizado. Aplicável se o campo defaultLandingPage estiver definido como falso e o campo landingPageId não estiver definido.
creativeRotation.creativeAssignments[].clickThroughUrl.defaultLandingPage boolean Indica se a página de destino padrão da campanha é usada.
creativeRotation.creativeAssignments[].clickThroughUrl.landingPageId long É o ID da página de destino do URL de clique. Aplicável se o campo defaultLandingPage estiver definido como falso.
creativeRotation.creativeAssignments[].companionCreativeOverrides[] list São as modificações de criativos complementares para esta atribuição do criativo. Aplicável a anúncios em vídeo.
creativeRotation.creativeAssignments[].companionCreativeOverrides[].clickThroughUrl nested object É o URL de clique da modificação do criativo complementar.
creativeRotation.creativeAssignments[].companionCreativeOverrides[].clickThroughUrl.computedClickThroughUrl string É o campo de conveniência somente leitura que representa o URL real que será usado para esse clique. O URL é calculado da seguinte forma:
  • Se defaultLandingPage estiver ativado, o URL da página de destino padrão da campanha será atribuído a este campo.
  • Se defaultLandingPage não estiver ativado e um landingPageId for especificado, aquele URL da página de destino será atribuído a este campo.
  • Se nenhum dos casos acima se aplicar, o customClickThroughUrl será atribuído a este campo.
creativeRotation.creativeAssignments[].companionCreativeOverrides[].clickThroughUrl.customClickThroughUrl string É o URL de clique personalizado. Aplicável se o campo defaultLandingPage estiver definido como falso e o campo landingPageId não estiver definido.
creativeRotation.creativeAssignments[].companionCreativeOverrides[].clickThroughUrl.defaultLandingPage boolean Indica se a página de destino padrão da campanha é usada.
creativeRotation.creativeAssignments[].companionCreativeOverrides[].clickThroughUrl.landingPageId long É o ID da página de destino do URL de clique. Aplicável se o campo defaultLandingPage estiver definido como falso.
creativeRotation.creativeAssignments[].companionCreativeOverrides[].creativeId long É o ID do criativo para essa modificação de criativo complementar.
creativeRotation.creativeAssignments[].creativeGroupAssignments[] list São as atribuições do grupo de criativos para esta atribuição do criativo. Somente uma atribuição por número de grupo de criativos é permitida para um máximo de duas atribuições.
creativeRotation.creativeAssignments[].creativeGroupAssignments[].creativeGroupId long É o ID do grupo de criativos a ser atribuído.
creativeRotation.creativeAssignments[].creativeGroupAssignments[].creativeGroupNumber string É o número do grupo de criativos da atribuição do grupo de criativos.

Os valores aceitáveis são os seguintes:
  • "CREATIVE_GROUP_ONE"
  • "CREATIVE_GROUP_TWO"
creativeRotation.creativeAssignments[].creativeId long É o ID do criativo a ser atribuído. Este campo é obrigatório.
creativeRotation.creativeAssignments[].creativeIdDimensionValue nested object É o valor da dimensão para o ID do criativo. Este é um campo somente leitura gerado automaticamente.
creativeRotation.creativeAssignments[].endTime datetime É a data e a hora em que o criativo atribuído deve parar de ser veiculado. Precisa ser posterior ao horário de início.
creativeRotation.creativeAssignments[].richMediaExitOverrides[] list São as modificações de saída de rich media para esta atribuição do criativo.

Aplicável quando o tipo de criativo for qualquer um dos seguintes:

  • DISPLAY
  • RICH_MEDIA_INPAGE
  • RICH_MEDIA_INPAGE_FLOATING
  • RICH_MEDIA_IM_EXPAND
  • RICH_MEDIA_EXPANDING
  • RICH_MEDIA_INTERSTITIAL_FLOAT
  • RICH_MEDIA_MOBILE_IN_APP
  • RICH_MEDIA_MULTI_FLOATING
  • RICH_MEDIA_PEEL_DOWN
  • VPAID_LINEAR
  • VPAID_NON_LINEAR

creativeRotation.creativeAssignments[].richMediaExitOverrides[].clickThroughUrl nested object É o URL de clique desta modificação de saída de rich media. Aplicável se o campo enabled estiver definido como verdadeiro.
creativeRotation.creativeAssignments[].richMediaExitOverrides[].clickThroughUrl.computedClickThroughUrl string É o campo de conveniência somente leitura que representa o URL real que será usado para esse clique. O URL é calculado da seguinte forma:
  • Se defaultLandingPage estiver ativado, o URL da página de destino padrão da campanha será atribuído a este campo.
  • Se defaultLandingPage não estiver ativado e um landingPageId for especificado, aquele URL da página de destino será atribuído a este campo.
  • Se nenhum dos casos acima se aplicar, o customClickThroughUrl será atribuído a este campo.
creativeRotation.creativeAssignments[].richMediaExitOverrides[].clickThroughUrl.customClickThroughUrl string É o URL de clique personalizado. Aplicável se o campo defaultLandingPage estiver definido como falso e o campo landingPageId não estiver definido.
creativeRotation.creativeAssignments[].richMediaExitOverrides[].clickThroughUrl.defaultLandingPage boolean Indica se a página de destino padrão da campanha é usada.
creativeRotation.creativeAssignments[].richMediaExitOverrides[].clickThroughUrl.landingPageId long É o ID da página de destino do URL de clique. Aplicável se o campo defaultLandingPage estiver definido como falso.
creativeRotation.creativeAssignments[].richMediaExitOverrides[].enabled boolean Indica se o clickThroughUrl será usado. Se for falso, a saída no nível do criativo será usada.
creativeRotation.creativeAssignments[].richMediaExitOverrides[].exitId long É o ID da modificação para se referir a uma saída específica no criativo.
creativeRotation.creativeAssignments[].sequence integer É o número sequencial da atribuição do criativo, aplicável quando o tipo de rotação é CREATIVE_ROTATION_TYPE_SEQUENTIAL. Os valores aceitáveis são de 1 a 65535, inclusive.
creativeRotation.creativeAssignments[].sslCompliant boolean Indica se o criativo a ser atribuído é compatível com SSL. Este é um campo somente leitura gerado automaticamente quando o anúncio é inserido ou atualizado.
creativeRotation.creativeAssignments[].startTime datetime É a data e a hora em que o criativo atribuído começará a ser veiculado.
creativeRotation.creativeAssignments[].weight integer É a ponderação da atribuição do criativo, aplicável quando o tipo de rotação é CREATIVE_ROTATION_TYPE_RANDOM. O valor deve ser maior ou igual a 1.
creativeRotation.creativeOptimizationConfigurationId long É a configuração de otimização do criativo usada por este anúncio. Ela deve se referir a uma das configurações de otimização existentes na campanha do anúncio. Se não estiver definida ou for definida como 0, a configuração de otimização padrão da campanha será usada para este anúncio.
creativeRotation.type string É o tipo de rotação de criativos. Pode ser usado para especificar se a rotação sequencial ou aleatória será utilizada.

Os valores aceitáveis são os seguintes:
  • "CREATIVE_ROTATION_TYPE_RANDOM"
  • "CREATIVE_ROTATION_TYPE_SEQUENTIAL"
creativeRotation.weightCalculationStrategy string É a estratégia para calcular ponderações. Usada com CREATIVE_ROTATION_TYPE_RANDOM.

Os valores aceitáveis são os seguintes:
  • "WEIGHT_STRATEGY_CUSTOM"
  • "WEIGHT_STRATEGY_EQUAL"
  • "WEIGHT_STRATEGY_HIGHEST_CTR"
  • "WEIGHT_STRATEGY_OPTIMIZED"
dayPartTargeting nested object São as informações de segmentação por dia e horário para este anúncio. Este campo deverá ser deixado em branco se o anúncio estiver usando um modelo de segmentação. Aplicável quando type é AD_SERVING_STANDARD_AD.
dayPartTargeting.daysOfWeek[] list São os dias da semana em que o anúncio será veiculado.

Os valores aceitáveis são os seguintes:
  • "SUNDAY"
  • "MONDAY"
  • "TUESDAY"
  • "WEDNESDAY"
  • "THURSDAY"
  • "FRIDAY"
  • "SATURDAY"
dayPartTargeting.hoursOfDay[] list São as horas do dia em que o anúncio será veiculado, em que 0 é da meia-noite à 1h e 23 é das 23h à meia-noite. Pode ser especificado com dias da semana. Nesse caso, o anúncio seria veiculado durante esses horários nos dias especificados. Por exemplo, se segunda, quarta e sexta forem os dias da semana especificados e 9h-10h e 15h-17h (horas 9, 15 e 16) as horas, o anúncio será exibido segundas, quartas e sextas das 9h às 10h e das 15h às 17h. Os valores aceitáveis são de 0 a 23, inclusive.
dayPartTargeting.userLocalTime boolean Indica se o horário local do usuário deve ou não ser usado. Se for falso, o fuso horário dos Estados Unidos/Nova York será aplicado.
defaultClickThroughEventTagProperties nested object São as propriedades da tag de evento de clique padrão para este anúncio.
defaultClickThroughEventTagProperties.defaultClickThroughEventTagId long É o ID da tag de evento de clique para aplicar a todos os anúncios no escopo dessa entidade.
defaultClickThroughEventTagProperties.overrideInheritedEventTag boolean Indica se essa entidade deve modificar a tag de evento de clique padrão herdada por seu próprio valor definido.
deliverySchedule nested object São as informações de programação de entrega para este anúncio. Aplicável quando type é AD_SERVING_STANDARD_AD ou AD_SERVING_TRACKING. Esse campo, além dos subcampos priority e impressionRatio, é necessário na inserção quando type é AD_SERVING_STANDARD_AD.
deliverySchedule.frequencyCap nested object É o número limite de vezes que um anúncio pode ser veiculado a um usuário individual em um período de tempo especificado.
deliverySchedule.frequencyCap.duration long É a duração em segundos para esse limite de frequência. A duração máxima é de 90 dias. Os valores aceitos vão de 1 a 7776000, inclusive.
deliverySchedule.frequencyCap.impressions long É o número de vezes que o anúncio pode ser veiculado a um usuário individual dentro do período especificado. Os valores aceitos vão de 1 a 15, inclusive.
deliverySchedule.hardCutoff boolean Indica se o encerramento forçado está ativado. Se verdadeiro, o anúncio não será veiculado depois da data e da hora de término. Caso contrário, o anúncio continuará sendo veiculado até alcançar suas metas de exibição.
deliverySchedule.impressionRatio long É a proporção de impressão para este anúncio. Essa proporção determina a frequência com que cada anúncio é veiculado em relação aos outros. Por exemplo, se o anúncio A tiver uma proporção de 1 e o anúncio B tiver uma proporção de 3, o Campaign Manager veiculará o anúncio B três vezes mais que o anúncio A. Os valores aceitos vão de 1 a 10, inclusive.
deliverySchedule.priority string É a prioridade de veiculação de um anúncio em relação a outros anúncios. Quanto menor for o número, maior será a prioridade de veiculação.

Os valores aceitáveis são os seguintes:
  • "AD_PRIORITY_01"
  • "AD_PRIORITY_02"
  • "AD_PRIORITY_03"
  • "AD_PRIORITY_04"
  • "AD_PRIORITY_05"
  • "AD_PRIORITY_06"
  • "AD_PRIORITY_07"
  • "AD_PRIORITY_08"
  • "AD_PRIORITY_09"
  • "AD_PRIORITY_10"
  • "AD_PRIORITY_11"
  • "AD_PRIORITY_12"
  • "AD_PRIORITY_13"
  • "AD_PRIORITY_14"
  • "AD_PRIORITY_15"
  • "AD_PRIORITY_16"
dynamicClickTracker boolean Indica se este anúncio é um rastreador de cliques dinâmico. Aplicável quando type é AD_SERVING_CLICK_TRACKER. Este é um campo obrigatório na inserção e é somente leitura após isso.
endTime datetime É a data e a hora em que este anúncio deve parar de ser veiculado. Precisa ser posterior ao horário de início. Este é um campo obrigatório na inserção.
eventTagOverrides[] list São as modificações de tags de evento para este anúncio.
eventTagOverrides[].enabled boolean Indica se esta modificação está ativada.
eventTagOverrides[].id long É o ID desta modificação de tag de evento. Este é um campo somente leitura gerado automaticamente.
geoTargeting nested object São as informações de segmentação geográfica para este anúncio. Este campo deverá ser deixado em branco se o anúncio estiver usando um modelo de segmentação. Aplicável quando type é AD_SERVING_STANDARD_AD.
geoTargeting.cities[] list São as cidades a serem segmentadas. É preciso informar apenas dartId para cada cidade. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Caso uma cidade seja segmentada, não segmente nem exclua o país e não segmente a área metropolitana ou a região da cidade.
geoTargeting.countries[] list São os países a serem segmentados ou excluídos da segmentação, dependendo da configuração do campo excludeCountries. É preciso informar apenas dartId para cada país. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Caso um país seja segmentado, não segmente regiões, cidades, áreas metropolitanas ou códigos postais no mesmo país.
geoTargeting.excludeCountries boolean Indica se os países no campo countries devem ou não ser excluídos da segmentação. Se for falso, o campo countries se refere aos países que serão segmentados pelo anúncio.
geoTargeting.metros[] list São as áreas metropolitanas a serem segmentadas. É preciso informar apenas dmaId para cada área metropolitana. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Ao segmentar uma área metropolitana, não segmente nem exclua o país dela.
geoTargeting.postalCodes[] list São os códigos postais a serem segmentados. É preciso informar apenas id para cada código postal. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Caso um código postal seja segmentado, não segmente nem exclua o país do código postal.
geoTargeting.regions[] list São as regiões a serem segmentadas. É preciso informar apenas dartId para cada região. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Se estiver segmentando uma região, não segmente nem exclua o país da região.
id long É o ID deste anúncio. Este é um campo somente leitura gerado automaticamente.
idDimensionValue nested object É o valor da dimensão para o ID deste anúncio. Este é um campo somente leitura gerado automaticamente.
keyValueTargetingExpression nested object São as informações de segmentação por chave-valor deste anúncio. Este campo deverá ser deixado em branco se o anúncio estiver usando um modelo de segmentação. Aplicável quando type é AD_SERVING_STANDARD_AD.
keyValueTargetingExpression.expression string É a expressão de palavra-chave segmentada pelo anúncio.
kind string Identifica o tipo de recurso. Valor: a string fixa "dfareporting#ad".
languageTargeting nested object São as informações de segmentação por idioma para este anúncio. Este campo deverá ser deixado em branco se o anúncio estiver usando um modelo de segmentação. Aplicável quando type é AD_SERVING_STANDARD_AD.
languageTargeting.languages[] list São os idiomas que este anúncio segmenta. É preciso informar apenas languageId para cada idioma. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado.
lastModifiedInfo nested object São as informações sobre a modificação mais recente desse anúncio. Este é um campo somente leitura.
lastModifiedInfo.time long É o carimbo de data/hora da última mudança em milissegundos desde a época.
name string É o nome deste anúncio. Este campo é obrigatório e deve ter menos de 256 caracteres.
placementAssignments[] list São as atribuições de posição para este anúncio.
placementAssignments[].active boolean Indica se a atribuição de posição está ativa. Quando verdadeiro, a posição será incluída na rotação do anúncio.
placementAssignments[].placementId long É o ID da posição a ser atribuída. Este campo é obrigatório.
placementAssignments[].placementIdDimensionValue nested object É o valor da dimensão do ID da posição. Este é um campo somente leitura gerado automaticamente.
placementAssignments[].sslRequired boolean Indica se a posição a ser atribuída requer SSL. Este é um campo somente leitura gerado automaticamente quando o anúncio é inserido ou atualizado.
remarketingListExpression nested object É a expressão de segmentação da lista de remarketing para este anúncio. Este campo deverá ser deixado em branco se o anúncio estiver usando um modelo de segmentação. Aplicável quando type é AD_SERVING_STANDARD_AD.
remarketingListExpression.expression string É a expressão que descreve quais listas estão sendo segmentadas pelo anúncio.
size nested object É o tamanho deste anúncio. Aplicável quando type é AD_SERVING_DEFAULT_AD.
sslCompliant boolean Indica se este anúncio é compatível com SSL. Este é um campo somente leitura gerado automaticamente quando o anúncio é inserido ou atualizado.
sslRequired boolean Indica se este anúncio requer SSL. Este é um campo somente leitura gerado automaticamente quando o anúncio é inserido ou atualizado.
startTime datetime É a data e a hora de início da veiculação deste anúncio. Se você criar um anúncio, esse campo deverá ser uma hora no futuro. Este é um campo obrigatório na inserção.
subaccountId long É o ID da subconta deste anúncio. Este é um campo somente leitura que pode ser deixado em branco.
targetingTemplateId long É o ID do modelo de segmentação usado para aplicar informações de segmentação pré-configuradas a este anúncio. Isso não poderá ser definido enquanto dayPartTargeting, geoTargeting, keyValueTargetingExpression, languageTargeting, remarketingListExpression ou technologyTargeting estiverem definidos. Aplicável quando type é AD_SERVING_STANDARD_AD.
technologyTargeting nested object São as informações de segmentação da plataforma de tecnologia para este anúncio. Este campo deverá ser deixado em branco se o anúncio estiver usando um modelo de segmentação. Aplicável quando type é AD_SERVING_STANDARD_AD.
technologyTargeting.browsers[] list São os navegadores que este anúncio segmenta. Para cada navegador, defina browserVersionId ou dartId junto com os números de versão. Se ambos forem especificados, somente browserVersionId será usado. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado.
technologyTargeting.connectionTypes[] list São os tipos de conexão que este anúncio segmenta. É preciso informar apenas id para cada tipo de conexão. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado.
technologyTargeting.mobileCarriers[] list São as operadoras de celular que este anúncio segmenta. Para cada operadora de celular, somente id é obrigatório, e os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Se estiver segmentando uma operadora de celular, não defina segmentação para códigos postais.
technologyTargeting.operatingSystemVersions[] list São as versões de sistema operacional que este anúncio segmenta. Para segmentar todas as versões, use operatingSystems. É preciso informar apenas id para cada versão de sistema operacional. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Caso uma versão de sistema operacional seja segmentada, não defina a segmentação para o sistema operacional correspondente em operatingSystems.
technologyTargeting.operatingSystems[] list São os sistemas operacionais que este anúncio segmenta. Para segmentar versões específicas, use operatingSystemVersions. É preciso informar apenas dartId para cada sistema operacional. Os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado. Ao segmentar um sistema operacional, não defina segmentações para versões para o mesmo sistema operacional.
technologyTargeting.platformTypes[] list São os tipos de plataforma que este anúncio segmenta. Por exemplo, computadores, dispositivos móveis ou tablets. Para cada tipo de plataforma, somente id é obrigatório, e os outros campos são preenchidos automaticamente quando o anúncio é inserido ou atualizado.
type string É o tipo de anúncio. Este é um campo obrigatório na inserção. Os anúncios default (AD_SERVING_DEFAULT_AD) não podem ser criados diretamente (consulte Recurso de criativo).

Os valores aceitáveis são os seguintes:
  • "AD_SERVING_BRAND_SAFE_AD"
  • "AD_SERVING_CLICK_TRACKER"
  • "AD_SERVING_DEFAULT_AD"
  • "AD_SERVING_STANDARD_AD"
  • "AD_SERVING_TRACKING"

Métodos

get
Recebe um anúncio por ID.
insert
Insere um novo anúncio.
list
Recupera uma lista de anúncios, possivelmente filtrada. Esse método é compatível com paginação.
patch
Atualiza um anúncio existente. Esse método é compatível com a semântica de patch.
update
Atualiza em anúncio existente.