フィード項目レコード - 一括

[アーティクル]
10/04/2023

一括ファイルでダウンロードおよびアップロードできるフィード項目を定義します。

ヒント

フィードとフィード項目の使用方法の概要については、広告カスタマイザーフィード、自動在庫フィード、ページフィードに関するテクニカルガイドを参照してください。

注:

拡張テキスト広告を、2023 年 2 月 1 日までにレスポンシブ検索広告にアップグレードします。この日付を過ぎると、新しいテキスト広告を作成したり、既存の拡張テキスト広告を編集したりできなくなります。詳細については、「レスポンシブ検索広告について」を参照してください。
スケジュールされたフィードは引き続き実行され、広告カスタマイザーフィードを使用して拡張された既存のテキスト広告は引き続き配信されます。パフォーマンスに関するレポートを表示できます。
既存の広告カスタマイザーフィードは引き続き一時停止、実行、削除できます。そうしないと、拡張テキスト広告の既存の広告カスタマイザーを作成または編集しようとすると、エラーが発生 CustomerNotEligibleForAdCustomizersFeed します。
この変更の詳細については、こちらをご覧ください。

同じ Bulk ファイルに新しい親エンティティと子エンティティを作成する場合は、階層に従って依存関係の後に依存レコードを含める必要があります。

アカウントごとに 100 個のフィードを作成できます (この最大数にはすべてのフィードの種類が含まれます)、アカウントあたりのフィード項目 (行) の最大数は 500 万です。

アカウント内のすべてのフィード項目レコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に FeedItems の DownloadEntity 値を含めます。さらに、ダウンロード要求には EntityData スコープを含める必要があります。ベストプラクティスを含む一括サービスの詳細については、「一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、新しいページフィードと広告カスタマイザーフィードを追加し、それぞれに 1 つのフィード項目を追加します。

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

.NET、Java、または Python 用の Bing Ads SDK を使用している場合は、 BulkServiceManager を使用して BulkFeedItem オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタムコードを記述して一括ファイル内の各フィールドを解析する代わりにします。

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

フィード項目レコードの場合、一括ファイルスキーマでは、次の属性フィールドを使用できます。

広告グループ
広告スケジュール
対象ユーザー ID
キャンペーン
クライアント ID
カスタム属性
デバイスの基本設定
終了日
Id
キーワード
一致の種類
変更時刻
Parent Id
物理意図
開始日
状態
Target
ターゲット広告グループ ID
ターゲットキャンペーン ID

広告グループ

フィードアイテムのターゲットに使用する広告グループの名前。このフィールドが設定されている場合、フィードアイテムは指定された広告グループにのみ適用されます。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

追加： オプション。このフィールドを含める場合は、[ キャンペーン ] フィールドも設定する必要があり、広告グループは指定したキャンペーン内に存在する必要があります。 [広告グループ] フィールドと [ターゲット広告グループ ID] フィールドの両方が設定されている場合、一括ファイル内のこのレコードに対してエラーが返されます。
更新： オプション。このフィールドを含める場合は、[ キャンペーン ] フィールドも設定する必要があり、広告グループは指定したキャンペーン内に存在する必要があります。 [広告グループ] フィールドと [ターゲット広告グループ ID] フィールドの両方が設定されている場合、一括ファイル内のこのレコードに対してエラーが返されます。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

広告スケジュール

フィードアイテムを広告と共に表示する曜日と時間の範囲の一覧。各曜日と時間範囲には、スケジュールされた曜日、開始時刻/終了時間、開始/終了分が含まれます。各日と時刻の範囲は左と右のかっこで囲み、他の日と時刻の範囲からセミコロン (;)区切り記号で区切られます。日付と時刻の範囲内の形式は 、Day[StartHour:StartMinue-EndHour:EndMinute] です。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

StartHour の値の範囲は 00 から 23 です。00 は午前 12:00 に相当し、12 は午後 12 時です。

