Record elemento feed - Bulk

Definisce un elemento feed che può essere scaricato e caricato in un file bulk.

Consiglio

Per una panoramica su come usare feed ed elementi del feed, vedi le guide tecniche Feed di Personalizzazione annunci, Feed di inventario automatico e Feed di pagine .

Nota

• Aggiorna gli annunci di testo espansi agli annunci di ricerca reattivi entro il 1° febbraio 2023. Dopo questa data, non sarà più possibile creare annunci di testo espansi nuovi o modificare quelli esistenti. Per altre informazioni, vedi Informazioni sugli annunci di ricerca reattivi.
• I feed pianificati continueranno a essere eseguiti e gli annunci di testo espansi esistenti usando i feed di personalizzazione degli annunci continueranno a essere pubblicati. Sarà possibile visualizzare i report sulle prestazioni.
• Potrai comunque sospendere, eseguire o rimuovere i feed di personalizzazione degli annunci esistenti. In caso contrario, i tentativi di creare o modificare gli strumenti di personalizzazione degli annunci esistenti per gli annunci di testo espansi genereranno un CustomerNotEligibleForAdCustomizersFeed errore.
• Altre informazioni su questa modifica.

Se si creano nuove entità padre e figlio nello stesso file bulk, i record dipendenti devono essere inclusi dopo le dipendenze in base alla gerarchia:

1. Feed
2. Campagna
3. Gruppo di annunci
4. Elemento feed

È possibile avere 100 feed per account (questo numero massimo include tutti i tipi di feed) e il numero massimo di elementi di feed (righe) per account è 5 milioni.

È possibile scaricare tutti i record dell'elemento feed nell'account includendo il valore DownloadEntity di FeedItems nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.

