REST Resource: advertisers.campaigns

{
  "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)
    }
  ]
}

string

Solo output. Il nome della risorsa della campagna.

string (int64 format)

Solo output. L'ID univoco dell'inserzionista a cui appartiene la campagna.

string (int64 format)

Solo output. L'ID univoco della campagna. Assegnato dal sistema.

string

Obbligatorio. Il nome visualizzato della campagna.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.

enum (EntityStatus)

Obbligatorio. Consente di stabilire se gli ordini di inserzione in questa campagna possono spendere i budget e fare offerte per l'inventario.

• I valori accettati sono ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED e ENTITY_STATUS_PAUSED.
• Per il metodo campaigns.create, ENTITY_STATUS_ARCHIVED non è consentito.

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento della campagna. Assegnato dal sistema.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

object (CampaignGoal)

Obbligatorio. L'obiettivo della campagna.

object (CampaignFlight)

Obbligatorio. La spesa pianificata e la durata della campagna.

object (FrequencyCap)

Obbligatorio. L'impostazione della quota limite della campagna.

object (CampaignBudget)

L'elenco dei budget disponibili per questa campagna.

Se questo campo non viene impostato, la campagna utilizza un budget illimitato.

{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}

enum (CampaignGoalType)

Obbligatorio. Il tipo di obiettivo della campagna.

object (PerformanceGoal)

Obbligatorio. L'obiettivo di rendimento della campagna.

I valori accettati per performanceGoalType sono:

• 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

{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}

enum (PerformanceGoalType)

Obbligatorio. Il tipo di obiettivo di rendimento.

string (int64 format)

L'importo dell'obiettivo, in micro della valuta dell'inserzionista.

Applicabile quando performanceGoalType è uno tra:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_VCPM

Ad esempio 1500000 rappresenta 1,5 unità standard della valuta.

string (int64 format)

La rappresentazione decimale della percentuale dell'obiettivo in micro.

Applicabile quando performanceGoalType è uno tra:

• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_CLICK_CVR
• PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
• PERFORMANCE_GOAL_TYPE_VTR
• PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
• PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

Ad esempio, 70000 rappresenta il 7% (0,07 decimale).

string

Una stringa dell'indicatore chiave di prestazione (KPI), che può essere vuota. Deve avere codifica UTF-8 con una lunghezza massima di 100 caratteri.

Applicabile quando il criterio performanceGoalType è impostato su PERFORMANCE_GOAL_TYPE_OTHER.

{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}

string (int64 format)

L'importo che la campagna dovrebbe spendere per il relativo plannedDates. Ciò non limiterà la pubblicazione, ma verrà utilizzato per monitorare la spesa nell'interfaccia utente di DV360.

L'importo è in micro. Deve essere maggiore o uguale a 0. Ad esempio, 500000000 rappresenta 500 unità standard della valuta.

object (DateRange)

Obbligatorio. Le date di pubblicazione previste della campagna. Vengono risolti in base al fuso orario dell'inserzionista principale.

• Le date specificate qui non influiranno sulla pubblicazione. Vengono utilizzate per generare avvisi e avvisi. Ad esempio, se il periodo di pubblicazione di un ordine di inserzione secondario è al di fuori dell'intervallo di queste date, l'interfaccia utente mostrerà un avviso.
• startDate è obbligatorio e deve essere la data corrente o una successiva.
• Il campo endDate è facoltativo. Se specificato, deve essere startDate o versioni successive.
• Qualsiasi data specificata deve essere precedente all'anno 2037.

{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}

string (int64 format)

L'ID univoco del budget della campagna. Assegnato dal sistema. Non impostare nuovi budget.

Deve essere inclusa durante l'aggiornamento o l'aggiunta di budget a campaignBudgets. In caso contrario, verrà generato e assegnato un nuovo ID.

string

Obbligatorio. Il nome visualizzato del budget.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.

enum (BudgetUnit)

Obbligatorio. Immutabile. Specifica se il budget è misurato in valuta o impressioni.

string (int64 format)

Obbligatorio. L'importo totale che i segmenti degli ordini di inserzione collegati possono impostare come budget.

L'importo è in micro. Deve essere maggiore di 0. Ad esempio, 500000000 rappresenta 500 unità standard della valuta.

object (DateRange)

Obbligatorio. L'intervallo di date per il budget della campagna. I segmenti di budget collegati potrebbero avere un intervallo di date diverso. Vengono risolti in base al fuso orario dell'inserzionista principale.

Sia startDate che endDate devono essere antecedenti all'anno 2037.

enum (ExternalBudgetSource)

Obbligatorio. La sorgente esterna del budget.

string

Immutabile. L'ID che identifica il budget per la sorgente esterna.

Se questo campo è impostato e il livello di dettaglio della fattura del profilo di fatturazione corrispondente è impostato su "Ordine di acquisto a livello di budget", tutte le impressioni pubblicate in base a questo budget includeranno questo ID nella fattura.

Deve essere univoco all'interno della campagna.

string

Immutabile. L'ID utilizzato per raggruppare i budget in modo da includere la stessa fattura.

Se questo campo è impostato e il livello di fattura del profilo di fatturazione corrispondente è impostato su "ID di raggruppamento delle fatture del budget", tutti i externalBudgetId che condividono lo stesso invoiceGroupingId verranno raggruppati nella stessa fattura.

object (PrismaConfig)

Metadati aggiuntivi per l'utilizzo da parte dello strumento Mediaocean Prisma.

Obbligatorio per i budget Mediaocei.

Valido solo per prismaEnabled inserzionisti.

{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}

enum (PrismaType)

Obbligatorio. Il tipo Prisma.

object (PrismaCpeCode)

Obbligatorio. Codici pertinenti di clienti, prodotti e stime dallo strumento Mediaocean Prisma.

string

Obbligatorio. L'entità allocato questo budget (DSP, sito e così via).

{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}

string

Il codice client Prisma.

string

Il codice prodotto Prisma.

string

Il codice di stima Prisma.