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)
  }
}
Campi
name

string

Solo output. Il nome della 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 codificata 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 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. Il timestamp dell'ultimo aggiornamento dell'inserzionista. 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".

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 il modo in cui è possibile accedere ai dati dell'inserzionista.

integrationDetails

object (IntegrationDetails)

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

servingConfig

object (AdvertiserTargetingConfig)

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

prismaEnabled

boolean

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

A nome della mia azienda, autorizzo Mediaocean (Prisma) a inviare piani per i segmenti di budget a Google e autorizzo Google a inviare i report e le fatture corrispondenti da DV360 a Mediaocean ai fini della pianificazione, della fatturazione e della riconciliazione del budget per questo inserzionista.

billingConfig

object (AdvertiserBillingConfig)

Impostazioni relative alla fatturazione dell'inserzionista.

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, iniziando con http: o https:. Ad esempio, http://www.example.com

timeZone

string

Solo output. Il nome del database TZ standard 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 CM360 ibridi, 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 della 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 : libbra di Egitto
  • EUR : euro
  • GBP : sterlina inglese
  • HKD : dollaro di Hong Kong
  • HUF : fiorino ungherese
  • IDR : rupia indonesiana
  • ILS : siclo israeliano
  • INR : rupia indiana
  • JPY : yen giapponese
  • KRW : Won sudcoreano
  • MXN : peso messicani
  • MYR : Ringgit malese
  • NGN : naira nigeriana
  • NOK : corona norvegese
  • NZD : dollaro neozelandese
  • PEN : sol peruviano
  • PLN : złoty 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
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Campi
Campo unione ad_server_config_scheme. Obbligatorio. ad_server_config_scheme può essere solo uno dei seguenti:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

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

cmHybridConfig

object (CmHybridConfig)

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

ThirdPartyOnlyConfig

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

Rappresentazione JSON
{
  "pixelOrderIdReportingEnabled": boolean
}
Campi
pixelOrderIdReportingEnabled

boolean

Indica se i report sull'ID ordine per i pixel sono abilitati o meno. Una volta impostato su true, questo valore non può essere modificato.

CmHybridConfig

Impostazioni per gli inserzionisti che utilizzano sia ad server Campaign Manager 360 (CM360) sia quelli 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. L'insieme di ID inserzionista CM360 che condividono la configurazione Floodlight di CM360.

cmSyncableSiteIds[]

string (int64 format)

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

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

Se rimuovi siti da questo elenco, le creatività DV360 sincronizzate da CM360 potrebbero essere eliminate. È necessario specificare almeno un sito.

dv360ToCmDataSharingEnabled

boolean

Indica se includere o meno i dati di DV360 nei report sul trasferimento dei dati di CM360.

dv360ToCmCostReportingEnabled

boolean

Indica se segnalare o meno i costi di DV360 a CM360.

cmFloodlightLinkingAuthorized

boolean

Obbligatorio. Immutabile. Impostando questo campo su true, per conto della tua azienda autorizzi la condivisione di informazioni della configurazione Floodlight specificata con questo strumento Display & Inserzionista Video 360.

AdvertiserCreativeConfig

Impostazioni relative 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à un IAS "Campaign Monitor" contenente questo ID al tag della creatività.

obaComplianceDisabled

boolean

Indica 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) agli annunci per la pubblicità comportamentale online (OBA) e i requisiti normativi. La funzionalità Su questo annuncio offre agli utenti un maggiore controllo sugli annunci visualizzati e ti aiuta a spiegare perché visualizzano il tuo annuncio. Ulteriori informazioni.

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

  • Rispettare l'OBA (Online Behavioral Advertising), secondo il contratto 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 i badge, la trasparenza e le segnalazioni per gli annunci, devi assicurarti che includa le informazioni sulla trasparenza richieste e il meccanismo di segnalazione di contenuti illegali, nonché di comunicare a Google qualsiasi segnalazione di contenuti illegali utilizzando l'apposito modulo.
dynamicCreativeEnabled

boolean

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

videoCreativeDataSharingAuthorized

boolean

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

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

AdvertiserDataAccessConfig

Impostazioni che controllano la modalità di accesso ai dati relativi 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 dell'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 o meno 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 specifica la nuova configurazione in sdfConfig.

sdfConfig

object (SdfConfig)

La configurazione del file SDF per l'inserzionista.

AdvertiserTargetingConfig

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

Rappresentazione JSON
{
  "exemptTvFromViewabilityTargeting": boolean
}
Campi
exemptTvFromViewabilityTargeting

boolean

Indica se i dispositivi TV connessi a internet sono esenti dal targeting per visibilità per tutti gli elementi pubblicitari video associati all'inserzionista.

AdvertiserBillingConfig

Impostazioni relative alla fatturazione di un inserzionista.

Rappresentazione JSON
{
  "billingProfileId": string
}
Campi
billingProfileId

string (int64 format)

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

Se non viene fornito un valore, questo campo utilizzerà per impostazione predefinita l'ID profilo di fatturazione predefinito del partner principale dell'inserzionista.

Metodi

audit

Controlla un inserzionista.

create

Crea un nuovo inserzionista.

delete

Elimina un inserzionista.

editAssignedTargetingOptions

Modifica le opzioni di targeting di un singolo inserzionista.

get

Consente di acquisire un inserzionista.

list

Elenca gli inserzionisti accessibili all'utente corrente.

listAssignedTargetingOptions

Elenca le opzioni di targeting assegnate a un inserzionista tra i vari tipi di targeting.

patch

Consente di aggiornare un inserzionista esistente.