REST Resource: advertisers

Risorsa: Inserzionista

Un singolo inserzionista in Display & Video 360 (DV360).

Rappresentazione JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
Campi
name

string

Solo output. Il nome risorsa dell'inserzionista.
advertiserId

string (int64 format)

Solo output. L'ID univoco dell'inserzionista. Assegnato dal sistema.
partnerId

string (int64 format)

Obbligatorio. Immutabile. L'ID univoco del partner a cui appartiene l'inserzionista.
displayName

string

Obbligatorio. Il nome visualizzato dell'inserzionista.

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

enum (EntityStatus)

Obbligatorio. Controlla se gli ordini di inserzione e gli elementi pubblicitari dell'inserzionista possono spendere i loro budget e fare offerte per l'inventario.

  • I valori accettati sono ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED e ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Se impostato su ENTITY_STATUS_SCHEDULED_FOR_DELETION, l'inserzionista verrà eliminato 30 giorni dopo la prima pianificazione dell'eliminazione.
updateTime

string (Timestamp format)

Solo output. Timestamp dell'ultimo aggiornamento dell'inserzionista. Assegnato dal sistema.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
generalConfig

object (AdvertiserGeneralConfig)

Obbligatorio. Impostazioni generali dell'inserzionista.
adServerConfig

object (AdvertiserAdServerConfig)

Obbligatorio. Immutabile. Impostazioni relative all'ad server dell'inserzionista.
creativeConfig

object (AdvertiserCreativeConfig)

Obbligatorio. Impostazioni relative alle creatività dell'inserzionista.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Impostazioni che controllano la modalità di accesso ai dati degli inserzionisti.
integrationDetails

object (IntegrationDetails)

Dettagli dell'integrazione dell'inserzionista. Al momento, solo integrationCode è applicabile all'inserzionista. Gli altri campi di IntegrationDetails non sono supportati e verranno ignorati se forniti.
servingConfig

object (AdvertiserTargetingConfig)

Impostazioni di targeting relative alla pubblicazione degli annunci dell'inserzionista.
prismaEnabled

boolean

Indica se l'integrazione con Mediaocean (Prisma) è abilitata. Se attivi questa opzione, accetti quanto segue:

Per conto della mia società, autorizzo Mediaocean (Prisma) a inviare a Google i piani dei segmenti di budget e autorizzo Google a inviare a Mediaocean i report e le fatture corrispondenti di DV360 ai fini della pianificazione del budget, della fatturazione e della riconciliazione per questo inserzionista.
billingConfig

object (AdvertiserBillingConfig)

Obbligatorio. Impostazioni relative alla fatturazione dell'inserzionista.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Facoltativo. Se questo inserzionista contiene elementi pubblicitari che pubblicano annunci politici dell'Unione Europea.

Se questo campo è impostato su DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, si verifica quanto segue:

  • A tutti i nuovi elementi pubblicitari creati per questo inserzionista verrà assegnato DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING se non diversamente specificato.
  • Tutti gli elementi pubblicitari esistenti di questo inserzionista che non hanno un valore impostato verranno aggiornati a DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING entro un giorno.
defaultBusinessName

string

Facoltativo. Il nome dell'attività predefinito per l'inserzionista.

Questo è il valore utilizzato dagli annunci YouTube e Demand Gen per questo inserzionista se non viene fornito un nome dell'attività.
defaultLogoAssetId

string (int64 format)

Facoltativo. L'ID asset dell'immagine del logo predefinita per l'inserzionista.

Questo è l'ID asset che verrà utilizzato da YouTube e dagli annunci Demand di questo inserzionista se non viene fornito un asset logo.

Devi utilizzare advertisers.adAssets.upload per caricare questo asset tramite l'API.

AdvertiserGeneralConfig

Impostazioni generali di un inserzionista.

Rappresentazione JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Campi
domainUrl

string

Obbligatorio. L'URL del dominio del sito web principale dell'inserzionista. Il sistema invierà queste informazioni ai publisher che richiedono l'URL del sito web per associare una campagna a un inserzionista.

Fornisci un URL senza percorso o stringa di query, che inizi con http: o https:. Ad esempio, http://www.example.com
timeZone

string

