Enregistrement d’élément de flux - En bloc

Définit un élément de flux qui peut être téléchargé et chargé dans un fichier en bloc.

Conseil

Pour obtenir une vue d’ensemble de l’utilisation des flux et des éléments de flux, consultez les guides techniques Flux du personnalisateur d’annonces, Flux d’inventaire automatique et Flux de page .

Remarque

• Mettez à niveau vos annonces textuelles développées en annonces de recherche réactives d’après le 1er février 2023. Après cette date, vous ne serez plus en mesure de créer ou de modifier des annonces textuelles développées existantes. Pour plus d’informations, consultez À propos des annonces de recherche réactive.
• Vos flux planifiés continueront à s’exécuter et les annonces texte développées existantes utilisant des flux de personnalisateur d’annonces continueront à être diffusées. Vous serez en mesure d’afficher des rapports sur leurs performances.
• Vous pourrez toujours suspendre, exécuter ou supprimer vos flux de personnalisateur d’annonces existants. Sinon, les tentatives de création ou de modification de personnalisateurs d’annonces publicitaires existants pour les annonces textuelles développées entraînent une CustomerNotEligibleForAdCustomizersFeed erreur.
• En savoir plus sur cette modification.

Si vous créez des entités parentes et enfants dans le même fichier en bloc, les enregistrements dépendants doivent être inclus après les dépendances en fonction de la hiérarchie :

1. Flux
2. Campagne
3. Groupe d’annonces
4. Élément de flux

Vous pouvez avoir 100 flux par compte (ce nombre maximal inclut tous les types de flux) et le nombre maximal d’éléments de flux (lignes) par compte est de 5 millions.

Vous pouvez télécharger tous les enregistrements d’élément de flux dans le compte en incluant la valeur DownloadEntity de FeedItems dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple csv en bloc suivant ajoute un nouveau flux de page et un flux de personnalisateur d’annonces avec un élément de flux pour chacun.

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""}"

Si vous utilisez les Kits de développement logiciel (SDK) Bing Ads pour .NET, Java ou Python, vous pouvez gagner du temps à l’aide de BulkServiceManager pour charger et télécharger l’objet BulkFeedItem , au lieu d’appeler directement les opérations de service et d’écrire du code personnalisé pour analyser chaque champ dans le fichier en bloc.

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();

Pour un enregistrement d’élément de flux , les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

• Groupe d’annonces
• Planification des annonces
• ID d’audience
• Campagne
• Client Id
• Attributs personnalisés
• Préférence d’appareil
• Date de fin
• Id
• Mot clé
• Type de correspondance
• Heure de modification
• Parent Id
• Intention physique
• Date de début
• État
• Target (Cible)
• ID du groupe d’annonces cibles
• ID de campagne cible

Groupe d’annonces

Nom du groupe d’annonces utilisé pour cibler l’élément de flux. Si ce champ est défini, l’élément de flux est uniquement éligible pour le groupe d’annonces spécifié.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Ajouter: Optionnel. Si vous incluez ce champ, le champ Campagne doit également être défini et le groupe d’annonces doit exister dans la campagne spécifiée. Si les champs Groupe d’annonces et ID du groupe d’annonces cibles sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc.
Mettre à jour: Optionnel. Si vous incluez ce champ, le champ Campagne doit également être défini et le groupe d’annonces doit exister dans la campagne spécifiée. Si les champs Groupe d’annonces et ID du groupe d’annonces cibles sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

Planification des annonces

Liste des plages de jours et de temps auxquelles vous souhaitez que l’élément de flux s’affiche avec vos annonces. Chaque jour et intervalle de temps inclut le jour de la semaine, l’heure de début/fin et la minute de début/fin planifiée. Chaque plage de jours et de temps est placée entre parenthèses gauche et droite, et séparées des autres plages de jour et de temps par un point-virgule (;) délimiteur. Dans chaque jour et intervalle de temps, le format est Day[StartHour :StartMinue-EndHour :EndMinute].

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Les valeurs possibles de StartHour sont comprises entre 00 et 23, où 00 équivaut à 12h00 et 12h00 à 12h00.

Les valeurs possibles de EndHour sont comprises entre 00 et 24, où 00 équivaut à 12 :00 et 12  :00.

Les valeurs possibles de StartMinute et EndMinute sont comprises entre 00 et 60.

