Condividi tramite


Oggetto dati AssetGroup - Campaign Management

Definisce un gruppo di asset in una campagna pubblicitaria.

Sintassi

<xs:complexType name="AssetGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="BusinessName" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="CallToAction" nillable="true" type="tns:CallToAction" />
    <xs:element minOccurs="0" name="Descriptions" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AssetGroupEditorialStatus" />
    <xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
    <xs:element xmlns:q114="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q114:ArrayOfstring" />
    <xs:element xmlns:q115="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q115:ArrayOfstring" />
    <xs:element xmlns:q116="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q116:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Headlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Images" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="LongHeadlines" nillable="true" type="tns:ArrayOfAssetLink" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:AssetGroupStatus" />
  </xs:sequence>
</xs:complexType>

Elementi

L'oggetto AssetGroup include gli elementi seguenti: BusinessName, CallToAction, Descriptions, EditorialStatus, EndDate, FinalMobileUrls, FinalUrls, ForwardCompatibilityMap, Headlines, Id, Images, LongHeadlines, Name, Path1, Path2, StartDate, Status.

Elemento Descrizione Tipo di dati
BusinessName Nome dell'azienda.

Il nome dell'azienda può essere visualizzato nell'annuncio, a seconda del posizionamento dell'annuncio.

La lunghezza della stringa è limitata a 25 caratteri.

Aggiungere: Obbligatorio. Se non viene specificato e la campagna padre viene associata a un archivio, il nome dello store verrà usato come nome dell'azienda.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Stringa
CallToAction Un breve e incisivio motivo per i clienti di fare clic sul tuo annuncio in questo momento.

Viene visualizzato nel pulsante di chiamata all'azione.

Aggiungere: Obbligatorio. Se non viene fornito e la campagna padre viene associata a un archivio, per impostazione predefinita sarà LearnMore.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
CallToAction
Descrizioni Le descrizioni visualizzate sotto il percorso nell'annuncio.

È necessario impostare tra 2 e 5 descrizioni. Il testo di ogni descrizione deve contenere almeno una parola. Il testo non può contenere il carattere di nuova riga (\n).

Se la campagna padre viene associata a un archivio e si specificano le descrizioni, è necessario specificare anche Titoli, LongHeadlines e Immagini.

Aggiungi: facoltativo se la campagna padre viene associata a un archivio, obbligatorio se la campagna padre non è associata a un archivio.
Aggiornamento: facoltativo. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se si imposta un valore per questo elemento, tutte le descrizioni precedentemente collegate a questo gruppo di asset verranno sostituite. Se la campagna padre viene associata a un archivio e si imposta questo elemento su un elenco vuoto, l'impostazione precedente verrà eliminata.
Matrice AssetLink
EditorialStatus Stato della revisione editoriale del gruppo di asset, che indica se il gruppo di asset è in sospeso, è stato approvato o è stato disapprovato.

Aggiungi: sola lettura
Aggiornamento: sola lettura
AssetGroupEditorialStatus
EndDate Data di scadenza del gruppo di asset.

Se non si specifica una data di fine, il gruppo di asset non scadrà. La data di fine può essere estesa per rendere un gruppo di asset idoneo per il recapito, anche dopo la scadenza del gruppo di asset.

La data di fine è inclusiva. Ad esempio, se imposti EndDate sul 31/12/2020, gli annunci nel gruppo di annunci scadranno alle 23:59 del 31/12/2020. L'ora si basa sul fuso orario specificato a livello di campagna.

Aggiungi: facoltativo. Per impostare nessuna data di fine quando si aggiunge un gruppo di asset, impostare questo elemento su Null.
Aggiornamento: facoltativo. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per eliminare l'impostazione della data di fine esistente e impostare di fatto nessuna data di fine durante l'aggiornamento di un gruppo di asset, impostare la data di fine uguale o successiva al 2 gennaio 2050. Quando si recupera il gruppo di asset la prossima volta, questo elemento sarà nullo, ovvero non sarà impostato sul 2 gennaio 2050.
Data
FinalMobileUrls URL della pagina di destinazione per dispositivi mobili.

Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili.
- La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- È possibile specificare fino a 10 elementi sia per FinalUrls che per FinalMobileUrls; tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 per una potenziale compatibilità in avanti.
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato che inizia con http:// o https://.
- Se si specifica FinalMobileUrls, è necessario specificare anche FinalUrls.

Aggiungi: facoltativo
Aggiornamento: facoltativo
matrice di stringhe
FinalUrls URL della pagina di destinazione.

La parte di dominio dell'URL in combinazione con le stringhe path 1 e path 2 non può superare i 67 caratteri.