EndHour の値の範囲は 00 から 24 です。00 は午前 12:00 に相当し、12 は午後 12:00 です。

StartMinute と EndMinute の使用可能な値の範囲は 00 から 60 です。

次の例では、平日の午前 9:00 から午後 9:00 までの曜日と時間の範囲を示します 。(月曜日[09:00-21:00]);(火曜日[09:00-21:00]);(水曜日[09:00-21:00]);(木曜日[09:00-21:00]);(金曜日[09:00-21:00])

追加： オプション。このフィールドを設定しない場合は、カレンダーの開始日と終了日時にフィードアイテムをスケジュールする資格があります。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。個々の日と時刻の範囲を更新することはできません。前のセットを置き換える必要がある新しいセットを送信することで、日と時刻の範囲を効果的に更新できます。このフィールドを設定しない場合、既存の設定は保持されます。このフィールドを delete_valueに設定すると、既存の日付と時刻の範囲をすべて効果的に削除します。
削除： 読み取り専用

対象ユーザー ID

対象ユーザーの Microsoft 広告識別子 (たとえば、フィードアイテムのターゲットに使用されるリマーケティングリスト)。このフィールドが設定されている場合、フィードアイテムは指定された対象ユーザーにのみ適用されます。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

追加： オプション。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

キャンペーン

フィードアイテムのターゲットに使用するキャンペーンの名前。このフィールドが設定されている場合、フィードアイテムは指定したキャンペーンにのみ適用されます。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

追加： オプション。 [キャンペーン] フィールドと [ターゲットキャンペーン ID] フィールドの両方が設定されている場合は、一括ファイル内のこのレコードに対してエラーが返されます。
更新： オプション。 [キャンペーン] フィールドと [ターゲットキャンペーン ID] フィールドの両方が設定されている場合は、一括ファイル内のこのレコードに対してエラーが返されます。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

クライアント ID

一括アップロードファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。最大 100 の長さの任意の有効な文字列を指定できます。

追加： オプション
更新： オプション
削除： 読み取り専用

カスタム属性

属性はフィードのサブタイプごとにカスタマイズされ、広告に挿入する製品やサービスに関する情報を定義します。

AdCustomizerFeed フィードのサブタイプの場合、各カスタム属性名が一意であるフィード項目ごとに最大 100 個のカスタム属性を含めることができます。

DynamicDataAutosListingFeed サブタイプの場合、各カスタム属性名が一意であるフィード項目ごとに最大 100 個のカスタム属性を含めることができます。

PageFeed フィードのサブタイプには、各カスタム属性名が一意であるフィード項目ごとに 1 つまたは 2 つのカスタム属性を含めることができます。

カスタム属性は、一括ファイルで JSON 文字列として表されます。詳細については、 feedAttributeType、 isPartOfKey、および以下の名前を参照してください。

ページフィードにアップロードできるカスタム属性の例を次に示します。

注:

コンマ区切りの一括ファイルでは、属性の一覧、各属性キー、および各属性値を二重引用符の追加セット (例: ) で囲む必要があります。上記の JSON 文字列は "[{"name":""Page Url"","feedAttributeType"":"Url"",""isPartOfKey"":true},{"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"
	}
]

広告カスタマイザーフィードにアップロードできるカスタム属性の例を次に示します。

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

追加： 必須。広告カスタマイザーと DynamicDataAutosListing フィード項目の場合は、有効なキーと値のペアで少なくとも 1 つの属性を設定する必要があります。ページフィードの場合は、名前が "ページ URL" に設定されている属性を少なくとも 1 つ設定する必要があります。
更新： オプション。フィード項目の既存のカスタム属性をすべて保持するには、このフィールドを空のままにします。このフィールドを設定すると、このフィード項目に対して以前に設定されていたカスタム属性が置き換えられます。
削除： 読み取り専用

feedAttributeType

