- Recurso: inserçãoOrder
- InsertionOrderType
- InsertionOrderBudget
- InsertionOrderAutomationType
- InsertionOrderBudgetSegment
- BillableOutcome
- Métodos
Recurso: Adição de pedido
Um único 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 ao qual 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. 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 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 ausente ou vazio no método |
pacing |
Obrigatório. A configuração da velocidade de gasto 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. As configurações de alocação do 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 as configurações e opções aplicáveis, como o formato dos anúncios ou as opções de segmentação.
Enums | |
---|---|
INSERTION_ORDER_TYPE_UNSPECIFIED |
O tipo do 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 em moeda ou em impressão. |
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. A lista de segmentos de orçamento. Use um segmento de orçamento para especificar um orçamento para um determinado período de execuçã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 Permitir que o sistema transfira automaticamente o orçamento para itens de linha proprietários a fim de otimizar o desempenho definido por performanceGoal . Nenhuma automação nas configurações de lance. |
INSERTION_ORDER_AUTOMATION_TYPE_NONE |
Não há automação de lances 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 |
Permitir que o sistema ajuste automaticamente os lances e transfira 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 no |
description |
A descrição do segmento de orçamento. Ele pode ser usado para inserir 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 das datas 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 |
|
---|---|
|
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. |
|
Lista as opções de segmentação atribuídas a um pedido de inserção em todos os tipos de segmentação. |
|
Atualiza um pedido de inserção existente. |