Oggetto dati AccountProperty - Campaign Management

Esegue il mapping del nome di una proprietà a livello di account a un valore stringa.

Sintassi

<xs:complexType name="AccountProperty" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Name" type="tns:AccountPropertyName" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Elementi

L'oggetto AccountProperty include gli elementi seguenti: Name, Value.

Elemento Descrizione Tipo di dati
Nome Nome della proprietà dell'account. AccountPropertyName
Valore Valore della proprietà account denominata.

Il valore varia in base al nome della proprietà dell'account. Per altre informazioni, vedere Valori delle proprietà dell'account nella sezione seguente.
Stringa

Osservazioni

Valori delle proprietà dell'account

AdClickParallelTracking

Determina se il rilevamento parallelo è abilitato.

Se usi il monitoraggio degli URL, quando i clienti fanno clic sul tuo annuncio, in genere devono passare attraverso una serie di reindirizzamenti prima di raggiungere la tua pagina. Questo è noto come rilevamento sequenziale.

Con il monitoraggio parallelo, quando i clienti fanno clic sul tuo annuncio, visualizzano immediatamente la tua pagina di destinazione. Contemporaneamente, Microsoft Advertising esegue gli URL di rilevamento in background. L'esperienza utente dei clienti è quindi migliorata e si ottiene comunque lo stesso ottimo monitoraggio delle misurazioni.

È necessario avere {lpurl} o una delle relative varianti nel modello di rilevamento dell'URL per il funzionamento del rilevamento parallelo. Per altre informazioni, vedere Monitoraggio parallelo che consente ai clienti di accedere più rapidamente alla pagina di destinazione e Quali parametri di rilevamento o URL è possibile usare?.

Se l'elemento Name è impostato su AdClickParallelTracking, il valore restituito può essere true o false. Se il valore è true, il rilevamento parallelo è abilitato.

Importante

Il rilevamento parallelo è necessario per tutti gli account creati dopo il 31 maggio 2020. Fino a gennaio 2021 è possibile abilitare e disabilitare la funzionalità per gli account creati prima del 1° giugno 2020, ad esempio impostare la proprietà su true o false. Entro la metà di gennaio 2021 tutti gli account saranno abilitati per il rilevamento parallelo e il valore può essere impostato solo su true.

AllowImageAutoRetrieve

Determina se Microsoft Advertising è autorizzato a usare le immagini del tuo dominio per migliorare i tuoi annunci su Microsoft Audience Network.

Importante

Acconsentendo esplicitamente, l'utente accetta che le immagini o i contenuti creativi recuperati dalla pagina di destinazione dell'Inserzionista siano contenuti "forniti dall'Inserzionista con la licenza di utilizzo dei contenuti nel Contratto pubblicitario ( Sezione 2) e che l'Inserzionista accetti che Microsoft possa usare tale contenuto per la creazione automatica di annunci ed estensioni per loro.

Nota

Non tutti hanno ancora questa funzionalità. Se non lo fai, non preoccuparti, è presto disponibile!

Se l'elemento Name è impostato su AllowImageAutoRetrieve, il valore può essere impostato su true o false. Se il valore è true, la funzionalità di recupero automatico dell'immagine è abilitata.

AutoApplyRecommendations

Determina se Microsoft Advertising è autorizzato ad applicare automaticamente le raccomandazioni pubblicitarie per migliorare le prestazioni degli annunci.

Avviso

AutoApplyRecommendations in Campaign Management API è deprecato a partire dal 30 novembre 2022. È consigliabile usare la nuova interfaccia di gestione applicazione automatica nell'API Ad Insight.

Nota

Non tutti hanno ancora questa funzionalità. Se non lo fai, non preoccuparti, è presto disponibile!

Ti faremo sapere quando gli annunci suggeriti sono pronti per la revisione. Puoi trovare consigli sugli annunci nella pagina Raccomandazioni. Se non si interviene, verranno applicate automaticamente dopo il periodo di revisione:

  • Annunci multimediali: 7 giorni
  • Tutti gli altri: 14 giorni

È possibile modificare le opzioni di applicazione automatica in qualsiasi momento. Se non scegli di applicare automaticamente le raccomandazioni per gli annunci, potrai comunque applicare le raccomandazioni manualmente.

Se l'elemento Name è impostato su AutoApplyRecommendations, il valore può includere un elenco di tipi di raccomandazione.

All'interno dell'elemento Value , l'elenco di coppie chiave-valore è delimitato da un punto e virgola (;). In questo esempio, le raccomandazioni per l'applicazione automatica degli annunci sono abilitate per gli annunci multimediali, ma non per gli annunci di ricerca reattivi o per gli annunci di testo espansi.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>AutoApplyRecommendations</Name>
      <Value>MultimediaAdsAutoApply=true;ResponsiveSearchAdsAutoApply=false;ExpandedTextAdsAutoApply=false</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Le coppie chiave/valore predefinite sono:

  • MultimediaAdsAutoApply=true;
  • ResponsiveSearchAdsAutoApply=false;
  • ExpandedTextAdsAutoApply=false;

Se il valore di una chiave è impostato su true, la funzionalità di applicazione automatica è abilitata per il tipo di raccomandazione.

È possibile scegliere di impostare solo le coppie chiave-valore da aggiornare. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.

BusinessAttributes

Consente di evidenziare i valori aziendali chiave per migliorare le prestazioni degli annunci.

Gli attributi aziendali sono facoltativi ed è possibile scegliere uno o più attributi applicabili all'azienda.

Se l'elemento Name è impostato su BusinessAttributes, value può includere un elenco di tipi di attributo.

All'interno dell'elemento Value l'elenco di attributi business è delimitato da un punto e virgola (;). I valori possibili includono: AlcoholFree, AllergyFriendly, AsianOwned, BlackOwned, CarbonNegative, CarbonNeutral, CrueltyFree, DiabeticFriendly, EcoFriendly, FamilyFriendly, FamilyOwned, GlutenFree, Halal, HearingAssistance, Kosher, LatinOwned, LocalBusiness, LGBTQIFriendly, LGBTQIOwned, MinorityOwned, MobilityAssistance, NoContactDelivery, Nonprofit, PetFriendly, SmallBusiness, SupportACure, SupportDiseaseResearch, Sustainable, Vegan, Vegetarian, VisualAssistance, TouchlessPickup, Unisex, WebAccessibility, WheelchairAccessible e WomenOwned.

In questo esempio, gli attributi aziendali selezionati sono Senza alcol, Famiglia e Vegan.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>BusinessAttributes</Name>
      <Value>AlcoholFree;FamilyOwned;Vegan</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Se l'attributo viene visualizzato nella proprietà value, viene selezionato; se l'attributo non viene visualizzato nella proprietà value, non è selezionato.

Per eliminare gli attributi aziendali dell'account, impostare Name su BusinessAttributes e Value su "" (stringa vuota).

È possibile scegliere di impostare solo gli attributi aziendali da aggiornare. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.

FinalUrlSuffix

Se l'elemento Name è impostato su FinalUrlSuffix, value rappresenta il suffisso URL finale dell'account.

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.

Per eliminare il suffisso URL finale dell'account, impostare Name su FinalUrlSuffix e Value su "" (stringa vuota).

IncludeViewThroughConversions

Determina se si desidera includere le conversioni view-through per le campagne nell'account.

Le conversioni view-through sono conversioni che le persone effettuano dopo aver visto il tuo annuncio, anche se non hanno fatto clic sull'annuncio.

Se l'elemento Name è impostato su IncludeViewThroughConversions, il valore può essere impostato su true o false. Se il valore è true, verranno incluse le conversioni view-through. Per impostazione predefinita, se si è nel progetto pilota di funzionalità (GetCustomerPilotFeatures restituisce 616) questa proprietà è impostata su true, ovvero i valori nelle colonne "Tutte" delle conversioni dei report sulle prestazioni includeranno conversioni view-through. È possibile scegliere di disabilitarla se non si vogliono includere conversioni view-through.

Nota

Le conversioni view-through richiedono un UETTag, quindi questa proprietà non è applicabile per AppInstallGoal, InStoreTransactionGoal e OfflineConversionGoal.

MSCLKIDAutoTaggingEnabled

Determina se l'assegnazione automatica di tag al parametro della stringa di query MSCLKID è abilitata. MSCLKID è un GUID di 32 caratteri univoco per ogni clic pubblicitario.

Se l'elemento Name è impostato su MSCLKIDAutoTaggingEnabled, il valore può essere impostato su true o false. Se il valore è true, la funzionalità di assegnazione automatica di tag MSCLKID è abilitata. È possibile abilitare l'assegnazione automatica di tag a MSCLKID per il rilevamento dei lead tramite obiettivi di conversione offline. Se l'assegnazione automatica di tag di MSCLKID è abilitata, l'MSCLKID viene aggiunto automaticamente all'URL della pagina di destinazione quando un cliente fa clic sull'annuncio. Ad esempio, www.contoso.com/?msclkid={msclkid}. L'ID clic è univoco per ogni clic pubblicitario e più clic sullo stesso annuncio dello stesso utente genereranno più ID clic.

Importante

Il valore MSCLKIDAutoTaggingEnabled verrà impostato su true per impostazione predefinita quando viene creato un nuovo account. È possibile disattivare manualmente se è disattivato. Ogni volta che si aggiunge o si aggiorna un nuovo oggetto DurationGoal, EventGoal, OfflineConversionGoal, PagesViewedPerVisitGoal o UrlGoal tramite l'applicazione Web Microsoft Advertising o l'API Campaign Management, il valore MSCLKIDAutoTaggingEnableddell'accountProperty corrispondente viene impostato automaticamente su true . Se l'ambito dell'obiettivo è impostato su Livello cliente , verrà impostata la proprietà AccountProperty per tutti gli account esistenti in Customer.

ProfileExpansionEnabled

Determina se espandere il profilo LinkedIn destinato all'intero account per raggiungere clienti aggiuntivi simili a quelli di destinazione.

L'abilitazione dell'espansione del targeting del profilo consente a Microsoft Advertising di mostrare i tuoi annunci ad altri clienti simili a quelli di destinazione. Ad esempio, se si ha come destinazione un segmento di pubblico LinkedIn specifico, verranno indirizzati anche gli utenti Bing che non hanno un account LinkedIn confermato ma che condividono le stesse caratteristiche degli utenti LinkedIn in tale segmento.

Se l'elemento Name è impostato su ProfileExpansionEnabled, il valore può essere impostato su true o false. Se il valore è true, la funzionalità di espansione di destinazione del profilo LinkedIn è abilitata.

TrackingUrlTemplate

Se l'elemento Name è impostato su TrackingUrlTemplate, value rappresenta il modello di rilevamento dell'account da usare come valore predefinito per tutti gli URL dell'account. Il valore della chiave TrackingUrlTemplate può essere impostato su qualsiasi stringa valida, come descritto di seguito.

  • I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio la parola chiave, 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}.

  • È necessario includere almeno uno dei parametri url della pagina di destinazione seguenti: {lpurl}, {lpurl+2}, {lpurl+3}, {unescapedlpurl}, {escapedlpurl}. Inoltre, è possibile usare qualsiasi parametro dinamico supportato da Microsoft Advertising. Per un elenco dei parametri supportati, vedere le sezioni Parametri disponibili nell'articolo Della Guida di Microsoft Advertising Configurare un modello di rilevamento.

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

Per eliminare il modello di rilevamento dell'account, impostare Name su TrackingUrlTemplate e Value su "" (stringa vuota).

Requisiti

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

Usato da

GetAccountProperties
SetAccountProperties