REST Resource: advertisers.campaigns

Recurso: campanha

Uma única campanha.

Representação JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}
Campos
name

string

Apenas saída. O nome do recurso da campanha.
advertiserId

string (int64 format)

Apenas saída. O ID exclusivo do anunciante ao qual a campanha pertence.
campaignId

string (int64 format)

Apenas saída. O ID exclusivo da campanha. Atribuído pelo sistema.
displayName

string

Obrigatório. O nome de exibição da campanha.

Ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
entityStatus

enum (EntityStatus)

Obrigatório. Controla se os pedidos de inserção dessa campanha podem gastar os orçamentos e dar lances no inventário.

  • Os valores aceitos são ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED e ENTITY_STATUS_PAUSED.
  • Para o método campaigns.create, ENTITY_STATUS_ARCHIVED não é permitido.
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que a campanha foi atualizada pela última vez. Atribuído pelo sistema.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
campaignGoal

object (CampaignGoal)

Obrigatório. A meta da campanha.
campaignFlight

object (CampaignFlight)

Obrigatório. O gasto planejado e a duração da campanha.
frequencyCap

object (FrequencyCap)

Obrigatório. A configuração do limite de frequência da campanha.
campaignBudgets[]

object (CampaignBudget)

A lista de orçamentos disponíveis para esta campanha.

Se esse campo não for definido, a campanha usará um orçamento ilimitado.

CampaignGoal

Configurações que controlam a meta de uma campanha.

Representação JSON 
{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}
Campos
campaignGoalType

enum (CampaignGoalType)

Obrigatório. O tipo de meta da campanha.
performanceGoal

object (PerformanceGoal)

Obrigatório. A meta de desempenho da campanha.

Estes são os valores aceitáveis para performanceGoalType:

  • PERFORMANCE_GOAL_TYPE_CPM
  • PERFORMANCE_GOAL_TYPE_CPC
  • PERFORMANCE_GOAL_TYPE_CPA
  • PERFORMANCE_GOAL_TYPE_CPIAVC
  • PERFORMANCE_GOAL_TYPE_CTR
  • PERFORMANCE_GOAL_TYPE_VIEWABILITY
  • PERFORMANCE_GOAL_TYPE_OTHER

CampaignGoalType

Possíveis tipos de metas da campanha.

Enums
CAMPAIGN_GOAL_TYPE_UNSPECIFIED O valor do objetivo não está especificado ou é desconhecido.
CAMPAIGN_GOAL_TYPE_APP_INSTALL Impulsionar instalações ou engajamentos do app
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS Aumentar o reconhecimento de uma marca ou produto.
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION Impulsionar as vendas off-line ou na loja.
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION Promover ações ou visitas on-line.

CampaignFlight

Configurações que acompanham o gasto planejado e a duração de uma campanha.

Representação JSON 
{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}
Campos
plannedSpendAmountMicros

string (int64 format)

É o valor que se espera que a campanha gaste para o plannedDates especificado. Isso não vai limitar a veiculação, mas será usado para rastrear os gastos na interface do DV360.

O valor está em micros. Deve ser maior ou igual a 0. Por exemplo, 50.000.000 representa 500 unidades padrão da moeda.
plannedDates

object (DateRange)

Obrigatório. As datas em que a campanha está prevista para ser executada. Eles são resolvidos em relação ao fuso horário do anunciante principal.

  • As datas especificadas aqui não afetarão a veiculação. Eles são usados para gerar alertas e avisos. Por exemplo, se o período de veiculação de um pedido de inserção filho estiver fora do intervalo dessas datas, a interface do usuário vai mostrar um aviso.
  • startDate é obrigatório e precisa ser a data atual ou posterior.
  • endDate é opcional. Se especificado, precisa ser startDate ou posterior.
  • Qualquer data especificada precisa ser anterior ao ano 2037.

CampaignBudget

Configurações que controlam como o orçamento da campanha é alocado.

Representação JSON 
{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}
Campos
budgetId

string (int64 format)

O ID exclusivo do orçamento da campanha. Atribuído pelo sistema. Não defina para novos orçamentos.