Le regole di convalida seguenti si applicano agli URL finali e agli URL finali per dispositivi mobili.
- La lunghezza dell'URL è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.
- È possibile specificare fino a 10 elementi sia per FinalUrls che per FinalMobileUrls; tuttavia, per il recapito viene usato solo il primo elemento di ogni elenco. Il servizio consente fino a 10 per una potenziale compatibilità in avanti.
- L'utilizzo di '{' e '}' è consentito solo per delineare i tag, ad esempio {lpurl}.
- Gli URL finali devono essere ognuno un URL ben formato che inizia con http:// o https://.
- Se si specifica FinalMobileUrls, è necessario specificare anche FinalUrls.

Per le campagne di vendita al dettaglio, l'URL finale deve corrispondere al dominio dello store associato alla campagna.

Aggiungi: obbligatorio. Se non viene fornito e la campagna padre viene associata a un archivio, l'URL dello store verrà usato come URL finale.
Aggiornamento: facoltativo
matrice di stringhe
ForwardCompatibilityMap Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API.

Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per questo oggetto.
Matrice KeyValuePairOfstringstring
Titoli I titoli sono il testo più importante che appare nel tuo annuncio, quindi dovresti sfruttare al meglio i caratteri disponibili. Sono necessari più titoli in modo che l'annuncio possa essere visualizzato in modo flessibile tra diversi editori e posizionamenti.

Dal punto di vista del modello di dati, le descrizioni e i titoli vengono archiviati come asset di testo, ad esempio un TextAsset per AssetLink. Lo stesso asset può essere usato da più annunci. Ad esempio, se "Seamless Integration" è un asset di testo, avrà lo stesso identificatore di asset in tutti gli annunci nello stesso account Microsoft Advertising.

È necessario impostare tra 3 e 15 titoli. Il testo di ogni titolo deve contenere almeno una parola.

Il testo non può contenere il carattere di nuova riga (\n).

Se la campagna padre viene associata a un archivio e si specificaNoti, è necessario specificare anche LongHeadlines, Descriptions e Images.If the parent campaign associates to a store and you specify Headlines, you must also specify LongHeadlines, Descriptions, and Images.

Aggiungi: facoltativo se la campagna padre viene associata a un archivio, obbligatorio se la campagna padre non è associata a un archivio.
Aggiornamento: facoltativo. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se si imposta un valore per questo elemento, tutti i titoli collegati in precedenza a questo gruppo di asset verranno sostituiti. Se la campagna padre viene associata a un archivio e si imposta questo elemento su un elenco vuoto, l'impostazione precedente verrà eliminata.
Matrice AssetLink
Id ID gruppo di asset generato dal sistema.

Aggiungi: sola lettura
Aggiornamento: sola lettura
long
Immagini Gli asset di immagine con dimensioni e proporzioni diverse consentono di visualizzare in modo flessibile diversi editori e posizionamenti.

Includere uno o più oggetti AssetLink che contengono ognuno un oggetto ImageAsset con sottotipo e impostazioni di ritaglio che corrispondono alle proporzioni desiderate.

ImageAsset contiene i campi CropHeight, CropWidth, CropX, CropY e SubType.

I possibili valori di sottotipo includono LandscapeImageMedia, SquareImageMedia, LandscapeLogoMedia, SquareLogoMedia, ImageMedia15X10, ImageMedia133X100, ImageMedia178X100, ImageMedia1X2 e ImageMedia4X1.

Devi fornire almeno 1 LandscapeImageMedia e 1 SquareImageMedia. È possibile salvare un totale di fino a 20 immagini e un totale di un massimo di 5 loghi.

Se la campagna padre viene associata a un archivio e si specifica Immagini, è necessario specificare anche Titoli, LongHeadlines e Descrizioni.

Aggiungi: facoltativo se la campagna padre viene associata a un archivio, obbligatorio se la campagna padre non è associata a un archivio.
Aggiornamento: facoltativo. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si includono immagini durante l'aggiornamento, tutte le immagini impostate in precedenza verranno sostituite. Se la campagna padre viene associata a un archivio e si imposta questo elemento su un elenco vuoto, l'impostazione precedente verrà eliminata.
Matrice AssetLink
LongHeadlines È necessario impostare un valore compreso tra 1 e 5 titoli lunghi. Il testo di ogni titolo deve contenere almeno una parola. Il testo non può contenere il carattere di nuova riga (\n).

Se la campagna padre viene associata a un archivio e si specificaNoti LongHeadlines, è necessario specificare anche Titoli, Descrizioni e Immagini.

