TargetingTemplates

このリソースのメソッドの一覧は、このページの最後に掲載されています。

リソース表現

ターゲティングテンプレートのプロパティが含まれています。ターゲティングテンプレートは、複数の広告で再利用できるターゲティング情報をカプセル化します。

{
  "kind": "dfareporting#targetingTemplate",
  "id": long,
  "accountId": long,
  "subaccountId": long,
  "advertiserId": long,
  "advertiserIdDimensionValue": dimensionValues Resource,
  "name": string,
  "geoTargeting": {
    "excludeCountries": boolean,
    "countries": [
      countries Resource
    ],
    "regions": [
      regions Resource
    ],
    "cities": [
      cities Resource
    ],
    "metros": [
      metros Resource
    ],
    "postalCodes": [
      postalCodes Resource
    ]
  },
  "technologyTargeting": {
    "operatingSystems": [
      operatingSystems Resource
    ],
    "browsers": [
      browsers Resource
    ],
    "platformTypes": [
      platformTypes Resource
    ],
    "mobileCarriers": [
      mobileCarriers Resource
    ],
    "connectionTypes": [
      connectionTypes Resource
    ],
    "operatingSystemVersions": [
      operatingSystemVersions Resource
    ]
  },
  "dayPartTargeting": {
    "userLocalTime": boolean,
    "daysOfWeek": [
      string
    ],
    "hoursOfDay": [
      integer
    ]
  },
  "keyValueTargetingExpression": {
    "expression": string
  },
  "languageTargeting": {
    "languages": [
      languages Resource
    ]
  },
  "listTargetingExpression": {
    "expression": string
  }
}

プロパティ名	値	説明
`accountId`	`long`	このターゲティングテンプレートのアカウント ID。設定しなかった場合、このフィールドは挿入時に自動生成され、挿入後は読み取り専用になります。
`advertiserId`	`long`	このターゲティングテンプレートの広告主 ID。挿入時の必須フィールドです。挿入後は読み取り専用になります。
`advertiserIdDimensionValue`	`nested object`	広告主の ID のディメンション値。読み取り専用の自動生成フィールドです。
`dayPartTargeting`	`nested object`	時間と曜日ターゲティング条件。
`dayPartTargeting.daysOfWeek[]`	`list`	広告が配信される曜日。設定可能な値は次のとおりです。 "`SUNDAY`" "`MONDAY`" "`TUESDAY`" "`WEDNESDAY`" "`THURSDAY`" "`FRIDAY`" "`SATURDAY`"
`dayPartTargeting.hoursOfDay[]`	`list`	広告が配信される時間帯。`0` は午前 0 時から午前 1 時まで、`23` は午後 11 時から午前 0 時までです。曜日とともに指定して、特定の曜日の時間帯に広告を配信するよう設定できます。たとえば、曜日に月曜日、水曜日、金曜日を指定し、時間帯に午前 9 時～午前 10 時と午後 3 時～午後 5 時（`9`、`15`、`16`）を指定すると、月曜日、水曜日、金曜日の午前 9 時～午前 10 時と午後 3 時～午後 5 時に広告が配信されます。設定可能な値は `0`～`23` です。
`dayPartTargeting.userLocalTime`	`boolean`	ユーザーの現地時間を使用するかどうか。false の場合、「アメリカ / ニューヨーク」タイムゾーンが適用されます。
`geoTargeting`	`nested object`	地域ターゲティング条件。
`geoTargeting.cities[]`	`list`	ターゲットに設定する市区町村。市区町村ごとに `dartId` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。都市をターゲットとする場合は、その都市の国をターゲットとしたり、除外したりしないでください。また、その都市の大都市圏または地域をターゲットとしないでください。
`geoTargeting.countries[]`	`list`	ターゲットとする国、または除外する国です（ `excludeCountries` フィールドの設定によります）。国ごとに `dartId` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。国をターゲットとする場合、または除外する場合は、同じ国の地域、都市、大都市圏、郵便番号をターゲットとしないでください。
`geoTargeting.excludeCountries`	`boolean`	`countries` フィールドの国をターゲットから除外するかどうか。false の場合、`countries` フィールドは広告がターゲットとする国を示します。
`geoTargeting.metros[]`	`list`	ターゲットに設定する大都市圏。大都市圏ごとに `dmaId` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。大都市圏をターゲットとする場合は、その大都市圏の国をターゲットとしたり、除外したりしないでください。
`geoTargeting.postalCodes[]`	`list`	ターゲットとする郵便番号です。郵便番号ごとに `id` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。郵便番号をターゲットとする場合は、その郵便番号の国をターゲットとしたり、除外したりしないでください。
`geoTargeting.regions[]`	`list`	ターゲットに設定する地域。地域ごとに `dartId` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。地域をターゲットに設定する場合は、その地域の国をターゲットに設定またはターゲットから除外しないでください。
`id`	`long`	このターゲティングテンプレートの ID。読み取り専用の自動生成フィールドです。
`keyValueTargetingExpression`	`nested object`	Key-Value ターゲティング条件。
`keyValueTargetingExpression.expression`	`string`	この広告がターゲットとするキーワード式。
`kind`	`string`	リソースの種類を示します。値は固定文字列 `"dfareporting#targetingTemplate"` です。
`languageTargeting`	`nested object`	言語ターゲティング条件。
`languageTargeting.languages[]`	`list`	この広告がターゲットとする言語。言語ごとに `languageId` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。
`listTargetingExpression`	`nested object`	リマーケティングリストターゲティング条件。
`listTargetingExpression.expression`	`string`	この広告がターゲットとするリストを表す式。
`name`	`string`	このターゲティングテンプレートの名前。必須フィールドです。半角 256 文字未満で指定し、広告主内で一意にする必要があります。
`subaccountId`	`long`	このターゲティングテンプレートのサブアカウント ID。設定しなかった場合、このフィールドは挿入時に自動生成され、挿入後は読み取り専用になります。
`technologyTargeting`	`nested object`	技術プラットフォームターゲティング条件。
`technologyTargeting.browsers[]`	`list`	この広告がターゲットとするブラウザ。ブラウザごとに、バージョン番号とともに `browserVersionId` または `dartId` を設定します。両方を指定すると、`browserVersionId` のみが使用されます。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。
`technologyTargeting.connectionTypes[]`	`list`	この広告がターゲットとする接続タイプ。接続タイプごとに `id` のみが必須です。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。
`technologyTargeting.mobileCarriers[]`	`list`	この広告がターゲットとする携帯通信会社。携帯通信会社ごとに `id` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。携帯通信会社をターゲットとする場合は、郵便番号をターゲットとしないでください。
`technologyTargeting.operatingSystemVersions[]`	`list`	この広告がターゲットとするオペレーティングシステムバージョン。すべてのバージョンをターゲットとするには、`operatingSystems` を使用します。オペレーティングシステムバージョンごとに `id` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。オペレーティングシステムバージョンをターゲットに設定する場合は、`operatingSystems` で対応するオペレーティングシステムをターゲットに設定しないでください。
`technologyTargeting.operatingSystems[]`	`list`	この広告がターゲットとするオペレーティングシステム。特定のバージョンをターゲットに設定するには、`operatingSystemVersions` を使用します。オペレーティングシステムごとに `dartId` のみが必須です。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。オペレーティングシステムをターゲットとする場合は、同じオペレーティングシステムのバージョンをターゲットとしないでください。
`technologyTargeting.platformTypes[]`	`list`	この広告がターゲットとするプラットフォームタイプ。たとえば、パソコン、モバイル、タブレットです。プラットフォームタイプごとに `id` のみを指定する必要があります。その他のフィールドは、広告の挿入時または更新時に自動的に設定されます。

メソッド

get: ID により、ターゲティングテンプレートを 1 つ取得します。
insert: 新しいターゲティングテンプレートを挿入します。
list: ターゲティングテンプレートの一覧を取得します。オプションで結果をフィルタできます。このメソッドはページングをサポートします。
patch: 既存のターゲティングテンプレートを更新します。このメソッドはパッチのセマンティクスをサポートしています。
update: 既存のターゲティングテンプレートを更新します。