L'esempio csv bulk seguente aggiungerebbe un nuovo feed di pagine e un feed di personalizzazione degli annunci con un elemento feed per ogni elemento.

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Target Campaign Id,Target Ad Group Id,Client Id,Modified Time,Start Date,End Date,Device Preference,Keyword,Match Type,Target,Physical Intent,Name,Ad Schedule,Audience Id,Feed Name,Custom Attributes
Format Version,,,,,,,,,,,,,,,,,,6,,,,
Feed,Active,-20,,PageFeed,,,,,PageFeedClientIdGoesHere,,,,,,,,,,,,MyPageFeedName,"[{""name"":""Page Url"",""feedAttributeType"":""Url"",""isPartOfKey"":true},{""name"":""Custom Label"",""feedAttributeType"":""StringList""},{""name"":""Ad Title"",""feedAttributeType"":""String""}]"
Feed,Active,-21,,AdCustomizerFeed,,,,,AdCustomizerFeedClientIdGoesHere,,,,,,,,,,,,MyAdCustomizerFeedName,"[{""name"":""DateTimeName"",""feedAttributeType"":""DateTime""},{""name"":""Int64Name"",""feedAttributeType"":""Int64""},{""name"":""PriceName"",""feedAttributeType"":""Price""},{""name"":""StringName"",""feedAttributeType"":""String"",""isPartOfKey"":true}]"
Feed,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,-21,,DynamicDataAutosListingFeed,,"[{""name"":""Vehicle ID""},{""name"":""Final URL""},{""name"":""Image URL""},{""name"":""Make""},{""name"":""Model""},{""name"":""Price""},{""name"":""Title""},{""name"":""Target campaign""},{""name"":""Target ad group""},{""name"":""Latitude""},{""name"":""Longitude""},{""name"":""Mileage value""},{""name"":""Mileage unit""},{""name"":""Year""},{""name"":""Fuel type""},{""name"":""Transmission""},{""name"":""City""},{""name"":""VIN""},{""name"":""State of vehicle""}]"
Feed Item,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,,-21,,,"{""Vehicle Id"":""2g161290-1d13"",""""Final Url"""":""https:\/\/www.contoso.com\/used-Redmond1"",""Image Urls"":""https:\/\/www.contoso.com\/inventoryphotos\/01.jpg;https:\/\/www.contoso.com\/inventoryphotos\/02.jpg"",""Make"":""Contoso"",""Model"":""SUV"",""Price"":""65495.00 USD"",""Title"":""2020 SUV"",""Target campaign"":""CampaignName"",""Target ad group"":"""",""Latitude"":"""",""Logitude"":"""",""Mileage Value"":""13000"",""Mileage Unit"":""MI"",""Year"":""2020"",""Fuel Type"":"""",""Transmission"":"""",""City"":""Redmond"",""Vin"":""SALLJGML8HA004044"",""State of Vehicle"":""USED"",""Trim"":""HSE""}"
Feed Item,Active,-200,-20,,,,20;200,,2020/06/22 00:00:00,2020/06/30 00:00:00,,,,,,,,,,"{""Page Url"":""https://contoso.com/3001"",""Custom Label"":[""Label_1_3001"",""Label_2_3001""],""Ad Title"":""An ad title""}"
Feed Item,Active,-210,-21,,,,21;210,,2020/06/22 00:00:00,2020/06/30 00:00:00,,value,Broad,,PeopleIn,,(Sunday[09:00-17:00]),,,"{""DateTimeName"":""2020/06/22 00:00:00"",""Int64Name"":237601,""PriceName"":""$601"",""StringName"":""s237601""}"

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkFeedItem , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkFeedItem
var bulkAdCustomizerFeedItem = new BulkFeedItem
{
	// 'Parent Id' column header in the Bulk file
	FeedId = adCustomizerFeedIdKey,
	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = adCustomizerFeedItemCustomAttributesJson,
	// 'Id' column header in the Bulk file
	Id = null,
	// 'Target Ad Group Id' column header in the Bulk file
	AdGroupId = null,
	// 'Ad Group' column header in the Bulk file
	AdGroupName = null,
	// 'Audience Id' column header in the Bulk file
	AudienceId = null,
	// 'Target Campaign Id' column header in the Bulk file
	CampaignId = null,
	// 'Campaign' column header in the Bulk file
	CampaignName = null,
	// 'Ad Schedule' column header in the Bulk file
	DayTimeRanges = new[]
	{
		// Each day and time range is delimited by a semicolon (;) in the Bulk file
		// Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
		new DayTime
		{
			Day = Day.Monday,
			StartHour = 9,
			StartMinute = Minute.Zero,
			EndHour = 21,
			EndMinute = Minute.Zero,
		},
	},
	// 'End Date' column header in the Bulk file
	EndDate = null,
	// 'Start Date' column header in the Bulk file
	StartDate = null,
	// 'Physical Intent' column header in the Bulk file
	IntentOption = IntentOption.PeopleIn,
	// 'Keyword' column header in the Bulk file
	Keyword = "insurance",
	// 'Target' column header in the Bulk file
	LocationId = 190,
	// 'Match Type' column header in the Bulk file
	MatchType = MatchType.Exact,
	// 'Device Preference' column header in the Bulk file
	DevicePreference = null,
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkAdCustomizerFeedItem);

// Map properties in the Bulk file to the BulkFeedItem
var bulkPageFeedItem = new BulkFeedItem
{
    // 'Parent Id' column header in the Bulk file
    FeedId = pageFeedIdKey,
    // 'Custom Attributes' column header in the Bulk file
    CustomAttributes = pageFeedItemCustomAttributesJson,
    // 'Id' column header in the Bulk file
    Id = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkPageFeedItem);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Per un record dell'elemento feed , i campi di attributo seguenti sono disponibili nello schema file bulk.

• Gruppo di annunci
• Pianificazione annunci
• ID gruppo di destinatari
• Campagna
• Client Id
• Attributi personalizzati
• Preferenza dispositivo
• Data di fine
• Id
• Parola chiave
• Tipo di corrispondenza
• Ora modifica
• Parent Id
• Finalità fisica
• Data inizio
• Stato
• Destinazione
• ID gruppo di annunci di destinazione
• ID campagna di destinazione

Gruppo di annunci

Nome del gruppo di annunci usato per impostare come destinazione l'elemento del feed. Se questo campo è impostato, l'elemento feed sarà idoneo solo per il gruppo di annunci specificato.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

Aggiungere: Opzionale. Se includi questo campo, anche il campo Campagna deve essere impostato e il gruppo di annunci deve esistere all'interno della campagna specificata. Se sono impostati entrambi i campi Gruppo di annunci e ID gruppo di annunci di destinazione , viene restituito un errore per questo record nel file bulk.
Aggiornamento: Opzionale. Se includi questo campo, anche il campo Campagna deve essere impostato e il gruppo di annunci deve esistere all'interno della campagna specificata. Se sono impostati entrambi i campi Gruppo di annunci e ID gruppo di annunci di destinazione , viene restituito un errore per questo record nel file bulk. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

Pianificazione annunci

Elenco degli intervalli di giorno e ora in cui vuoi che l'elemento del feed venga visualizzato con i tuoi annunci. Ogni giorno e intervallo di tempo include il giorno pianificato della settimana, l'ora di inizio/fine e il minuto di inizio/fine. Ogni intervallo di giorno e ora è racchiuso tra parentesi sinistra e destra e separato da altri intervalli di giorno e ora con un punto e virgola (;) delimitatore. All'interno di ogni giorno e intervallo di tempo il formato è Day[StartHour:StartMinue-EndHour:EndMinute].

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

I valori possibili di StartHour sono compresi tra 00 e 23, dove 00 equivale alle 12:00 e 12 alle 12:00.

I valori possibili di EndHour sono compresi tra 00 e 24, dove 00 equivale alle 12:00 e 12 :00.

I valori possibili di StartMinute e EndMinute sono compresi tra 00 e 60.

L'esempio seguente illustra gli intervalli di giorno e di ora durante i giorni feriali dalle 9:00 alle 21:00: (lunedì[09:00-21:00]);( martedì[09:00-21:00]); (Mercoledì[09:00-21:00]); (Giovedì[09:00-21:00]); (Venerdì[09:00-21:00])

Aggiungere: Opzionale. Se non si imposta questo campo, l'elemento feed sarà idoneo per la pianificazione in qualsiasi momento durante le date di inizio e fine del calendario.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. I singoli intervalli di giorno e ora non possono essere aggiornati. È possibile aggiornare in modo efficace gli intervalli di giorno e di ora inviando un nuovo set che deve sostituire il set precedente. Se non si imposta questo campo, le impostazioni esistenti verranno mantenute. Se si imposta questo campo su delete_value, verranno rimossi tutti gli intervalli di tempo e di giorno esistenti.
Elimina: Sola lettura

ID gruppo di destinatari

Identificatore di Microsoft Advertising del gruppo di destinatari, ad esempio l'elenco di remarketing usato per la destinazione dell'elemento del feed. Se questo campo è impostato, l'elemento feed sarà idoneo solo per il gruppo di destinatari specificato.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

Aggiungere: Opzionale.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

Campagna

Nome della campagna usata per impostare come destinazione l'elemento del feed. Se questo campo è impostato, l'elemento feed sarà idoneo solo per la campagna specificata.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

Aggiungere: Opzionale. Se sono impostati entrambi i campi Campagna e ID campagna di destinazione , viene restituito un errore per questo record nel file bulk.
Aggiornamento: Opzionale. Se sono impostati entrambi i campi Campagna e ID campagna di destinazione , viene restituito un errore per questo record nel file bulk. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

ID Client

Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.

Aggiungere: Opzionale
Aggiornamento: Opzionale
Elimina: Sola lettura

Attributi personalizzati

Gli attributi sono personalizzati per ogni sottotipo di feed e definiscono le informazioni sui prodotti o i servizi che vuoi inserire negli annunci.

Per il sottotipo di feed AdCustomizerFeed, è possibile includere fino a 100 attributi personalizzati per ogni elemento del feed in cui ogni nome di attributo personalizzato è univoco.

Per il sottotipo DynamicDataAutosListingFeed , è possibile includere fino a 100 attributi personalizzati per ogni elemento del feed in cui ogni nome di attributo personalizzato è univoco.

Per il sottotipo di feed PageFeed, è possibile includere uno o due attributi personalizzati per ogni elemento del feed in cui ogni nome di attributo personalizzato è univoco.

Gli attributi personalizzati sono rappresentati nel file bulk come stringa JSON. Per altri dettagli, vedere feedAttributeType, isPartOfKey e il nome riportato di seguito.

Ecco alcuni attributi personalizzati di esempio che è possibile caricare per un feed di pagine.

Nota

Nel file bulk separato da virgole è necessario racchiudere l'elenco di attributi, ogni chiave di attributo e ogni valore di attributo con un set aggiuntivo di virgolette doppie, ad esempio La stringa JSON precedente verrà scritta come "[{""name":""Page Url"","feedAttributeType"":"Url"","isPartOfKey"":true},{""name"":"Custom Label"","feedAttributeType"":"String""}",{"name":""Ad Title"","feedAttributeType"":"String""}]".

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

Di seguito sono riportati gli attributi personalizzati di esempio che è possibile caricare per un feed di personalizzazione degli annunci.

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

Aggiungere: Obbligatorio. Per un elemento del feed DynamicDataAutosListing e per un personalizzatore di annunci devi impostare almeno un attributo con una coppia di chiave e valore valida. Per un feed di pagina è necessario impostare almeno un attributo con il nome impostato su "URL pagina".
Aggiornamento: Opzionale. Per mantenere tutti gli attributi personalizzati esistenti per l'elemento feed, impostare o lasciare vuoto questo campo. Se si imposta questo campo, tutti gli attributi personalizzati impostati in precedenza per questo elemento di feed verranno sostituiti.
Elimina: Sola lettura

feedAttributeType

Tipo di dati di ogni attributo personalizzato. Si definisce il tipo di dati nel record del feed e quindi si impostano i valori nell'elemento del feed. Finché ogni nome di attributo personalizzato è univoco all'interno del feed, è possibile definire più attributi con lo stesso tipo di dati.

Sono disponibili quattro diversi feedAttributeType tipi di dati che è possibile impostare per i feed di personalizzazione degli annunci:

feedAttributeType	Situazioni di utilizzo	Valori dell'elemento feed accettati
Stringa	Nomi di prodotti, categorie di prodotti, descrizioni	Lettere, numeri o simboli
Int64	Numero di inventario, numero di colori disponibili	Qualsiasi numero intero
Prezzo	Costo del prodotto, sconto per la vendita	Qualsiasi numero (inclusi i decimali) e caratteri di valuta validi
DateTime	Ora di inizio evento, ultimo giorno di vendita	aaaa/mm/gg HH:mm:ss Per impostazione predefinita a mezzanotte all'inizio della giornata, è possibile omettere la parte HH:mm:ss.

Ad esempio, è possibile definire gli attributi personalizzati di un feed di personalizzazione degli annunci.

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	}
]

È quindi possibile eseguire il mapping di ogni nome di feed, ad esempio "DateTimeName", "Int64Name", "PriceName" e "StringName" nel caricamento dell'elemento del feed:

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

Sono disponibili sei diversi feedAttributeType tipi di dati che è possibile impostare per i feed DynamicDataAutosListing:

feedAttributeType	Situazioni di utilizzo	Valori dell'elemento feed accettati
Stringa	Nome del veicolo, categoria di veicolo, descrizione	Lettere, numeri o simboli
Int64	anno del veicolo, motore	Qualsiasi numero intero
Prezzo	Costo del veicolo, sconto per la vendita	Qualsiasi numero (inclusi i decimali) e caratteri di valuta validi
DateTime	Ora di inizio evento, ultimo giorno di vendita	aaaa/mm/gg HH:mm:ss Per impostazione predefinita a mezzanotte all'inizio della giornata, è possibile omettere la parte HH:mm:ss.
Url	Contiene l'URL del sito Web da includere nel feed.	È necessario includere un URL per elemento feed.
StringList	Etichette che consentono di raggruppare gli URL all'interno del feed.	È possibile includere da una a dieci etichette personalizzate per elemento feed. Ogni etichetta personalizzata è rappresentata come voce di elenco nella notazione JSON. Ad esempio, la parte personalizzata dell'etichetta dell'elemento feed può essere scritta come ""Etichetta personalizzata":[""Label_1_3001"",""Label_2_3001"""]