L’exemple suivant illustre les plages de jour et de temps pendant les jours de la semaine de 9h00 à 21h00 : (lundi[09 :00-21 :00]);( Mardi[09 :00-21 :00]) ; (Mercredi[09 :00-21 :00]) ; (jeudi[09 :00-21 :00]) ; (Vendredi[09 :00-21 :00])

Ajouter: Optionnel. Si vous ne définissez pas ce champ, l’élément de flux peut être planifié à tout moment pendant les dates de début et de fin du calendrier.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Les plages de jours et de temps individuelles ne peuvent pas être mises à jour. Vous pouvez mettre à jour efficacement les plages de jours et de temps en envoyant un nouvel ensemble qui doit remplacer l’ensemble précédent. Si vous ne définissez pas ce champ, les paramètres existants sont conservés. Si vous définissez ce champ sur delete_value, vous supprimez efficacement toutes les plages de jours et de temps existantes.
Supprimer: En lecture seule

ID d’audience

Identificateur Microsoft Advertising de l’audience, par exemple, liste de remarketing utilisée pour cibler l’élément de flux. Si ce champ est défini, l’élément de flux est uniquement éligible pour l’audience spécifiée.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Ajouter: Optionnel.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

Campagne

Nom de la campagne utilisée pour cibler l’élément de flux. Si ce champ est défini, l’élément de flux est uniquement éligible pour la campagne spécifiée.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Ajouter: Optionnel. Si les champs Campagne et ID de campagne cible sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc.
Mettre à jour: Optionnel. Si les champs Campagne et ID de campagne cible sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

ID client

Permet d’associer des enregistrements du fichier de chargement en bloc aux enregistrements du fichier de résultats. La valeur de ce champ n’est pas utilisée ou stockée par le serveur ; il est simplement copié de l’enregistrement chargé vers l’enregistrement de résultat correspondant. Il peut s’agir d’une chaîne valide d’une longueur maximale de 100.

Ajouter: Optionnel
Mettre à jour: Optionnel
Supprimer: En lecture seule

Attributs personnalisés

Les attributs sont personnalisés pour chaque sous-type de flux et définissent les informations sur vos produits ou services que vous souhaitez insérer dans vos publicités.

Pour le sous-type de flux AdCustomizerFeed, vous pouvez inclure jusqu’à 100 attributs personnalisés par élément de flux où chaque nom d’attribut personnalisé est unique.

Pour le sous-type DynamicDataAutosListingFeed , vous pouvez inclure jusqu’à 100 attributs personnalisés par élément de flux où chaque nom d’attribut personnalisé est unique.

Pour le sous-type de flux PageFeed, vous pouvez inclure un ou deux attributs personnalisés par élément de flux où chaque nom d’attribut personnalisé est unique.

Les attributs personnalisés sont représentés dans le fichier en bloc sous la forme d’une chaîne JSON. Pour plus d’informations, consultez feedAttributeType, isPartOfKey et nom ci-dessous.

Voici des exemples d’attributs personnalisés que vous pouvez charger pour un flux de page.

Remarque

