Oggetto dati BiddableAdGroupCriterion - Campaign Management

  • Articolo

Definisce un criterio di offerta da applicare al gruppo di annunci specificato.

Sintassi

<xs:complexType name="BiddableAdGroupCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:AdGroupCriterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="CriterionBid" nillable="true" type="tns:CriterionBid" />
        <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:AdGroupCriterionEditorialStatus" />
        <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
        <xs:element xmlns:q81="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q81:ArrayOfstring" />
        <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
        <xs:element xmlns:q82="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q82:ArrayOfstring" />
        <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
        <xs:element minOccurs="0" name="CriterionCashback" nillable="true" type="tns:CriterionCashback">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto BiddableAdGroupCriterion include gli elementi seguenti: CriterionBid, CriterionCashback, DestinationUrl, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, TrackingUrlTemplate, UrlCustomParameters.

Elemento Descrizione Tipo di dati
CriterionBid L'offerta da utilizzare nell'asta.

Se il criterio ereditato è un criterio di pagina Web , è necessario usare fixedbid. Se il criterio ereditato è productpartition, è necessario usare un oggetto FixedBid , a meno che l'opzione Sponsored Products BidOption non sia impostata su BidBoost.Per informazioni dettagliate, vedere ProductPartition Usage di seguito. Per tutti gli altri criteri del gruppo di annunci offerte, usare BidMultiplier. Se non si usa il tipo di oggetto corretto, l'offerta richiesta verrà ignorata: se l'offerta è necessaria, l'operazione avrà esito negativo; Se l'offerta è facoltativa, verrà usata l'offerta predefinita.

