Location Ad Extension Record - Bulk

一括ファイルでダウンロードおよびアップロードできる位置情報広告拡張機能を定義します。

位置情報広告拡張機能は、アカウントまたはアカウント内のキャンペーンに関連付けることができます。 各エンティティ (アカウントまたはキャンペーン) は、アカウント内の位置情報広告表示オプションの合計数まで、決定した数だけ地域広告表示オプションに関連付けることができます。 [アカウントの場所の広告表示オプション] レコードと [キャンペーンの場所広告表示オプション] レコードを使用して、位置情報広告表示オプションの関連付けを管理します。

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

次の一括 CSV の例では、新しい Location Ad Extension をアカウントの共有ライブラリに追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Business Name,Phone Number,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Address Line 1,Address Line 2,Postal Code,City,State Or Province Code,Province Name,Latitude,Longitude,Country Code
Format Version,,,,,,,,,,,,,6.0,,,,,,,,,,,
Location Ad Extension,Active,-15,0,,,ClientIdGoesHere,,,12/31/2020,Contoso Shoes,206-555-0100,,,(Monday[09:00-21:00]),FALSE,1234 Washington Place,Suite 1210,98608,Woodinville,,WA,0,0,US

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkLocationAdExtension
var bulkLocationAdExtension = new BulkLocationAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // LocationAdExtension object of the Campaign Management service.
    LocationAdExtension = new LocationAdExtension
    {
        Address = new Address
        {
            // 'City' column header in the Bulk file
            CityName = "Woodinville",
            // 'Country Code' column header in the Bulk file
            CountryCode = "US",
            // 'Postal Code' column header in the Bulk file
            PostalCode = "98608",
            // 'State Or Province Code' column header in the Bulk file
            ProvinceCode = null,
            // 'Province Name' column header in the Bulk file
            ProvinceName = "WA",
            // 'Address Line 1' column header in the Bulk file
            StreetAddress = "1234 Washington Place",
            // 'Address Line 2' column header in the Bulk file
            StreetAddress2 = "Suite 1210",
        },
        // 'Business Name' column header in the Bulk file
        CompanyName = "Contoso Shoes",
        // 'Geo Code Status' column header in the Bulk file
        GeoCodeStatus = null,
        GeoPoint = new GeoPoint
        {
            // 'Latitude' column header in the Bulk file
            LatitudeInMicroDegrees = 0,
            // 'Longitude' column header in the Bulk file
            LongitudeInMicroDegrees = 0,
        },
        // 'Id' column header in the Bulk file
        Id = locationAdExtensionIdKey,
        // 'Phone Number' column header in the Bulk file
        PhoneNumber = "206-555-0100",

        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // 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 = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkLocationAdExtension);

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

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

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

• 広告スケジュール
• 住所 1 行目
• 住所 2 行目
• ビジネス名
• 市区町村
• クライアント ID
• 国コード
• 編集場所
• 編集理由コード
• 編集状態
• 編集用語
• 終了日
• Geo コードの状態
• Id
• Latitude
• Longitude
• 変更時刻
• Parent Id
• 電話番号
• 郵便番号
• 都道府県名
• 発行元の国
• 開始日
• 州コードまたは都道府県コード
• 状態
• Searcher タイム ゾーンを使用する
• バージョン

広告スケジュール

広告拡張機能を広告と共に表示する曜日と時間の範囲の一覧。 各曜日と時間範囲には、スケジュールされた曜日、開始時刻/終了時間、開始/終了分が含まれます。 各日と時刻の範囲は左と右のかっこで囲み、他の日と時刻の範囲からセミコロン (;)区切り記号で区切られます。 日付と時刻の範囲内の形式は 、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に設定します。
削除： 読み 取り 専用

住所 1 行目

アドレスの最初の行。

最初の行には、最大 80 文字を含めることができます。

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

住所 2 行目

アドレスの 2 行目。

2 行目には最大 80 文字を含めることができます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、以前の設定は削除されます。
削除： 読み 取り 専用

ビジネス名

ビジネスの名前。

名前には、最大 80 文字を含めることができます。

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

都市

番地がある市区町村の名前。

名前には、最大 80 文字を含めることができます。

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

クライアント ID

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

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

Country Code

番地がある国または地域。

国コードには、2 文字の国コードが含まれている必要があります。 サポートされている国コードの値には、AR、AT、AU、BR、CA、CH、CL、CO、DE、DK、ES、FI、FR、GB、HK、ID、IE、IN、IT、MX、MY、NL、NZ、NO、PE、PH、SE、SG、TH、TW、US、VE、VN が含まれます。

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

編集場所

編集レビューに失敗した広告拡張機能のコンポーネントまたはプロパティ。

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

編集理由コード

エラーの理由を識別するコード。 考えられる理由コードの一覧については、「 編集理由コード」を参照してください。

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

編集状態

広告拡張機能の編集状態。

使用可能な値については、次の表を参照してください。

値	説明
アクティブ	広告拡張機能が編集レビューに合格しました。
ActiveLimited	広告拡張機能は 1 つ以上の市場で編集レビューに合格し、広告拡張機能の 1 つ以上の要素が別の市場で編集レビューを受けています。 たとえば、広告拡張機能はカナダの編集レビューに合格し、米国でのレビューがまだ保留中です。
不承認	広告拡張機能が編集レビューに失敗しました。
非アクティブ	広告拡張機能の 1 つ以上の要素が編集レビュー中です。

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

編集用語

編集レビューに失敗した用語。

用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。

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

終了日

MM/DD/YYYY として書式設定された広告拡張機能のスケジュールされた終了日文字列。

終了日は包括的です。 たとえば、このフィールドを 2020 年 12 月 31 日に設定した場合、広告表示オプションは 2020 年 12 月 31 日午後 11 時 59 分に表示されなくなります。

追加： オプション。 終了日を指定しない場合、関連するキャンペーン、広告グループ、または広告を一時停止しない限り、広告表示オプションは引き続き配信されます。
更新： オプション。 開始日が null であるか、新しい終了日より前に発生する限り、終了日は短縮または延長できます。 このフィールドを delete_value 文字列に設定すると、実質的に終了日が削除されます。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

Geo コードの状態

ビジネスの緯度と経度の座標が決定されたかどうかを示す状態値。

座標を指定すると、状態は [完了] に設定されます。それ以外の場合、状態は、指定されたビジネスのアドレスの座標の決定の進行状況を示します。

使用可能な値については、次の表を参照してください。

値	説明
完了	ビジネスの緯度と経度を正常に決定しました。
失敗 しました	ビジネスの緯度と経度を特定できません。
Invalid	住所が解決されなかった可能性があるため、ビジネスの緯度と経度を特定できません。
Pending	ビジネスの緯度と経度を決定するプロセス。

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

Id

広告拡張機能のシステム生成識別子。

追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 広告拡張機能の負の識別子セットは、[キャンペーンの場所] 広告拡張機能などの依存レコードの種類の [ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい広告表示オプションと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

Latitude

度で指定された緯度。 緯度は-85 以上で、+85 以下である必要があります。

注:

キャンペーン管理サービスでは、-85000000 から 85000000 までのマイクロ度が使用されます。 BulkLocationAdExtension 実装はマイクロ度から変換され、値が Bulk ファイルの度として書き込まれるので、SDK を介して BulkLocationAdExtension を使用する場合は、マイクロ度を使用する必要があります。

緯度と経度の座標は、ユーザーが広告のアドレスをクリックしたときにBingマップ上のビジネスの場所をマークするために使用されます。 指定した座標が有効な値の範囲内にない場合、サービスはアドレスに基づいて座標を決定します。

既知の座標を指定した場合、指定した座標が指定したビジネス アドレスと一致するかどうかはサービスによって確認されません。 座標を指定しない場合、Bulk サービスは企業の住所を使用して座標を決定します。

注:

10 を超える位置情報広告拡張機能を追加すると、サービスはオフラインで座標を解決し、それ以外の場合はサービス操作の実行中に座標を前もって解決します。 座標が決定されるまで、この場所は広告で使用されません。これは、追加する位置情報広告の拡張機能の数と現在の需要に応じて数秒から数分かかる場合があります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

Longitude

度で指定された経度。 経度は-180 以上で、+180 以下である必要があります。

注:

キャンペーン管理サービスでは、-180000000 から 180000000 までのマイクロ度が使用されます。 BulkLocationAdExtension 実装はマイクロ度から変換され、値が Bulk ファイルの度として書き込まれるので、SDK を介して BulkLocationAdExtension を使用する場合は、マイクロ度を使用する必要があります。

緯度と経度の座標は、ユーザーが広告のアドレスをクリックしたときにBingマップ上のビジネスの場所をマークするために使用されます。 指定した座標が有効な値の範囲内にない場合、サービスはアドレスに基づいて座標を決定します。

既知の座標を指定した場合、指定した座標が指定したビジネス アドレスと一致するかどうかはサービスによって確認されません。 座標を指定しない場合、Bulk サービスは企業の住所を使用して座標を決定します。

注:

10 を超える位置情報広告拡張機能を追加すると、サービスはオフラインで座標を解決し、それ以外の場合はサービス操作の実行中に座標を前もって解決します。 座標が決定されるまで、この場所は広告で使用されません。これは、追加する位置情報広告の拡張機能の数と現在の需要に応じて数秒から数分かかる場合があります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

変更時刻

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

注:

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

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

Parent Id

広告拡張機能を含むアカウントのシステム生成識別子。

この一括フィールドは、取引先企業レコードの Id フィールドにマップされます。

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

電話番号

広告に含めるビジネスのクリック可能な電話番号。

電話番号には最大 35 文字を含めることができます。指定した国または地域で有効である必要があります。

キャンペーンに通話拡張機能も含まれている場合、通話拡張機能の電話番号は、位置情報広告拡張機能の電話番号よりも優先されます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

郵便番号

郵便番号。

郵便番号には、最大 80 文字を含めることができます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、以前の設定は削除されます。
削除： 読み 取り 専用

都道府県名

番地がある州または都道府県の名前 ( ワシントンなど)。

名前には、最大 50 文字を含めることができます。

[都道府県名] または [都道府県コード] を指定する必要があります。

注:

国コード フィールドが FR、IE、または SG のいずれかに設定されている場合、State Or Province Code と Province Name は必要ありません。

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

発行元の国

編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。

一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。

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

開始日

MM/DD/YYYY として書式設定された広告拡張機能のスケジュールされた開始日文字列。

開始日は包括的です。 たとえば、 StartDate を 2020 年 5 月 5 日に設定した場合、広告表示オプションは 2020 年 5 月 5 日午前 12 時に表示されるようになります。

追加： オプション。 開始日を指定しない場合は、広告表示オプションをすぐに スケジュールできます。
更新： オプション。 終了日が null であるか、新しい開始日の後に発生する限り、開始日は短縮または延長できます。 このフィールドを delete_value 文字列に設定すると、実質的に開始日が削除され、広告拡張機能がすぐに スケジュールされる資格があります。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

州コードまたは都道府県コード

番地が配置されている州または都道府県を識別するコード ( WA など)。

コードには、最大 50 文字を含めることができます。

[都道府県名] または [都道府県コード] を指定する必要があります。

注:

国コード フィールドが FR、IE、または SG のいずれかに設定されている場合、State Or Province Code と Province Name は必要ありません。

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

状態

広告拡張機能の状態。

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

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

Searcher タイム ゾーンを使用する

広告を配信できる検索ユーザーのアカウント タイム ゾーンとタイム ゾーンのどちらを使用するかを指定します。

検索ユーザーのタイム ゾーンに広告表示オプションを表示する場合は、このプロパティを TRUE に設定し、それ以外の場合は FALSE に設定 します。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値の FALSE が設定され、アカウントのタイム ゾーンが使用されます。
更新： オプション。 このフィールドを delete_value 文字列に設定すると、実質的に FALSE の既定値にリセットされます。 [広告スケジュール]、[終了日]、[開始日]、[検索者のタイム ゾーンを使用する] フィールドは互いに依存し、まとめて更新されます。 更新中にこれらのフィールドをすべて空のままにした場合、更新されません。 これらのフィールドのいずれかに値を含める場合、これらのすべてのフィールドの以前の値が削除または置換されます。 以前のすべてのスケジュール設定を削除するには、これらの各フィールドを delete_valueに設定します。
削除： 読み 取り 専用

バージョン

広告拡張機能の内容が更新された回数。 拡張機能を追加すると、バージョンは 1 に設定され、変更されるたびにインクリメントされます。

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