Aggiungi: facoltativo se la campagna padre viene associata a un archivio, obbligatorio se la campagna padre non è associata a un archivio.
Aggiornamento: facoltativo. Per conservare tutti i collegamenti di asset esistenti, impostare o lasciare l'elemento nil. Se si imposta un valore per questo elemento, tutti i titoli collegati in precedenza a questo gruppo di asset verranno sostituiti. Se la campagna padre viene associata a un archivio e si imposta questo elemento su un elenco vuoto, l'impostazione precedente verrà eliminata.
Matrice AssetLink
Nome Nome del gruppo di asset. I nomi devono essere univoci in una campagna e devono fare distinzione tra maiuscole e minuscole. La lunghezza non può superare i 256 caratteri.

Aggiungi: Obbligatorio
Aggiornamento: facoltativo
Stringa
Percorso1 La prima parte del percorso facoltativo che verrà aggiunta alla parte di dominio dell'URL visualizzato. La parte del dominio dell'URL visualizzato, ad esempio https://www.contoso.com , verrà generata dal dominio dell'URL finale (elemento FinalUrls). Quindi, se è stato specificato un valore per Path1, verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path2, verrà aggiunto anche all'URL di visualizzazione dopo Path1. Ad esempio, se FinalUrls contiene https://www.contoso.com, Path1 è impostato su subdirectory1 e Path2 è impostato su subdirectory2, l'URL visualizzato sarà https://www.contoso.com/subdirectory1/subdirectory2.

Non possono essere inseriti più di 15 caratteri. L'annuncio non verrà visualizzato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 67 caratteri.

Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale non può essere inserito più di 7 caratteri finali. L'annuncio non verrà visualizzato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 33 caratteri. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji.

Il percorso non può contenere i caratteri barra (/) o nuova riga (\n).

Se il percorso include uno spazio, verrà sostituito con un carattere di sottolineatura (_) quando viene visualizzato l'annuncio.

Aggiungi: facoltativo
Aggiornamento: facoltativo
Stringa
Percorso2 La seconda parte del percorso facoltativo che verrà aggiunta alla parte del dominio dell'URL visualizzato. La parte del dominio dell'URL visualizzato, ad esempio https://www.contoso.com , verrà generata dal dominio dell'URL finale (elemento FinalUrls). Quindi, se è stato specificato un valore per Path1, verrà aggiunto all'URL di visualizzazione. Se è stato specificato anche un valore per Path2, verrà aggiunto anche all'URL di visualizzazione dopo Path1. Ad esempio, se FinalUrls contiene https://www.contoso.com, Path1 è impostato su subdirectory1 e Path2 è impostato su subdirectory2, l'URL visualizzato sarà https://www.contoso.com/subdirectory1/subdirectory2.

È possibile specificare Path2 solo se è impostato anche Path1.

Non possono essere inseriti più di 15 caratteri. L'annuncio non verrà visualizzato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 67 caratteri.

Per le lingue con caratteri a larghezza doppia, ad esempio il cinese tradizionale non può essere inserito più di 7 caratteri finali. L'annuncio non verrà visualizzato se la lunghezza del dominio URL finale e dei percorsi combinati supera i 33 caratteri. I caratteri a larghezza doppia sono determinati dai caratteri usati anziché dal set di caratteri delle impostazioni della lingua della campagna. I caratteri a doppia larghezza includono i caratteri delle lingue coreano, giapponese e cinese, nonché emoji.

Il percorso non può contenere i caratteri barra (/) o nuova riga (\n).

Se il percorso include uno spazio, verrà sostituito con un carattere di sottolineatura (_) quando viene visualizzato l'annuncio.

Aggiungi: facoltativo
Aggiornamento: facoltativo
Stringa
StartDate Data in cui il gruppo di asset può iniziare a servire; in caso contrario, il servizio può iniziare a pubblicare annunci il giorno in cui il gruppo di asset diventa attivo.

La data di inizio è inclusiva. Ad esempio, se imposti la data di inizio sul 5/5/2021, gli annunci creati dal gruppo di asset inizieranno alle 12:00 del 5/5/2021. L'ora si basa sul fuso orario specificato a livello di campagna.

Aggiungi: facoltativo. Se non imposti la data di inizio, per impostazione predefinita verrà impostata la data odierna e il servizio potrà iniziare a pubblicare annunci non appena lo stato del gruppo di asset è attivo.
Aggiornamento: facoltativo. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. La data di inizio non può essere aggiornata dopo l'invio del gruppo di asset, ad esempio dopo l'arrivo della data di inizio.
Data
Stato Stato del gruppo di asset. I valori possibili sono Attivo, Scaduto e Sospeso. Lo stato Scaduto è di sola lettura.

Aggiungi: facoltativo. Il valore predefinito è Paused.
Aggiornamento: facoltativo
AssetGroupStatus

Requisiti

Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Usato da

AddAssetGroups
GetAssetGroupsByCampaignId
GetAssetGroupsByIds
UpdateAssetGroups