Precisa ser incluído ao atualizar ou adicionar orçamentos a campaignBudgets. Caso contrário, um novo ID será gerado e atribuído.
displayName

string

Obrigatório. O nome de exibição do orçamento.

Ser codificado em UTF-8 com um tamanho máximo de 240 bytes.
budgetUnit

enum (BudgetUnit)

Obrigatório. Imutável. Especifica se o orçamento é medido em moeda ou em impressões.
budgetAmountMicros

string (int64 format)

Obrigatório. É o valor total que os segmentos do pedido de inserção vinculados podem definir no orçamento.

O valor está em micros. Precisa ser maior que 0. Por exemplo, 50.000.000 representa 500 unidades padrão da moeda.
dateRange

object (DateRange)

Obrigatório. Período do orçamento da campanha. Os segmentos de orçamento vinculados podem ter um período diferente. Eles são resolvidos em relação ao fuso horário do anunciante principal.

Tanto startDate quanto endDate precisam ser anteriores ao ano de 2037.
externalBudgetSource

enum (ExternalBudgetSource)

Obrigatório. A fonte externa do orçamento.
externalBudgetId

string

Imutável. O ID que identifica esse orçamento para a origem externa.

Se esse campo for definido e o nível de detalhe da fatura do perfil de faturamento correspondente estiver definido como "Ordem de compra no nível do orçamento", todas as impressões veiculadas com base nesse orçamento incluirão esse ID na fatura.

Precisa ser exclusivo na campanha.
invoiceGroupingId

string

Imutável. O ID usado para agrupar orçamentos a serem incluídos na mesma fatura.

Se esse campo for definido e o nível da fatura do perfil de faturamento correspondente estiver definido como "ID do agrupamento de faturas do orçamento", todas as externalBudgetId que compartilham o mesmo invoiceGroupingId vão ser agrupadas na mesma fatura.
prismaConfig

object (PrismaConfig)

Outros metadados para uso pela ferramenta Mediaocean Prisma.

Obrigatório para orçamentos do Mediaocean.

Aplicável apenas a anunciantes do prismaEnabled.

ExternalBudgetSource

Origem externa de um segmento de orçamento da campanha.

Enums
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED O valor de origem do orçamento externo não é especificado ou é desconhecido nesta versão.
EXTERNAL_BUDGET_SOURCE_NONE O orçamento não tem origem externa.
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN A origem do orçamento é Mediaocean.

PrismaConfig

Configurações específicas da ferramenta Mediaocean Prisma.

Representação JSON 
{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}
Campos
prismaType

enum (PrismaType)

Obrigatório. O tipo Prisma.
prismaCpeCode

object (PrismaCpeCode)

Obrigatório. Códigos de cliente, produto e estimativa relevantes da ferramenta Mediaocean Prisma.
supplier

string

Obrigatório. A entidade alocou esse orçamento (DSP, site etc.).

PrismaType

Tipos possíveis para um orçamento do Prisma.

Enums
PRISMA_TYPE_UNSPECIFIED O tipo não está especificado ou é desconhecido nesta versão.
PRISMA_TYPE_DISPLAY Tipo de exibição.
PRISMA_TYPE_VIDEO Tipo de vídeo.
PRISMA_TYPE_AUDIO Tipo de áudio.
PRISMA_TYPE_SOCIAL Tipo de rede social.
PRISMA_TYPE_FEE Tipo de taxa.

PrismaCpeCode

A central de pagamentos do Google oferece suporte à pesquisa e filtragem nos campos de componentes desse código.

Representação JSON 
{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}
Campos
prismaClientCode

string

O código do cliente do Prisma.
prismaProductCode

string

O código do produto do Prisma.
prismaEstimateCode

string

O código de estimativa do Prisma.

Métodos

create

 Cria uma nova campanha.

delete

 Exclui uma campanha permanentemente.

get

 Recebe uma campanha.

list

 Lista as campanhas em um anunciante.

listAssignedTargetingOptions

 Lista as opções de segmentação atribuídas a uma campanha nos diferentes tipos de segmentação.

patch

 Atualiza uma campanha existente.