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 時(91516)を指定すると、月曜日、水曜日、金曜日の午前 9 時~午前 10 時と午後 3 時~午後 5 時に広告が配信されます。設定可能な値は 023 です。
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
既存のターゲティング テンプレートを更新します。