Aggiungere: I requisiti variano a seconda del tipo di criterio ereditato. L'offerta è facoltativa e verrà impostata sul valore predefinito 0 se non è inclusa per i criteri AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion, RadiusCriterion, AudienceCriterion e Webpage . L'offerta non è applicabile a LocationIntentCriterion (il servizio non restituirà alcun errore e l'offerta verrà ignorata anche se la si include). Quando si aggiunge un Oggetto ProductPartition con l'operazione ApplyProductPartitionActions , l'offerta è necessaria a meno che il tipo di partizione del prodotto non sia Suddivisione, nel qual caso l'offerta non è consentita.
Aggiornamento: I requisiti variano a seconda del tipo di criterio ereditato. L'offerta è necessaria per AgeCriterion, DayTimeCriterion, DeviceCriterion, GenderCriterion, LocationCriterion, ProfileCriterion e RadiusCriterion. L'offerta non è applicabile a LocationIntentCriterion (il servizio non restituirà alcun errore e l'offerta verrà ignorata anche se la si include). Per i criteri AudienceCriterion e Webpage l'offerta è facoltativa e se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Quando si aggiorna un oggetto ProductPartition con l'operazione ApplyProductPartitionActions , l'offerta è facoltativa e, se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 CriterionBid
CriterionCashback Riservati. CriterionCashback
DestinationUrl URL della pagina Web a cui l'utente viene indirizzato quando fa clic sull'annuncio.

Questo elemento viene utilizzato solo se il criterio ereditato è un criterio ProductPartition . Per informazioni dettagliate, vedere ProductPartition Usage (Utilizzo productpartition) di seguito.		 Stringa
EditorialStatus Parametro riservato per utilizzi futuri. AdGroupCriterionEditorialStatus
FinalAppUrls Parametro riservato per utilizzi futuri. Matrice AppUrl
FinalMobileUrls Parametro riservato per utilizzi futuri. matrice di stringhe
FinalUrls Parametro riservato per utilizzi futuri. matrice di stringhe
FinalUrlSuffix Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Questo elemento viene utilizzato solo se il criterio ereditato è un criterio ProductPartition o Webpage . Per informazioni dettagliate, vedere Utilizzo di ProductPartition e Utilizzo pagina Web di seguito.		 Stringa
TrackingUrlTemplate I modelli di rilevamento sono i casi in cui è possibile specificare parametri di rilevamento URL usati insieme all'URL finale o alla pagina di destinazione.

È consigliabile aggiungere il modello di rilevamento a livello di account e quindi applicarlo a tutti gli URL per entità di livello inferiore, ad esempio campagne, gruppi di annunci e annunci. Per altre informazioni, vedere gli articoli della Guida di Microsoft Advertising sul rilevamento degli URL con URL aggiornati.

Questo elemento viene utilizzato solo se il criterio ereditato è un criterio ProductPartition o Webpage . Per informazioni dettagliate, vedere Utilizzo di ProductPartition e Utilizzo pagina Web di seguito.		 Stringa
UrlCustomParameters Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

Questo elemento viene utilizzato solo se il criterio ereditato è un criterio ProductPartition o Webpage . Per informazioni dettagliate, vedere Utilizzo di ProductPartition e Utilizzo pagina Web di seguito.		 CustomParameters

L'oggetto BiddableAdGroupCriterion include elementi ereditati.

Elementi ereditati

Elementi ereditati da AdGroupCriterion

L'oggetto BiddableAdGroupCriterion deriva dall'oggetto AdGroupCriterion e eredita gli elementi seguenti: AdGroupId, Criterion, Id, Status, Type. Le descrizioni seguenti sono specifiche di BiddableAdGroupCriterion e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto AdGroupCriterion .

Elemento Descrizione Tipo di dati
AdGroupId Identificatore del gruppo di annunci a cui applicare il criterio.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio		 long
Criterio Criterio da applicare al gruppo di annunci. Il criterio consente di determinare se gli annunci nel gruppo di annunci vengono pubblicati.

Per un elenco dei tipi di criteri disponibili, vedere AdGroupCriterionType.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.		 Criterio
Id Identificatore univoco di Microsoft Advertising per il criterio del gruppo di annunci.

Aggiungere: Sola lettura
Aggiornamento: Obbligatorio		 long
Stato Valore di stato che determina se il criterio si applica al gruppo di annunci.

Per la maggior parte dei criteri del gruppo di annunci offerte, l'unico valore di stato supportato è Attivo. Per le eccezioni, vedere Utilizzo della pagina Web di seguito.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 AdGroupCriterionStatus
Tipo Tipo di criterio del gruppo di annunci. Questo valore è BiddableAdGroupCriterion quando si recupera un criterio del gruppo di annunci disponibile. Per altre informazioni sui tipi di criteri del gruppo di annunci, vedere le osservazioni sull'oggetto dati AdGroupCriterion.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura		 Stringa

Osservazioni

Utilizzo productpartition

Se il criterio ereditato è un criterio ProductPartition , tenere presente l'utilizzo seguente delle proprietà BiddableAdGroupCriterion .

CriterionBid

Per impostazione predefinita, l'asta userà un valore FixedBid per i gruppi di prodotti. È necessario usare un'opzione FixedBid , a meno che l'opzione Sponsored Products BidOption non sia impostata su BidBoost. se l'opzione Sponsored Products BidOption è impostata su BidBoost, BidMultiplier rappresenta la percentuale (maggiore di zero) usata per amplificare l'offerta del partner.

Si supponga, ad esempio, che il partner presenti un'offerta di $5 USD nel gruppo di prodotti (FixedBid tramite CriterionBid). Se la rettifica dell'offerta (BidMultiplier tramite CriterionBid) è impostata su 20 (percentuale) e BidMaxValue del gruppo di annunci è 0,50 (50 centesimi), la quota sarà di 50 centesimi e non di 1 USD.

DestinationUrl

Se attualmente si usano gli URL di destinazione, è necessario sostituirli con Modelli di rilevamento. Per altre informazioni, vedere Rilevamento url con URL aggiornati.

L'URL può contenere parametri dinamici, ad esempio {MatchType}. Per un elenco dei parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?.

L'URL può contenere un massimo di 1.024 caratteri. Se l'URL non specifica un protocollo, il sistema usa il protocollo HTTP quando un utente fa clic sull'annuncio. Se l'URL specifica il protocollo HTTP quando si aggiunge un annuncio, il servizio rimuoverà la stringa del protocollo http:// (la stringa del protocollo HTTP non viene conteggiata rispetto al limite di 1.024 caratteri); tuttavia, il servizio non rimuoverà una stringa di protocollo HTTPS (https://) dall'URL.

L'URL di destinazione viene usato se specificato; in caso contrario, l'URL di destinazione è determinato dal valore corrispondente del 'Link' specificato per l'offerta del prodotto nel catalogo di Microsoft Merchant Center.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.

FinalUrlSuffix

Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.

TrackingUrlTemplate

I modelli di rilevamento possono essere usati insieme all'URL specificato nel campo "Collegamento" per l'offerta di prodotto inviata tramite l'API Contenuto. Combinando l'URL del feed con il modello di rilevamento, l'URL della pagina di destinazione viene assemblato in cui un utente viene indirizzato dopo aver fatto clic sull'annuncio. Quando usi l'elemento TrackingUrlTemplate per aggiornare i parametri URL invece di aggiornarli nell'URL del feed, l'URL del feed non deve passare attraverso la revisione editoriale e gli annunci continueranno a essere pubblicati senza interruzioni. Ad esempio, se l'URL dell'offerta di prodotto nel feed di catalogo è , è https://contoso.com/possibile specificare il modello di rilevamento seguente: {lpurl}?matchtype={matchtype}&device={device}.

Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?

  • I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.

  • La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.

  • Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.

  • Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.

UrlCustomParameters

Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

Microsoft Advertising accetterà i primi 8 oggetti CustomParameter inclusi nell'oggetto CustomParameters e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Ogni CustomParameter include elementi Key e Value .

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare l'elemento UrlCustomParameters su null o vuoto per mantenere eventuali parametri personalizzati esistenti. Per rimuovere tutti i parametri personalizzati, impostare l'elemento Parameters dell'oggetto CustomParameters su null o vuoto. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere nell'elemento Parameters dell'oggetto CustomParameters .

Utilizzo pagina Web

Se il criterio ereditato è un criterio di pagina Web , tenere presente l'utilizzo seguente delle proprietà BiddableAdGroupCriterion .

FinalUrlSuffix

Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.

Stato

Valore di stato che determina se il criterio si applica al gruppo di annunci.

È possibile impostare lo stato su Attivo o Sospeso. Non è possibile impostare lo stato su Eliminato.

Aggiungere: Opzionale.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.

TrackingUrlTemplate

Per il criterio pagina Web , i modelli di rilevamento possono essere usati insieme all'URL della pagina di destinazione generato dinamicamente dal dominio specificato per la campagna Annunci di ricerca dinamica. Combinando il dominio con il modello di rilevamento, l'URL della pagina di destinazione viene assemblato in cui un utente viene indirizzato dopo aver fatto clic sull'annuncio. Ecco un modello di rilevamento di esempio: {lpurl}?matchtype={matchtype}&device={device}.

Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?

  • I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.

  • La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.

  • Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.

  • Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo elemento su una stringa vuota ("",), l'impostazione precedente verrà eliminata.

UrlCustomParameters

Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

Microsoft Advertising accetterà i primi 8 oggetti CustomParameter inclusi nell'oggetto CustomParameters e, se si includono più di 8 parametri personalizzati, verrà restituito un errore. Ogni CustomParameter include elementi Key e Value .

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare l'elemento UrlCustomParameters su null o vuoto per mantenere eventuali parametri personalizzati esistenti. Per rimuovere tutti i parametri personalizzati, impostare l'elemento Parameters dell'oggetto CustomParameters su null o vuoto. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere nell'elemento Parameters dell'oggetto CustomParameters .

Requisiti

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