Ad esempio, è possibile definire gli attributi personalizzati di un feed DynamicDataAutosListing.

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	},
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	}
]

È quindi possibile eseguire il mapping di ogni nome di feed, ad esempio "DateTimeName", "Int64Name", "PriceName" e "StringName" nel caricamento dell'elemento feed :

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601",
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
}

Questi sono i feedAttributeType tipi di dati che è possibile impostare per i feed di pagine:

feedAttributeType	Situazioni di utilizzo	Valori dell'elemento feed accettati
Stringa	Titolo statico visualizzato invece del titolo generato dinamicamente.	Lettere, numeri o simboli fino a 63 caratteri. Puoi includere un titolo per ogni elemento del feed.
StringList	Etichette che consentono di raggruppare gli URL all'interno del feed.	È possibile includere da una a dieci etichette personalizzate per elemento feed. Ogni etichetta personalizzata è rappresentata come voce di elenco nella notazione JSON. Ad esempio, la parte personalizzata dell'etichetta dell'elemento feed può essere scritta come ""Etichetta personalizzata":[""Label_1_3001"",""Label_2_3001"""]
Url	Contiene l'URL del sito Web da includere nel feed.	È necessario includere un URL per elemento feed.

Ad esempio, è possibile definire gli attributi personalizzati del feed di pagine.

