広告グループのデイタイム条件レコード - 一括

[アーティクル]
11/13/2024

一括ファイルでアップロードおよびダウンロードできる広告グループの日時の基準を定義します。

キャンペーンが進行すると、特定の時間帯 (平日の夜など) にクリックスルー率とコンバージョン率が最も高くなる場合があります。これは、入札調整を使用して、月曜日から金曜日の午後 6:00 から午後 11:00 まで広告を表示する可能性を高める絶好の機会となる場合があります。時間でターゲットを設定する場合は、検索者のローカルタイムゾーンをターゲットに設定します。たとえば、午後 6:00 から午後 11:00 まで入札額を 10% 引き上げた場合、その入札調整は午後 6 時から午後 11 時東部標準時にニューヨークの検索者に対して有効になり、シアトルの検索者の場合は午後 6 時から午後 11 時に有効になります。これで、潜在顧客がオンラインになったときに広告が表示されます。

各日と時刻の条件は、時間、分、時間、および関連する条件の入札単価調整の分の要件を定義します。

キャンペーンまたは広告グループごとに指定できる日と時間の基準の最大数は 49 です。重複する曜日と時間の範囲を指定することはできません。たとえば、月曜日の午前 3 時から午前 5 時まで、月曜日の午前 4:00 から午前 6:00 は、同じキャンペーンまたは広告グループに対しては許可されません。また、特定のキャンペーンまたは広告グループの場合、指定できる 1 日あたりの日と時間の基準の最大数は 7 です。たとえば、日が月曜日に設定されている日付と時刻の条件を最大 7 つ指定できます。

広告グループレベルの日と時刻の基準が指定されている場合、その広告グループのキャンペーンレベルの日と時刻の基準は無視されます。つまり、広告グループの日と時刻の基準は、キャンペーンの日と時刻の基準をオーバーライドし、和集合として適用されません。

ヒント

ターゲット条件の使用方法の概要については、「ターゲットオーディエンスに広告を表示する」を参照してください。

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

次の一括 CSV の例では、有効な親 ID 値が指定されている場合に、新しい広告グループの曜日と時刻の条件を追加します。

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group DayTime Criterion,Active,,-1111,,,,ClientIdGoesHere,,Monday,20,,,,,0,0,4,0,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupDayTimeCriterion
var bulkAdGroupDayTimeCriterion = new BulkAdGroupDayTimeCriterion
{
    // 'Ad Group' column header in the Bulk file is read-only
    AdGroupName = null,
                    
    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.

    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
                        
        Criterion = new DayTimeCriterion
        {
            // 'Target' column header in the Bulk file
            Day = Day.Monday,

            // 'From Hour' column header in the Bulk file
            FromHour = 0,

            // 'To Hour' column header in the Bulk file
            ToHour = 4,

            // 'From Minute' column header in the Bulk file
            FromMinute = Minute.Zero,

            // 'To Minute' column header in the Bulk file
            ToMinute = Minute.Zero
        },

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 20,
        },

        // 'Id' column header in the Bulk file
        Id = null,

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

uploadEntities.Add(bulkAdGroupDayTimeCriterion);

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

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

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

広告グループ
入札単価調整
キャンペーン
クライアント ID
From Hour
分から
Id
変更時刻
Parent Id
状態
Target
To Hour
分単位

広告グループ

この条件が適用または削除される広告グループの名前。

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

入札単価調整

対応する ターゲット、 From Hour、FromMinute、 To Hour、To Minute の入札額を調整する割合。

サポートされる値は、負の 90 (-90) から正の 900 (900) です。

追加： オプション。含まれていない場合、入札単価調整は既定値の 0 に設定されます。
更新： 必須
削除： 読み取り専用

キャンペーン

この条件が適用または削除される広告グループを含むキャンペーンの名前。

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

クライアント ID

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

追加： オプション
更新： オプション
削除： オプション

From Hour

目標とする開始時間。

サポートされる値の範囲は 0 ~ 23 です。

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

分から

ターゲットまでの開始分。

サポートされる値は 0、15、30、および 45 です。

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

Id

条件の Microsoft Advertising 一意識別子。

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

変更時刻

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

注:

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

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

Parent Id

この条件が適用または削除される広告グループの識別子。

この一括フィールドは、広告グループレコードの Id フィールドにマップされます。

追加： 読み取り専用と必須。既存の広告グループ識別子を指定するか、親広告グループレコードの Id フィールドと等しい負の識別子を指定する必要があります。これは、同じ Bulk ファイル内の新しい広告グループに新しい条件を追加する場合に推奨されます。詳細については、「一括ファイルスキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

状態

広告グループと条件の間の関連付けの状態を表します。条件が広告グループに適用されている場合、このフィールドの値は [アクティブ] になります。条件を削除するには、状態を [削除済み] に設定します。

追加： 読み取り専用。条件を追加すると、状態は常に [アクティブ] に設定されます。たとえば、別の値をアップロードした場合、 Foo 結果ファイルには同じ値が含まれますが、条件はアクティブです。
更新： オプション
削除： 必須。 [状態] を [削除済み] に設定する必要があります。特定の曜日と時刻の条件の入札を削除するには、ステータス、 ID、親 ID をアップロードする必要があります。

Target

対応する 入札単価調整を対象とする日。

サポートされる値は、 日曜日、 月曜日、 火曜日、 水曜日、 木曜日、 金曜日、 および土曜日です。

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

To Hour

目標とする終了時刻。

サポートされる値の範囲は 0 から 24 です。 To Hour が 24 に設定されている場合、To Minute は 0 である必要があります。

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

分単位

目標とする終了分。

サポートされる値は 0、15、30、および 45 です。

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

次の方法で共有

広告グループのデイタイム条件レコード - 一括

広告グループ

入札単価調整

キャンペーン

クライアント ID

From Hour

分から

Id

変更時刻

Parent Id

状態

Target

To Hour

分単位

フィードバック

その他のリソース