Solo output. Il nome standard del database TZ del fuso orario dell'inserzionista. Ad esempio, America/New_York.

Scopri di più all'indirizzo: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Per gli inserzionisti ibridi CM360, il fuso orario è lo stesso dell'account CM360 associato; per gli inserzionisti solo di terze parti, il fuso orario è lo stesso del partner principale.
currencyCode

string

Obbligatorio. Immutabile. Valuta dell'inserzionista nel formato ISO 4217.

I codici accettati e le valute che rappresentano sono:

Codice valuta : nome valuta

  • ARS : Peso argentino
  • AUD : dollaro australiano
  • BRL : Real brasiliano
  • CAD : dollaro canadese
  • CHF : Franco svizzero
  • CLP : Peso cileno
  • CNY : Yuan cinese
  • COP : Peso colombiano
  • CZK : corona ceca
  • DKK : Corona danese
  • EGP : Sterlina egiziana
  • EUR : euro
  • GBP : sterlina britannica
  • HKD : Dollaro di Hong Kong
  • HUF : fiorino ungherese
  • IDR : rupia indonesiana
  • ILS : shekel israeliano
  • INR : rupia indiana
  • JPY : yen giapponese
  • KRW : won sudcoreano
  • MXN : pesos messicani
  • MYR : Ringgit malese
  • NGN : Naira nigeriana
  • NOK : Corona norvegese
  • NZD : dollaro neozelandese
  • PEN : Nuovo Sol peruviano
  • PLN : Zloty polacco
  • RON : Nuovo leu rumeno
  • RUB : rublo russo
  • SEK : Corona svedese
  • TRY : Lira turca
  • TWD : Nuovo dollaro taiwanese
  • USD : dollaro statunitense
  • ZAR : Rand sudafricano

AdvertiserAdServerConfig

Impostazioni relative all'ad server di un inserzionista.

Rappresentazione JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
Campi
Obbligatorio. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

La configurazione solo per gli inserzionisti che utilizzano ad server di terze parti.
cmHybridConfig

object (CmHybridConfig)

La configurazione per gli inserzionisti che utilizzano sia Campaign Manager 360 (CM360) sia ad server di terze parti.
Fine dei campi che si escludono a vicenda.

ThirdPartyOnlyConfig

Impostazioni per gli inserzionisti che utilizzano solo ad server di terze parti.

Rappresentazione JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
Campi
pixelOrderIdReportingEnabled

boolean

Indica se i report sugli ID ordine per i pixel sono attivati. Questo valore non può essere modificato una volta impostato su true.

CmHybridConfig

Impostazioni per gli inserzionisti che utilizzano sia Campaign Manager 360 (CM360) sia ad server di terze parti.

Rappresentazione JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Campi
cmAccountId

string (int64 format)

Obbligatorio. Immutabile. ID account della configurazione Floodlight CM360 collegata all'inserzionista DV360.
cmFloodlightConfigId

string (int64 format)

Obbligatorio. Immutabile. ID della configurazione Floodlight CM360 collegata all'inserzionista DV360.
cmAdvertiserIds[]

string (int64 format)

Solo output. Il set di ID inserzionista CM360 che condividono la configurazione Floodlight CM360.
cmSyncableSiteIds[]

string (int64 format)

Un elenco di siti CM360 i cui posizionamenti verranno sincronizzati con DV360 come creatività.

Se assente o vuoto nel metodo advertisers.create, il sistema creerà automaticamente un sito CM360.

La rimozione dei siti da questo elenco potrebbe causare l'eliminazione delle creatività DV360 sincronizzate da CM360. È necessario specificare almeno un sito.
dv360ToCmDataSharingEnabled

boolean

Se includere o meno i dati DV360 nei report di trasferimento dati di CM360.
dv360ToCmCostReportingEnabled

boolean

Specifica se segnalare o meno il costo DV360 a CM360.
cmFloodlightLinkingAuthorized

boolean

Obbligatorio. Immutabile. Se imposti questo campo su true, tu, per conto della tua azienda, autorizzi la condivisione delle informazioni della configurazione Floodlight specificata con questo inserzionista Display & Video 360.

AdvertiserCreativeConfig

Impostazioni correlate alle creatività di un inserzionista.