Nota

È feedAttributeType facoltativo per i feed di pagine. Se si imposta feedAttributeType, deve essere impostato su "Url" per "URL pagina", "StringList" per "Etichetta personalizzata" e "String" per gli attributi denominati "Titolo annuncio".

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

È quindi possibile eseguire il mapping di ogni nome di feed, ad esempio "URL pagina", "Etichetta personalizzata" e "Titolo annuncio" nel caricamento dell'elemento feed :

{
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
    "Ad Title": "Find New Customers & Increase Sales!",
}

isPartOfKey

Determina isPartOfKey se i valori per un attributo personalizzato devono essere univoci in tutti i record dell'elemento del feed che vengono riportati al feed. Se è isPartOfKey impostato su "true", i valori devono essere univoci e in caso contrario è possibile caricare valori duplicati per lo stesso attributo personalizzato.

Per i feed e gli elementi del feed di ad customizer, una stringa denominata "ID personalizzato" viene sempre considerata come una chiave univoca, ad esempio l'oggetto isPartOfKey è sempre "true". L'attributo "Id personalizzato" è attualmente l'unico modo per impostare una chiave univoca per i feed di personalizzazione degli annunci tramite l'applicazione Web Microsoft Advertising. Con l'API bulk è più flessibile usare qualsiasi nome di attributo come chiave univoca.