各カスタム属性のデータ型。フィードレコードでデータ型を定義し、フィード項目に値を設定します。各カスタム属性名がフィード内で一意である限り、同じデータ型で複数の属性を定義できます。

広告カスタマイザーフィードには、次の 4 種類 feedAttributeType のデータ型を設定できます。

feedAttributeType	ユースケース	受け入れられたフィード項目の値
String	製品名、製品カテゴリ、説明	任意の文字、数字、または記号
Int64	在庫数、利用可能な色の数	任意の整数
Price	製品コスト、販売割引	任意の数値 (小数部を含む) と有効な通貨文字
DateTime	イベントの開始時刻、セールの最終日	yyyy/mm/dd HH:mm:ss 既定では、1 日の先頭の午前 0 時に、HH:mm:ss 部分を省略できます。

たとえば、広告カスタマイザーフィードのカスタム属性を定義できます。

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

次に、フィード項目のアップロードで、各フィード名 ("DateTimeName"、"Int64Name"、"PriceName"、"StringName" をマップできます。

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

DynamicDataAutosListing フィードには、次の 6 種類 feedAttributeType のデータ型を設定できます。

feedAttributeType	ユースケース	受け入れられたフィード項目の値
String	車両名、車両カテゴリ、説明	任意の文字、数字、または記号
Int64	車両年, エンジン	任意の整数
Price	車両コスト、販売割引	任意の数値 (小数部を含む) と有効な通貨文字
DateTime	イベントの開始時刻、セールの最終日	yyyy/mm/dd HH:mm:ss 既定では、1 日の先頭の午前 0 時に、HH:mm:ss 部分を省略できます。
Url	フィードに含める Web サイトの URL が含まれます。	フィード項目ごとに 1 つの URL を含める必要があります。
StringList	フィード内の URL をグループ化できるラベル。	フィード項目ごとに 1 ~ 10 個のカスタムラベルを含めることができます。各カスタムラベルは、JSON 表記でリストアイテムとして表されます。たとえば、フィード項目のカスタムラベル部分は""Custom Label":[""Label_1_3001",""Label_2_3001""" として記述できます。

たとえば、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"
	}
]

次に、フィード項目のアップロードで、各フィード名 ("DateTimeName"、"Int64Name"、"PriceName"、"StringName" をマップできます。

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

ページフィードに feedAttributeType 設定できるデータ型は次のとおりです。

feedAttributeType	ユースケース	受け入れられたフィード項目の値
String	動的に生成された見出しの代わりに表示される静的な見出し。	文字、数字、または最大 63 文字の記号。フィードアイテムごとに 1 つの広告タイトルを含めることができます。
StringList	フィード内の URL をグループ化できるラベル。	フィード項目ごとに 1 ~ 10 個のカスタムラベルを含めることができます。各カスタムラベルは、JSON 表記でリストアイテムとして表されます。たとえば、フィード項目のカスタムラベル部分は""Custom Label":[""Label_1_3001",""Label_2_3001""" として記述できます。
Url	フィードに含める Web サイトの URL が含まれます。	フィード項目ごとに 1 つの URL を含める必要があります。

たとえば、ページフィードのカスタム属性を定義できます。

注:

feedAttributeTypeは、ページフィードの場合は省略可能です。を feedAttributeType設定する場合は、"ページ URL" の場合は "Url"、"カスタムラベル" の場合は "StringList"、"Ad Title" には "String" という名前の属性を設定する必要があります。

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

次に、フィード項目のアップロードで、各フィード名 ("ページ URL"、"カスタムラベル"、"広告タイトル") をマップできます。

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

isPartOfKey

は isPartOfKey 、カスタム属性の値が、フィードにロールアップされるすべてのフィード項目レコードで一意である必要があるかどうかを決定します。 isPartOfKeyが "true" に設定されている場合、値は一意である必要があります。それ以外の場合は、同じカスタム属性の重複する値をアップロードできます。

広告カスタマイザーのフィードとフィード項目の場合、"カスタム ID" という名前の文字列は常に一意のキーとして扱われます。つまり、 isPartOfKey は常に "true" です。現在、"カスタム ID" 属性は、Microsoft Advertising Web アプリケーションを介して広告カスタマイザーフィードの一意のキーを設定する唯一の方法です。 Bulk API を使用すると、任意の属性名を一意のキーとして使用する柔軟性が高くなります。

ページフィードとフィード項目の場合、"ページ URL" は常に一意のキーとして扱われます。つまり、 isPartOfKey は常に "true" です。

DynamicDataAutosListing フィードとフィード項目の場合、"VehicleId" は常に一意のキーとして扱われます。つまり、 isPartOfKey は常に "true" です。

name

属性は name 、フィード項目とフィード項目の両方に個別のカスタム属性をマップするために使用されます。実質的に、これは、特定のフィード項目がフィード内の同じ "列" にロールアップされるようにする方法です。 "DateTimeName" の上の広告カスタマイザーの例では、フィード項目とフィード項目の両方で "Int64Name"、"PriceName"、"StringName" の名前が使用されています。

デバイスの基本設定

このフィールドは、フィード項目をモバイルデバイスに表示するか、すべてのデバイスに表示するかを設定します。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

使用可能な値は All と Mobile で、キャンペーン管理サービスで使用される値とは異なります。

既定値は All です。

一括ダウンロードとアップロードの結果ファイルでは、このフィールドが空になることはありません。デバイスの基本設定を指定しなかった場合は、 既定値の All が返されます。

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。このフィールドを delete_value に設定すると、実質的に既定値の All にリセットされます。
削除： 読み取り専用

終了日

yyyy/mm/dd HH:mm:ss として書式設定されたフィード項目のスケジュールされた終了日文字列。既定では、1 日の先頭の午前 0 時に、HH:mm:ss 部分を省略できます。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

終了日は包括的です。たとえば、このフィールドを 2020/12/31 00:00:00 に設定した場合、フィード項目は 2020 年 12 月 31 日の午前 12 時に適用されなくなります。

追加： オプション。終了日を指定しない場合、関連するキャンペーン、広告グループ、または広告を一時停止しない限り、フィードアイテムは引き続き配信されます。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。開始日が null であるか、新しい終了日より前に発生する限り、終了日は短縮または延長できます。このフィールドを設定しない場合、既存の設定は保持されます。このフィールドを [delete_value] に設定すると、実質的に終了日が削除され、関連するキャンペーン、広告グループ、または広告を一時停止しない限り、フィードアイテムは引き続き配信されます。
削除： 読み取り専用

Id

フィードのシステム生成識別子。

追加： 読み取り専用
更新： 読み取り専用と必須
削除： 読み取り専用と必須

キーワード

キーワードテキスト。

テキストには最大 100 文字を含めることができます。

キーワードは、ターゲットキャンペーンまたは広告グループの言語のロケールで指定する必要があります。

追加： 必須
更新： 読み取り専用
削除： 読み取り専用

一致の種類

キーワードとユーザーの検索用語を比較する一致の種類。

キーワードでサポートされている一致型の値は、 Broad、 Exact 、 Phrase です。

追加： 必須
更新： 読み取り専用
削除： 読み取り専用

変更時刻

エンティティが最後に更新された日付と時刻。値は、世界協定時刻 (UTC) です。

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。日付と時刻の形式については、「プリミティブ XML データ型」の dateTime エントリを参照してください。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

Parent Id

親フィードのシステム生成識別子。

親フィードのカスタム属性とサブタイプによって、このフィード項目に対して有効なカスタム属性が決まります。現在、広告カスタマイザーフィードとページフィードがサポートされており、他のフィードの種類は今後追加される可能性があります。

追加： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

物理意図

フィードアイテムを適格にするために、ターゲットの場所に人を物理的に配置する必要があるかどうかを決定します。

既定では、フィード項目は、対象となる場所に関するページの閲覧、検索、または表示のユーザーに表示できます。ターゲットの場所に物理的に配置されているユーザーにのみフィード項目を表示する場合は、このフィールドを PeopleIn に設定します。

追加： オプション。このフィールドを設定する場合は、ターゲットの場所も設定する必要があります。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。このフィールドを delete_value に設定すると、実質的に PeopleIn の既定値にリセットされます。
削除： 読み取り専用

開始日

yyyy/mm/dd HH:mm:ss として書式設定されたフィード項目のスケジュールされた開始日文字列。既定では、1 日の先頭の午前 0 時に、HH:mm:ss 部分を省略できます。

開始日は包括的です。たとえば、このフィールドを 2020/06/15 00:00:00 に設定した場合、フィードアイテムは 2020 年 6 月 15 日の午前 12 時に対象になります。

追加： オプション。開始日を指定しない場合、フィード項目は、その日と時間の範囲ですぐにスケジュールされる資格があります。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。終了日が null であるか、新しい開始日の後に発生する限り、開始日は短縮または延長できます。このフィールドを設定しない場合、既存の設定は保持されます。このフィールドを delete_value に設定すると、開始日が実質的に削除され、フィード項目は日と時刻の範囲ですぐにスケジュールされる資格があります。
削除： 読み取り専用

状態

フィード項目の状態。

使用可能な値は [アクティブ] または [削除済み] です。

追加： オプション。既定値は [アクティブ] です。
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

Target

フィード項目のターゲットに使用される場所の識別子。このフィールドが設定されている場合、フィード項目は指定された場所にのみ適用されます。

ある場所で物理的にユーザーのみをターゲットにする場合は、[ 物理意図 ] フィールドも設定する必要があります。

場所識別子は、地理的な場所ファイルの [場所 ID] フィールドに対応します。詳細については、「地理的な場所コード」と「GetGeoLocationsFileUrl」を参照してください。

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

ターゲット広告グループ ID

フィードアイテムのターゲットに使用される広告グループの識別子。このフィールドが設定されている場合、フィードアイテムは指定された広告グループにのみ適用されます。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

追加： オプション。 [ キャンペーン ] フィールドも設定した場合 (必須ではありません)、広告グループは指定したキャンペーン内に存在する必要があります。 [広告グループ] フィールドと [ターゲット広告グループ ID] フィールドの両方が設定されている場合、一括ファイル内のこのレコードに対してエラーが返されます。
更新： オプション。 [ キャンペーン ] フィールドも設定した場合 (必須ではありません)、広告グループは指定したキャンペーン内に存在する必要があります。 [広告グループ] フィールドと [ターゲット広告グループ ID] フィールドの両方が設定されている場合、一括ファイル内のこのレコードに対してエラーが返されます。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み取り専用

ターゲットキャンペーン ID

フィードアイテムのターゲットに使用されるキャンペーンの識別子。このフィールドが設定されている場合、フィードアイテムは指定したキャンペーンにのみ適用されます。

注:

このフィールドは、広告カスタマイザーフィードにのみ適用されます。

次の方法で共有

フィード項目レコード - 一括

広告グループ

広告スケジュール

対象ユーザー ID

キャンペーン

クライアント ID

カスタム属性

feedAttributeType

isPartOfKey

name

デバイスの基本設定

終了日

Id

キーワード

一致の種類

変更時刻

Parent Id

物理意図

開始日

状態

Target

ターゲット広告グループ ID

ターゲットキャンペーン ID

その他のリソース

次の方法で共有

フィード項目レコード - 一括

広告グループ

広告スケジュール

対象ユーザー ID

キャンペーン

クライアント ID

カスタム属性

feedAttributeType

isPartOfKey

name

デバイスの基本設定

終了日

Id

キーワード

一致の種類

変更時刻

Parent Id

物理意図

開始日

状態

Target

ターゲット広告グループ ID

ターゲット キャンペーン ID

その他のリソース

ターゲットキャンペーン ID