Dans le fichier en bloc séparé par des virgules, vous devez entourer la liste des attributs, chaque clé d’attribut et chaque valeur d’attribut avec un ensemble supplémentaire de guillemets doubles, par exemple, la chaîne JSON ci-dessus est écrite sous la forme « [{""name" » :"Page URL" »,"feedAttributeType" » :"Url »,"isPartOfKey" » :true},{"name" » : » :"name » : » : » « "Custom Label" »,""feedAttributeType" » :""StringList""},{""name" » :"Ad Title" »,"feedAttributeType" » :""String""}] ».

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

Voici des exemples d’attributs personnalisés que vous pouvez charger pour un flux de personnalisateur d’annonces.

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

Ajouter: Obligatoire. Pour un personnalisateur de publicité et un élément de flux DynamicDataAutosListing, vous devez définir au moins un attribut avec une paire clé/valeur valide. Pour un flux de page, vous devez définir au moins un attribut dont le nom est défini sur « Url de la page ».
Mettre à jour: Optionnel. Pour conserver tous les attributs personnalisés existants pour l’élément de flux, définissez ou laissez ce champ vide. Si vous définissez ce champ, tous les attributs personnalisés précédemment définis pour cet élément de flux seront remplacés.
Supprimer: En lecture seule

feedAttributeType

Type de données de chaque attribut personnalisé. Vous définissez le type de données dans l’enregistrement de flux, puis définissez des valeurs dans l’élément de flux. Tant que chaque nom d’attribut personnalisé est unique dans le flux, vous pouvez définir plusieurs attributs avec le même type de données.

Il existe quatre types de données différents feedAttributeType que vous pouvez définir pour les flux de personnalisateur d’annonces :

feedAttributeType	Cas d'utilisation	Valeurs d’élément de flux acceptées
Chaîne	Noms de produits, catégories de produits, descriptions	Lettres, chiffres ou symboles
Int64	Nombre d’inventaires, nombre de couleurs disponibles	N’importe quel nombre entier
Price	Coût du produit, remise sur la vente	N’importe quel nombre (y compris les décimales) et les caractères monétaires valides
Date/heure	Heure de début de l’événement, dernier jour d’une vente	aaaa/mm/jj HH :mm :ss Pour que la valeur par défaut soit minuit au début de la journée, vous pouvez omettre la partie HH :mm :ss.

Par exemple, nous pouvons définir les attributs personnalisés d’un flux de personnalisateur d’annonces.

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

Ensuite, nous pouvons mapper chaque nom de flux, c’est-à-dire « DateTimeName », « Int64Name », « PriceName » et « StringName » dans le chargement de l’élément de flux :

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

Il existe six types de données différents feedAttributeType que vous pouvez définir pour les flux DynamicDataAutosListing :

feedAttributeType	Cas d'utilisation	Valeurs d’élément de flux acceptées
Chaîne	Nom du véhicule, catégorie de véhicule, description	Lettres, chiffres ou symboles
Int64	année du véhicule, moteur	N’importe quel nombre entier
Price	Coût du véhicule, remise sur la vente	N’importe quel nombre (y compris les décimales) et les caractères monétaires valides
Date/heure	Heure de début de l’événement, dernier jour d’une vente	aaaa/mm/jj HH :mm :ss Pour que la valeur par défaut soit minuit au début de la journée, vous pouvez omettre la partie HH :mm :ss.
Url	Contient l’URL de votre site web à inclure dans le flux.	Vous devez inclure une URL par élément de flux.
StringList	Étiquettes qui vous permettent de regrouper les URL dans le flux.	Vous pouvez inclure entre une et dix étiquettes personnalisées par élément de flux. Chaque étiquette personnalisée est représentée sous la forme d’un élément de liste en notation JSON. Par exemple, la partie étiquette personnalisée de l’élément de flux peut être écrite sous la forme « "Étiquette personnalisée » :[""Label_1_3001 »,""Label_2_3001"""]

Par exemple, nous pouvons définir les attributs personnalisés d’un flux 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"
	}
]

Ensuite, nous pouvons mapper chaque nom de flux, c’est-à-dire « DateTimeName », « Int64Name », « PriceName » et « StringName » dans le chargement de l’élément de flux :

{
	"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"
	],
}

Voici les feedAttributeType types de données que vous pouvez définir pour les flux de page :

feedAttributeType	Cas d'utilisation	Valeurs d’élément de flux acceptées
Chaîne	Titre statique affiché au lieu du titre généré dynamiquement.	Toutes les lettres, chiffres ou symboles jusqu’à 63 caractères. Vous pouvez inclure un titre d’annonce par élément de flux.
StringList	Étiquettes qui vous permettent de regrouper les URL dans le flux.	Vous pouvez inclure entre une et dix étiquettes personnalisées par élément de flux. Chaque étiquette personnalisée est représentée sous la forme d’un élément de liste en notation JSON. Par exemple, la partie étiquette personnalisée de l’élément de flux peut être écrite sous la forme « "Étiquette personnalisée » :[""Label_1_3001 »,""Label_2_3001"""]
Url	Contient l’URL de votre site web à inclure dans le flux.	Vous devez inclure une URL par élément de flux.

Par exemple, nous pouvons définir les attributs personnalisés du flux de page.

Remarque

est feedAttributeType facultatif pour les flux de page. Si vous définissez , feedAttributeTypeil doit être défini sur « Url » pour « Url de page », « StringList » pour « Étiquette personnalisée » et « String » pour les attributs nommés « Ad Title ».

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

Ensuite, nous pouvons mapper chaque nom de flux, c’est-à-dire « URL de page », « Étiquette personnalisée » et « Titre de l’annonce » dans le chargement de l’élément de flux :

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