Per i feed di pagine e gli elementi del feed, l'"URL pagina" viene sempre considerato come una chiave univoca, ovvero è isPartOfKey sempre "true".

Per i feed e gli elementi del feed DynamicDataAutosListing il "VehicleId" viene sempre considerato come una chiave univoca, ad esempio , è isPartOfKey sempre "true".

Nome

L'attributo name viene usato per eseguire il mapping di un attributo personalizzato distinto sia all'elemento feed che all'elemento feed. In effetti, questo è il modo in cui si garantisce che un elemento di feed specifico venga eseguito il rollup nella stessa "colonna" nel feed. Nell'esempio di personalizzazione degli annunci sopra i nomi "DateTimeName", "Int64Name", "PriceName" e "StringName" vengono usati sia nel feed che nell'elemento feed.

Preferenza dispositivo

Questo campo determina se la preferenza è per l'elemento feed da visualizzare nei dispositivi mobili o in tutti i dispositivi.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

I valori possibili sono Tutti e Dispositivi mobili, che differiscono dai valori usati nel servizio di gestione della campagna.

Il valore predefinito è All.

Nel file dei risultati di download e caricamento bulk questo campo non sarà mai vuoto. Se non è stata specificata una preferenza per il dispositivo, verrà restituito il valore predefinito All.If you did not specify a device preference, the default value of All will be returned.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa. Se si imposta questo campo su delete_value, verrà ripristinato il valore predefinito Di tutto.
Elimina: Sola lettura

Data di fine

Stringa della data di fine pianificata dell'elemento feed formattata come aaaa/mm/gg HH:mm:ss. Per impostazione predefinita a mezzanotte all'inizio della giornata, è possibile omettere la parte HH:mm:ss.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

La data di fine è inclusiva. Ad esempio, se si imposta questo campo su 2020/12/31 00:00:00, l'elemento feed smetterà di essere idoneo alle 12:00 del 31/12/2020.

Aggiungere: Opzionale. Se non specifichi una data di fine, l'elemento del feed continuerà a essere recapitato a meno che non sospendi le campagne, i gruppi di annunci o gli annunci associati.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. La data di fine può essere abbreviata o estesa, purché la data di inizio sia Null o si verifichi prima della nuova data di fine. Se non si imposta questo campo, le impostazioni esistenti verranno mantenute. Se imposti questo campo su delete_value, stai effettivamente rimuovendo la data di fine e l'elemento feed continuerà a essere recapitato a meno che non sospendi le campagne, i gruppi di annunci o gli annunci associati.
Elimina: Sola lettura

Id

Identificatore generato dal sistema del feed.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Parola chiave

Testo della parola chiave.

Il testo può contenere un massimo di 100 caratteri.

Devi specificare la parola chiave nelle impostazioni locali della lingua della campagna o del gruppo di annunci di destinazione.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura

Tipo di corrispondenza

Tipo di corrispondenza per confrontare la parola chiave e il termine di ricerca dell'utente.

I valori di tipo di corrispondenza supportati per una parola chiave sono Broad, Exact e Phrase.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura
Elimina: Sola lettura

Ora modifica

Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Nota

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

Parent Id

Identificatore generato dal sistema del feed padre.

Gli attributi personalizzati e il tipo di sottotipo del feed padre determinano quali attributi personalizzati sono validi per questo elemento del feed. Attualmente sono supportati feed di personalizzazione annunci e feed di pagine e altri tipi di feed potrebbero essere aggiunti in futuro.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

Finalità fisica

Determina se una persona deve trovarsi fisicamente nella posizione di destinazione affinché l'elemento feed sia idoneo.

Per impostazione predefinita, l'elemento del feed può essere visualizzato agli utenti in , alla ricerca o alla visualizzazione di pagine sulla posizione di destinazione. Impostare questo campo su PeopleIn se si vuole visualizzare solo l'elemento del feed agli utenti che si trovano fisicamente nella posizione di destinazione.

Aggiungere: Opzionale. Se si imposta questo campo, è necessario impostare anche La posizione di destinazione .
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa. Se si imposta questo campo su delete_value, verrà ripristinato il valore predefinito di PeopleIn.
Elimina: Sola lettura

Data inizio

Stringa della data di inizio pianificata dell'elemento feed formattata come aaaa/mm/gg HH:mm:ss. Per impostazione predefinita a mezzanotte all'inizio della giornata, è possibile omettere la parte HH:mm:ss.

La data di inizio è inclusiva. Ad esempio, se si imposta questo campo su 2020/06/15 00:00:00, l'elemento feed inizierà a essere idoneo alle 12:00 del 15 giugno 2020.

Aggiungere: Opzionale. Se non si specifica una data di inizio, l'elemento del feed è immediatamente idoneo per essere pianificato durante il giorno e gli intervalli di tempo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. La data di inizio può essere abbreviata o estesa, purché la data di fine sia Null o si verifichi dopo la nuova data di inizio. Se non si imposta questo campo, le impostazioni esistenti verranno mantenute. Se si imposta questo campo su delete_value, si rimuove in modo efficace la data di inizio e l'elemento del feed è immediatamente idoneo per essere pianificato durante il giorno e gli intervalli di tempo.
Elimina: Sola lettura

Stato

Stato dell'elemento feed.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Destinazione

Identificatore della posizione utilizzata per l'elemento del feed di destinazione. Se questo campo è impostato, l'elemento feed sarà idoneo solo per la posizione specificata.

Se si vuole impostare come destinazione solo le persone fisicamente in una posizione, è necessario impostare anche il campo Finalità fisica .

L'identificatore di posizione corrisponde al campo Id posizione del file delle posizioni geografiche. Per altre informazioni, vedere Geographical Location Codes e GetGeoLocationsFileUrl.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

ID gruppo di annunci di destinazione

Identificatore del gruppo di annunci usato per impostare come destinazione l'elemento del feed. Se questo campo è impostato, l'elemento feed sarà idoneo solo per il gruppo di annunci specificato.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

Aggiungere: Opzionale. Se imposti anche il campo Campagna (non obbligatorio), il gruppo di annunci deve esistere all'interno della campagna specificata. Se sono impostati entrambi i campi Gruppo di annunci e ID gruppo di annunci di destinazione , viene restituito un errore per questo record nel file bulk.
Aggiornamento: Opzionale. Se imposti anche il campo Campagna (non obbligatorio), il gruppo di annunci deve esistere all'interno della campagna specificata. Se sono impostati entrambi i campi Gruppo di annunci e ID gruppo di annunci di destinazione , viene restituito un errore per questo record nel file bulk. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

ID campagna di destinazione

Identificatore della campagna usata per la destinazione dell'elemento feed. Se questo campo è impostato, l'elemento feed sarà idoneo solo per la campagna specificata.

Nota

Questo campo è applicabile solo ai feed di personalizzazione degli annunci.

Aggiungere: Opzionale. Se sono impostati entrambi i campi Campagna e ID campagna di destinazione , viene restituito un errore per questo record nel file bulk.
Aggiornamento: Opzionale. Se sono impostati entrambi i campi Campagna e ID campagna di destinazione , viene restituito un errore per questo record nel file bulk. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura