- Recurso: inserçãoOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Métodos
Recurso: InsertOrder
Use apenas um pedido de inserção.
Representação JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "displayName": string, "insertionOrderType": enum ( |
Campos | |
---|---|
name |
Apenas saída. É o nome do recurso do pedido de inserção. |
advertiserId |
Apenas saída. É o ID exclusivo do anunciante a que o pedido de inserção pertence. |
campaignId |
Obrigatório. Imutável. É o ID exclusivo da campanha a que o pedido de inserção pertence. |
insertionOrderId |
Apenas saída. É o ID exclusivo do pedido de inserção. Atribuído pelo sistema. |
displayName |
Obrigatório. É o nome de exibição do pedido de inserção. Precisa ser codificado em UTF-8 com um tamanho máximo de 240 bytes. |
insertionOrderType |
É o tipo de pedido de inserção. Se esse campo não for especificado na criação, o valor padrão será |
entityStatus |
Obrigatório. Controla se o pedido de inserção pode ou não gastar o orçamento e dar lances no inventário.
|
updateTime |
Apenas saída. É o carimbo de data/hora em que o pedido de inserção foi atualizado 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: |
partnerCosts[] |
Os custos do parceiro associados ao pedido de inserção. Se o método |
pacing |
Obrigatório. É a configuração da velocidade de gastos do orçamento do pedido de inserção. |
frequencyCap |
Obrigatório. É a configuração do limite de frequência do pedido de inserção. |
integrationDetails |
Mais detalhes de integração do pedido de inserção. |
performanceGoal |
Obrigatório. É a meta de desempenho do pedido de inserção. |
budget |
Obrigatório. São as configurações de alocação de orçamento do pedido de inserção. |
bidStrategy |
A estratégia de lances do pedido de inserção. Por padrão, |
reservationType |
Apenas saída. O tipo de reserva do pedido de inserção. |
billableOutcome |
Imutável. É o resultado faturável do pedido de inserção. A compra com base em resultados foi descontinuada. |
InsertionOrderType
Tipos possíveis de um pedido de inserção.
O tipo de pedido de inserção determina quais configurações e opções são aplicáveis, como o formato dos anúncios ou as opções de segmentação.
Enums | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
O tipo de pedido de inserção não foi especificado ou é desconhecido. |
RTB |
Lances em tempo real. |
OVER_THE_TOP |
Over-the-top |
InsertionOrderBudget
Configurações que controlam como o orçamento do pedido de inserção é alocado.
Representação JSON |
---|
{ "budgetUnit": enum ( |
Campos | |
---|---|
budgetUnit |
Obrigatório. Imutável. A unidade de orçamento especifica se o orçamento é baseado na moeda ou nas impressões. |
automationType |
É o tipo de automação usado para gerenciar o lance e o orçamento do pedido de inserção. Se esse campo não for especificado na criação, o valor padrão será |
budgetSegments[] |
Obrigatório. Lista de segmentos de orçamento. Use um segmento de orçamento para especificar um orçamento para um determinado período de exibição de um pedido de inserção. |
InsertionOrderAutomationType
Opções possíveis para automatizar o lance e o orçamento do pedido de inserção.
Enums | |
---|---|
INSERTION_ORDER_AUTOMATION_TYPE_UNSPECIFIED |
A opção de automação do pedido de inserção não está especificada ou é desconhecida nesta versão. |
INSERTION_ORDER_AUTOMATION_TYPE_BUDGET |
Alocação automática de orçamento. Permite que o sistema mude automaticamente o orçamento para itens de linha proprietários com o objetivo de otimizar o desempenho definido por performanceGoal . Não há automação nas configurações de lance. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Não há automação de lance ou orçamento no nível do pedido de inserção. O lance e o orçamento precisam ser configurados manualmente no nível do item de linha. |
INSERTION_ORDER_AUTOMATION_TYPE_BID_BUDGET |
Permita que o sistema ajuste automaticamente os lances e mude o orçamento para itens de linha proprietários para otimizar o desempenho definido por performanceGoal . |
InsertionOrderBudgetSegment
Configurações que controlam o orçamento de um único segmento de orçamento.
Representação JSON |
---|
{
"budgetAmountMicros": string,
"description": string,
"dateRange": {
object ( |
Campos | |
---|---|
budgetAmountMicros |
Obrigatório. É o valor do orçamento que o pedido de inserção vai gastar em |
description |
É a descrição do segmento de orçamento. Ele pode ser usado para inserir as informações da ordem de compra de cada segmento de orçamento e imprimir essas informações nas faturas. Ser codificado em UTF-8. |
dateRange |
Obrigatório. As configurações de data de início e término do segmento de orçamento. Eles são resolvidos em relação ao fuso horário do anunciante principal.
|
campaignBudgetId |
O |
BillableOutcome
Possíveis resultados faturáveis de um pedido de inserção.
Enums | |
---|---|
BILLABLE_OUTCOME_UNSPECIFIED |
Resultado faturável não especificado. |
BILLABLE_OUTCOME_PAY_PER_IMPRESSION |
Pagamento por impressão. |
BILLABLE_OUTCOME_PAY_PER_CLICK |
Pagamento por clique. |
BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION |
Pagamento por Active View |
Métodos |
|
---|---|
|
Lista as opções de segmentação atribuídas de um pedido de inserção em diferentes tipos de segmentação. |
|
Cria um novo pedido de inserção. |
|
Exclui um pedido de inserção. |
|
Recebe um pedido de inserção. |
|
Lista os pedidos de inserção de um anunciante. |
|
Atualiza um pedido de inserção existente. |