LocationCriterion データ オブジェクト - キャンペーン管理

特定の場所のユーザーに広告を表示するために使用できる条件を定義します。

場所の基準を使用すると、次のページに関する潜在顧客に広告を表示したり、検索したり、表示したりすることができます。

• 利用可能なすべての国/地域
• 選択した都市、郵便番号、メトロエリア microsoft Market Area in the 米国)、郡、州/都道府県、国/地域

各場所条件は、関連する条件の入札単価調整の場所コードを定義します。

キャンペーンまたは広告グループごとに指定できる場所と否定的な場所の条件を組み合わせた最大数は 10,000 です。

注:

キャンペーンまたは広告グループのすべての地理的基準 (場所、否定的な場所、半径の基準) に適用される場所の意図オプションを決定するには、キャンペーンまたは広告グループごとに 1 つの LocationIntentCriterion のみを使用できます。 キャンペーンまたは広告グループの最初の条件を作成すると、 LocationIntentCriterion も自動的に追加され、既定の IntentOption は PeopleInOrSearchingForOrViewingPages に設定されます。 キャンペーンまたは広告グループに他の基準があるかどうかに関係なく、キャンペーンまたは広告グループの LocationIntentCriterion を追加または更新できます。 LocationIntentCriterion は削除できませんが、場所または半径の基準を持たない目的はありません。

LocationCriterion は、BiddableAdGroupCriterion、NegativeAdGroupCriterion、BiddableCampaignCriterion、NegativeCampaignCriterion オブジェクトに含めることができます。 広告グループ レベルの場所の基準が指定されている場合 (正または負)、その広告グループのキャンペーン レベルの場所の基準は無視されます。 つまり、広告グループの場所の基準はキャンペーンの場所の基準をオーバーライドし、和集合として適用されません。

また、場所、負の位置、半径の基準を一連の 地理的基準として考慮する必要があることにも注意してください。 広告グループに地域基準がある場合、キャンペーンの地理的条件は継承されません。 広告グループに地域基準がない場合は、キャンペーンのすべての地理的条件が継承されます。 地域基準は、広告グループに位置情報の意図条件がある場合でも、キャンペーンから継承できます。 広告グループの地理的条件が使用されている場合は、広告グループの位置情報の意図条件が使用されます。キャンペーンの地理的条件が継承されている場合、キャンペーンの位置情報の意図条件が使用され、広告グループの位置情報の意図条件は無視されます。 キャンペーンや広告グループの場所の意図条件は削除できませんが、場所や半径の基準を持たない目的はありません。

構文

<xs:complexType name="LocationCriterion" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Criterion">
      <xs:sequence>
        <xs:element minOccurs="0" name="DisplayName" nillable="true" type="xs:string" />
        <xs:element xmlns:q80="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="EnclosedLocationIds" nillable="true" type="q80:ArrayOflong" />
        <xs:element minOccurs="0" name="LocationId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="LocationType" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

LocationCriterion オブジェクトには、DisplayName、EnclosedLocationIds、LocationId、LocationType の各要素があります。

要素	説明	データ型
DisplayName	場所の表示名。 追加： 読み 取り 専用 更新： 読み 取り 専用	string
EnclosedLocationIds	内部使用のため予約済みです。 追加： 読み 取り 専用 更新： 読み 取り 専用	long 配列
LocationId	広告を表示する場所の一意の Microsoft Advertising 識別子。 使用可能な値については、地理的な場所ファイルの [場所 ID] フィールドを参照してください。 GetGeoLocationsFileUrl 操作を呼び出して、ファイルをダウンロードできます。 大事な：場所の条件を追加または更新する前に、地理的な場所ファイルの [状態] フィールドをチェックしてください。 状態が PendingDeprecation の場合、場所の条件はターゲットまたは除外に使用されなくなりました。 非推奨の場所条件は引き続き取得できますが、非推奨の場所条件を追加または更新することはできません。 追加： 必須 更新： 許可されていません。 この要素を指定する場合は、既存の設定と一致する必要があります。	long
LocationType	場所の種類。 指定できる値には、 市区町村、 国、 メトロエリア、 近隣、 郵便番号、 および都道府県が含まれますが、これらに限定されません。 新しい場所のサブタイプはいつでも追加できます。 特定の場所 ID の場所の種類が変更されることはほとんどありません。 追加： 読み 取り 専用 更新： 読み 取り 専用	string

LocationCriterion オブジェクトには継承された要素があります。

継承された要素

条件から継承された要素

LocationCriterion オブジェクトは、Criterion オブジェクトから派生し、Type 要素を継承します。 以下の説明は LocationCriterion に固有であり、 Criterion オブジェクトから同じ要素を継承する他のオブジェクトには適用されない場合があります。

要素	説明	データ型
型	条件の型。 この値は、 場所 の条件を取得するときの [場所] です。 基準の種類の詳細については、「 基準データ オブジェクトの備考」を参照してください。 追加： 読み 取り 専用 更新： 読み 取り 専用	string

要件

サービス: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13