isPartOfKey

détermine isPartOfKey si les valeurs d’un attribut personnalisé doivent être uniques dans tous les enregistrements d’éléments de flux qui sont cumulatifs au flux. Si est isPartOfKey défini sur « true », les valeurs doivent être uniques ; sinon, vous pouvez charger des valeurs en double pour le même attribut personnalisé.

Pour les flux de personnalisateur d’annonces et les éléments de flux, une chaîne nommée « ID personnalisé » est toujours traitée comme une clé unique, c’est-à-dire que est isPartOfKey toujours « true ». L’attribut « Id personnalisé » est actuellement le seul moyen de définir une clé unique pour les flux de personnalisateurs d’annonces via l’application web Microsoft Advertising. Avec l’API en bloc, vous avez plus de flexibilité pour utiliser n’importe quel nom d’attribut comme clé unique.

Pour les flux de page et les éléments de flux, l'« URL de page » est toujours traitée comme une clé unique, c’est-à-dire que est isPartOfKey toujours « true ».

Pour les flux et les éléments de flux DynamicDataAutosListing, le « VehicleId » est toujours traité comme une clé unique, c’est-à-dire que est isPartOfKey toujours « true ».

nom

L’attribut name est utilisé pour mapper un attribut personnalisé distinct entre l’élément flux et l’élément de flux. En fait, c’est ainsi que vous vous assurez qu’un élément de flux spécifique se cumule à la même « colonne » dans le flux. Dans l’exemple de personnalisateur de publicité au-dessus des noms « DateTimeName », « Int64Name », « PriceName » et « StringName » sont utilisés à la fois dans le flux et l’élément de flux.

Préférence d’appareil

Ce champ détermine si la préférence est que l’élément de flux s’affiche sur les appareils mobiles ou sur tous les appareils.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Les valeurs possibles sont All et Mobile, qui diffèrent des valeurs utilisées dans le service de gestion des campagnes.

SixMonths

Dans le fichier de résultats de téléchargement et de chargement en bloc, ce champ n’est jamais vide. Si vous n’avez pas spécifié de préférence d’appareil, la valeur par défaut All est retournée.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé. Si vous définissez ce champ sur delete_value, vous réinitialisez la valeur par défaut de Tous.
Supprimer: En lecture seule

End Date

Chaîne de date de fin planifiée de l’élément de flux au format aaaa/mm/jj HH :mm :ss. Pour que la valeur par défaut soit minuit au début de la journée, vous pouvez omettre la partie HH :mm :ss.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

La date de fin est incluse. Par exemple, si vous définissez ce champ sur 31/12/2020 00 :00 :00, l’élément de flux cessera d’être éligible à 00h00 le 31/12/2020.

Ajouter: Optionnel. Si vous ne spécifiez pas de date de fin, l’élément de flux continuera d’être remis, sauf si vous suspendez les campagnes, groupes d’annonces ou annonces associés.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. La date de fin peut être raccourcie ou prolongée, tant que la date de début est null ou se produit avant la nouvelle date de fin. Si vous ne définissez pas ce champ, les paramètres existants sont conservés. Si vous définissez ce champ sur delete_value, vous supprimez effectivement la date de fin et l’élément de flux continuera d’être remis, sauf si vous suspendez les campagnes, groupes d’annonces ou annonces associés.
Supprimer: En lecture seule

ID

Identificateur généré par le système du flux.

Ajouter: En lecture seule
Mettre à jour: Lecture seule et Obligatoire
Supprimer: Lecture seule et Obligatoire

Mot clé

Texte mot clé.

Le texte peut contenir un maximum de 100 caractères.

Vous devez spécifier le mot clé dans les paramètres régionaux de la langue de la campagne ou du groupe d’annonces cible.

Ajouter: Obligatoire
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Type de correspondance

Type de correspondance pour comparer le mot clé et le terme de recherche de l’utilisateur.

Les valeurs de type de correspondance prises en charge pour un mot clé sont Broad, Exact et Phrase.

Ajouter: Obligatoire
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Heure de modification

Date et heure de la dernière mise à jour de l’entité. La valeur est exprimée au format UTC (temps universel coordonné).

Remarque

La valeur de date et d’heure reflète la date et l’heure sur le serveur, et non le client. Pour plus d’informations sur le format de la date et de l’heure, consultez l’entrée dateTime dans Types de données XML primitifs.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Parent Id

Identificateur généré par le système du flux parent.

Les attributs personnalisés et le sous-type du flux parent déterminent quels attributs personnalisés sont valides pour cet élément de flux. Actuellement, les flux de personnalisateurs d’annonces et les flux de page sont pris en charge, et d’autres types de flux pourraient être ajoutés à l’avenir.

Ajouter: En lecture seule
Mettre à jour: En lecture seule
Supprimer: En lecture seule

Intention physique

Détermine si une personne doit être physiquement située à l’emplacement cible pour que l’élément de flux soit éligible.

Par défaut, l’élément de flux peut être affiché aux personnes dans, recherchant ou affichant des pages sur votre emplacement ciblé. Définissez ce champ sur ContactsIn si vous souhaitez uniquement que l’élément de flux soit affiché aux personnes physiquement situées à l’emplacement cible.

Ajouter: Optionnel. Si vous définissez ce champ, l’emplacement cible doit également être défini.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé. Si vous définissez ce champ sur delete_value, vous réinitialisez efficacement la valeur par défaut de PeopleIn.
Supprimer: En lecture seule

Date de début

Chaîne de date de début planifiée de l’élément de flux au format aaaa/mm/jj HH :mm :ss. Pour que la valeur par défaut soit minuit au début de la journée, vous pouvez omettre la partie HH :mm :ss.

La date de début est incluse. Par exemple, si vous définissez ce champ sur 2020/06/15 00 :00 :00, l’élément de flux commencera à être éligible à 12h00 le 15 juin 2020.

Ajouter: Optionnel. Si vous ne spécifiez pas de date de début, l’élément de flux est immédiatement éligible pour être planifié pendant la journée et les intervalles de temps.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. La date de début peut être raccourcie ou prolongée, tant que la date de fin est null ou se produit après la nouvelle date de début. Si vous ne définissez pas ce champ, les paramètres existants sont conservés. Si vous définissez ce champ sur delete_value, vous supprimez effectivement la date de début et l’élément de flux est immédiatement éligible pour être planifié pendant la journée et les intervalles de temps.
Supprimer: En lecture seule

Statut

Status de l’élément de flux.

Les valeurs possibles sont Active ou Deleted.

Ajouter: Optionnel. La valeur par défaut est Active.
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.
Supprimer: Obligatoire. L’état doit être défini sur Supprimé.

Target

Identificateur de l’emplacement utilisé pour cibler l’élément de flux. Si ce champ est défini, l’élément de flux est uniquement éligible pour l’emplacement spécifié.

Si vous souhaitez cibler uniquement les personnes physiquement dans un emplacement, vous devez également définir le champ Intention physique .

L’identificateur d’emplacement correspond au champ Id d’emplacement du fichier d’emplacements géographiques. Pour plus d’informations, consultez Codes d’emplacement géographique et GetGeoLocationsFileUrl.

Ajouter: Optionnel
Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

ID du groupe d’annonces cibles

Identificateur du groupe d’annonces utilisé pour cibler l’élément de flux. Si ce champ est défini, l’élément de flux est uniquement éligible pour le groupe d’annonces spécifié.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Ajouter: Optionnel. Si vous définissez également le champ Campagne (non obligatoire), le groupe d’annonces doit exister dans la campagne spécifiée. Si les champs Groupe d’annonces et ID du groupe d’annonces cibles sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc.
Mettre à jour: Optionnel. Si vous définissez également le champ Campagne (non obligatoire), le groupe d’annonces doit exister dans la campagne spécifiée. Si les champs Groupe d’annonces et ID du groupe d’annonces cibles sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule

ID de campagne cible

Identificateur de la campagne utilisée pour cibler l’élément de flux. Si ce champ est défini, l’élément de flux est uniquement éligible pour la campagne spécifiée.

Remarque

Ce champ s’applique uniquement aux flux de personnalisateur d’annonces.

Ajouter: Optionnel. Si les champs Campagne et ID de campagne cible sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc.
Mettre à jour: Optionnel. Si les champs Campagne et ID de campagne cible sont définis, une erreur est retournée pour cet enregistrement dans le fichier en bloc. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Si vous définissez ce champ sur la chaîne delete_value , le paramètre précédent est supprimé.
Supprimer: En lecture seule