Rappresentazione JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Campi
iasClientId

string (int64 format)

Un ID per la configurazione del monitoraggio della campagna fornito da Integral Ad Service (IAS). Il sistema DV360 aggiungerà al tag creatività un tag "Campaign Monitor" di IAS contenente questo ID.
obaComplianceDisabled

boolean

Se disattivare o meno la funzionalità Su questo annuncio di Google che aggiunge badge (per identificare i contenuti come annuncio) e informazioni sulla trasparenza (in caso di interazione con Su questo annuncio) ai tuoi annunci per la pubblicità comportamentale online (OBA) e i requisiti normativi. La funzionalità Su questo annuncio offre agli utenti un maggiore controllo sugli annunci che visualizzano e ti aiuta a spiegare il motivo per cui visualizzano il tuo annuncio. Ulteriori informazioni.

Se scegli di impostare questo campo su true, tieni presente che gli annunci pubblicati tramite Display & Video 360 devono rispettare quanto segue:

  • Essere conformi alla pubblicità comportamentale online (OBA), in base al contratto stipulato con Google Marketing Platform.
  • Nello Spazio economico europeo (SEE), includi informazioni sulla trasparenza e un meccanismo che consenta agli utenti di segnalare contenuti illegali negli annunci. Se utilizzi una soluzione alternativa per badge annuncio, trasparenza e report, devi assicurarti che includa le informazioni sulla trasparenza richieste e il meccanismo di segnalazione di contenuti illegali e che tu comunichi a Google eventuali segnalazioni di contenuti illegali utilizzando l'apposito modulo.
dynamicCreativeEnabled

boolean

Indica se l'inserzionista è abilitato per le creatività dinamiche.
videoCreativeDataSharingAuthorized

boolean

Se imposti questo campo su true, tu, per conto della tua azienda, autorizzi Google a utilizzare le creatività video associate a questo inserzionista Display & Video 360 per fornire report e funzionalità relativi alle campagne televisive dell'inserzionista.

Applicabile solo quando l'inserzionista ha una configurazione di ad server CM360 hybrid.

AdvertiserDataAccessConfig

Impostazioni che controllano la modalità di accesso ai dati correlati all'inserzionista.

Rappresentazione JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Campi
sdfConfig

object (AdvertiserSdfConfig)

Impostazioni dei file di dati strutturati (SDF) per l'inserzionista.

Se non specificato, vengono utilizzate le impostazioni SDF del partner principale.

AdvertiserSdfConfig

Impostazioni dei file di dati strutturati (SDF) di un inserzionista.

Rappresentazione JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Campi
overridePartnerSdfConfig

boolean

Indica se questo inserzionista esegue l'override della configurazione SDF del partner principale.

Per impostazione predefinita, un inserzionista eredita la configurazione SDF dal partner principale. Per eseguire l'override della configurazione del partner, imposta questo campo su true e fornisci la nuova configurazione in sdfConfig.
sdfConfig

object (SdfConfig)

La configurazione SDF per l'inserzionista.

AdvertiserTargetingConfig

Impostazioni di targeting relative alla pubblicazione degli annunci di un inserzionista.

Rappresentazione JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Campi
exemptTvFromViewabilityTargeting

boolean

Se i dispositivi TV connessi a internet sono esenti o meno dal targeting per visibilità per tutti gli elementi pubblicitari video dell'inserzionista.

AdvertiserBillingConfig

Impostazioni relative alla fatturazione di un inserzionista.

Rappresentazione JSON 
{
  "billingProfileId": string
}
Campi
billingProfileId

string (int64 format)

Obbligatorio. L'ID di un profilo di fatturazione assegnato all'inserzionista.

Metodi

audit

 Controlla un inserzionista.

create

 Crea un nuovo inserzionista.

delete

 Elimina un inserzionista.

editAssignedTargetingOptions

 Modifica le opzioni di targeting per un singolo inserzionista.

get

 Recupera un inserzionista.

list

 Elenca gli inserzionisti accessibili all'utente corrente.

listAssignedTargetingOptions

 Elenca le opzioni di targeting assegnate di un inserzionista in tutti i tipi di targeting.

patch

 Aggiorna un inserzionista esistente.