広告グループの場所の意図条件レコード - 一括

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

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

各場所の意図条件は、キャンペーンまたは広告グループのすべての場所と半径の基準の意図オプションを定義します。条件の入札単価調整に付随する条件はありません。

キャンペーンまたは広告グループごとに指定できる場所の意図条件の最大数は 1 つです。

注:

広告グループごとに 1 つの広告グループの場所の意図条件レコードのみを使用して、すべての広告グループの [広告グループの場所基準] レコードと [広告グループの半径基準] レコードに適用される場所の意図オプションを決定できます。広告グループの最初の条件を作成すると、既定の [ターゲット] が PeopleInOrSearchingForOrViewingPages に設定された広告グループの場所の意図基準レコードも自動的に追加されます。広告グループに他の基準があるかどうかに関係なく、広告グループの [広告グループの場所の意図条件] を追加または更新できます。広告グループの [広告グループの場所の意図の基準] は削除できませんが、場所や半径の基準がない目的はありません。

PeopleSearchingForOrViewingPages は、2024 年 4 月の時点で非推奨となりました。 IntentOption を PeopleSearchingForOrViewingPages に設定しようとすると、代わりに PeopleInOrSearchingForOrViewingPages に設定されます。この設定で既存のキャンペーンを PeopleInOrSearchingForOrViewingPages に自動的に変換します。

重要

PeopleInOrSearchingForOrViewingPages ではなく、AIM の場所の意図条件を PeopleIn に設定します。

ヒント

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

AdGroupTargetCriterions の DownloadEntity 値を DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に含めることで、アカウント内のすべての広告グループの場所意図条件レコードをダウンロードできます。さらに、ダウンロード要求には 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 Location Intent Criterion,Active,,-1111,,,,ClientIdGoesHere,,PeopleIn,,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupLocationIntentCriterion
var bulkAdGroupLocationIntentCriterion = new BulkAdGroupLocationIntentCriterion
{
    // '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 LocationIntentCriterion
        {
            // 'Target' column header in the Bulk file
            IntentOption = IntentOption.PeopleIn
        },

        CriterionBid = null,

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

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

uploadEntities.Add(bulkAdGroupLocationIntentCriterion);

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

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

広告グループの場所の意図条件レコードの場合、一括ファイルスキーマでは、次の属性フィールドを使用できます。

広告グループ
Campaign
クライアント ID
Id
変更時刻
Parent Id
状態
Target

広告グループ

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

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

キャンペーン

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

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

クライアント ID

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

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

Id

条件の識別子。

注:

現在、場所意図の基準識別子は親識別子と等しくなりますが、そのリレーションシップに依存する必要はありません。ベストプラクティスとして、場所の意図の基準識別子を個別と見なす必要があります。

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

変更時刻

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

注:

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

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

Parent Id

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

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

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

状態

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

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

Target

広告を表示するために、ターゲットの場所に人物を物理的に配置する必要があるかどうかを判断します。

次の値がサポートされています。既定値は PeopleInOrSearchingForOrViewingPages です。

対象となる場所に関するページを表示、検索、または表示するユーザーに広告を表示する場合は、 PeopleInOrSearchingForOrViewingPages を使用します。
対象地域のユーザーに広告を表示する場合は、 PeopleIn を使用します。

追加： オプション
更新： オプション。更新プログラムに値が設定されていない場合、この設定は変更されません。このフィールドを設定する場合は、有効な値 ( PeopleInOrSearchingForOrViewingPages または PeopleIn) に設定する必要があります。
削除： 読み取り専用

次の方法で共有

広告グループの場所の意図条件レコード - 一括

広告グループ

キャンペーン

クライアント ID

Id

変更時刻

Parent Id

状態

Target

フィードバック

その他のリソース