CampaignCriterionService、AdGroupCriterionService、CustomerNegativeCriterionService は、さまざまなタイプの条件のターゲット設定または除外に対応しています。
キャンペーン クライテリア
CampaignCriterionService を使用すると、以下のタイプのターゲティングをキャンペーン単位で指定できます。調整比を使用してこのレベルで入札単価調整比を指定することもできますが、絶対単価を設定することはできません。
- AdScheduleInfo
デフォルトでは、新しいキャンペーンに広告スケジュールはありません。つまり、広告はすべての期間に掲載されます。広告をいつ掲載するかをより正確に決定するために、15 分単位で広告スケジュールを設定することができます。
広告スケジュールはターゲティングのみ可能です。除外はサポートされていません。
- AgeRangeInfo
デフォルトでは、新しいキャンペーンには年齢層の条件はありません。つまり、すべての年齢層が含まれます。
- BrandInfo
デフォルトでは、新しいキャンペーンにはブランド条件はありません。つまり、ブランドを明示的にターゲット設定したり除外したりすることはありません。
- CarrierInfo
デフォルトでは、新しいキャンペーンにはコンテンツ キャリア条件はありません。つまり、すべてのキャリアが含まれます。キャンペーン単位でサポートされるのは、非除外条件のみです。
- CombinedAudienceInfo
組み合わせオーディエンスでは、任意の数のオーディエンス条件を組み合わせることができます。デフォルトでは、新しいキャンペーンに組み合わせオーディエンスは含まれません。詳しくは、統合オーディエンスに関するヘルプセンターの記事をご覧ください。
- ContentLabelInfo
デフォルトでは、新しいキャンペーンにはコンテンツ ラベルの条件はありません。つまり、すべてのカテゴリが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- CustomAffinityInfo
デフォルトでは、新しいキャンペーンにカスタム アフィニティ条件はありません。カスタム アフィニティ条件は、ユーザーが作成する必要がある CustomInterest リソースで定義されます。非除外条件のみがサポートされています。この記事では、カスタム アフィニティ条件の仕組みと使用方法について説明します。
- DeviceInfo
定義済みの Device 列挙型のいずれかを使用して、
DeviceInfo
条件を定義します。デバイス ターゲティングの主な用途は、CampaignCriterion のbid_modifier
の値を使って特定のデバイスの入札単価を調整することです。ターゲティングできるのはデバイスのみです。除外はサポートされていません。
- GenderInfo
デフォルトでは、新しいキャンペーンには性別の条件はありません。つまり、すべての性別が含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- IncomeRangeInfo
デフォルトでは、新しいキャンペーンには所得別グループの条件はありません。つまり、すべての所得別グループが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- IpBlockInfo
デフォルトでは、新しいキャンペーンに IP ブロック条件は設定されません。つまり、すべての IP ブロック条件が適用されます。
- KeywordInfo
キーワードは、自由形式のテキストとマッチタイプ列挙値のいずれかを使用して作成されます。
キーワードはキャンペーン単位でのみ除外できるため、キーワードの CampaignCriterion で
negative = true
を指定する必要があります。- LanguageInfo
デフォルトでは、新しいキャンペーンには言語の条件は設定されません。つまり、すべての言語が含まれます。非除外条件のみがサポートされます。
- LifeEventInfo
デフォルトでは、新しいキャンペーンにはライフイベント条件はありません。つまり、ライフイベントを明示的にターゲットに設定したり除外したりすることはありません。個々のライフイベントは、
LifeEvent
リソースのid
フィールドの値に従って識別する必要があります。使用可能なLifeEvent
のリストは、GoogleAdsService.SearchStream
を使用して取得できます。- ListingScopeInfo
デフォルトでは、新しいキャンペーンには掲載範囲の条件は含まれません。非除外条件のみがサポートされます。
- LocationInfo
名前付き地域ターゲティングは
LocationInfo
として実装され、一定の条件 ID のセットを使用して作成されます。利用可能な ID はドキュメントに記載されており、GeoTargetConstantService
を使用して個別に検索できます。これらの条件は、非除外か除外として設定することができ、除外ターゲットは非除外ターゲットをオーバーライドします。デフォルトでは、新しいキャンペーンには地域条件がありません。つまり、すべての地域がターゲットに設定されています。- LocationGroupInfo
LocationGroup
を使用すると、キャンペーンで複数の地域をターゲットに設定できます。これらの地域は、一連の場所と、各場所の周囲の距離半径(メートルかマイル)で定義されます。これらの地域のターゲット設定は、地域ターゲティング条件 ID のリストを使って絞り込むことができます。- MobileAppCategoryInfo
デフォルトでは、新しいキャンペーンにはモバイルアプリ カテゴリの条件は含まれません。つまり、すべてのカテゴリが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- MobileApplicationInfo
デフォルトでは、新しい広告グループにモバイルアプリの条件は設定されません。個々のモバイルアプリは、
app_id
フィールドの値によって識別する必要があります。- MobileDeviceInfo
デフォルトでは、新しいキャンペーンにはモバイル デバイスの条件はありません。つまり、すべてのデバイスが含まれます。
個々のモバイル デバイスを指定するには、MobileDeviceConstant のリソース名を使用して、キャンペーンの条件で
device
フィールドを設定する必要があります。モバイル デバイスのみをターゲットに設定できます。除外はサポートされていません。
- OperatingSystemVersionInfo
デフォルトでは、新しいキャンペーンにはオペレーティング システムのバージョンの条件が含まれていません。つまり、すべてのオペレーティング システムがターゲットに設定されています。キャンペーン単位でサポートされるのは、非除外条件のみです。
- ParentalStatusInfo
デフォルトでは、新しいキャンペーンには子供の有無の条件はありません。つまり、すべての子供の有無のカテゴリが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- PlacementInfo
顧客の URL を使用して作成されます。使用される URL の長さ(250 文字)と深さ(2 レベル)には上限があります。除外としてのみ設定可能です。デフォルトでは、新しいキャンペーンにはプレースメントの条件は含まれません。URL が
adsenseformobileapps.com
と完全に一致する除外プレースメントは使用できません。- ProximityInfo
半径を指定したターゲットは、ProximityInfo 条件として実装されます。住所または緯度と経度を使用して、半径を指定して作成できます。非除外としてのみ設定でき、デフォルトでは、新しいキャンペーンに近接条件は含まれません。
詳しくは、半径を指定したターゲット設定をご覧ください。
- TopicInfo
デフォルトでは、新しいキャンペーンにトピックの条件は含まれません。キャンペーン単位でサポートされるのは、除外条件のみです。
- UserInterestInfo
デフォルトでは、新しいキャンペーンにユーザーの興味 / 関心の条件は設定されません。キャンペーン単位でサポートされるのは、除外条件のみです。
UserInterest
を取得してUserInterestInfo
に設定する場合は、availabilities[]
がキャンペーン タイプに対応していることを確認してください。一部のUserInterest
オプションは、特定のキャンペーン タイプでのみ使用できます。- UserListInfo
デフォルトでは、新しいキャンペーンにはユーザーリストの条件は含まれません。ユーザーリストの ID を使用して、条件のユーザーリストを識別します。除外条件と非除外条件が、キャンペーン単位でサポートされています。
- WebpageInfo
デフォルトでは、新しいキャンペーンにはウェブページの条件は含まれません。つまり、すべてのウェブページが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- YouTubeChannelInfo
デフォルトでは、新しいキャンペーンに YouTube チャンネルの条件は含まれません。キャンペーン単位でサポートされるのは、除外条件のみです。
- YouTubeVideoInfo
デフォルトでは、新しいキャンペーンに YouTube 動画の条件は設定されません。キャンペーン単位でサポートされるのは、除外条件のみです。
広告グループの条件
AdGroupCriterionService を使用すると、広告グループ単位で次のタイプのターゲティングを指定できます。
- AgeRangeInfo
- デフォルトでは、新しい広告グループには年齢層の条件はありません。つまり、すべての年齢層が含まれます。広告グループ単位で、年齢層に対して入札または除外できます。
- AppPaymentModelInfo
- 広告グループレベルでは、アプリの支払いモデルの条件のみをターゲットに設定できます。
- CombinedAudienceInfo
- 組み合わせオーディエンスでは、オーディエンスの条件をいくつでも組み合わせることができます。デフォルトでは、新しい広告グループには統合オーディエンスは含まれません。詳しくは、統合オーディエンスに関するヘルプセンターの記事をご覧ください。
- CustomAffinityInfo
- デフォルトでは、新しい広告グループにはカスタム アフィニティ条件は設定されません。カスタム アフィニティ条件は、ユーザーが作成する必要がある CustomInterest リソースで定義されます。非除外条件のみがサポートされています。カスタム アフィニティ条件の仕組みと使用方法について詳しくは、こちらの記事をご覧ください。
- CustomIntentInfo
- デフォルトでは、新しい広告グループにカスタム インテント条件は含まれません。カスタム インテント条件は、ユーザーが作成する必要がある CustomInterest リソースによって定義されます。非除外条件のみがサポートされています。この記事では、カスタム インテント条件の仕組みと使用方法について説明します。
- GenderInfo
- デフォルトでは、新しい広告グループに性別の条件は設定されず、すべての性別が含まれます。広告グループ単位で、性別に基づいて入札または除外できます。
- IncomeRangeInfo
- デフォルトでは、新しい広告グループには収入の範囲の条件は設定されません。つまり、すべての収入が含まれます。広告グループ単位では、収入の範囲に対して入札または除外できます。
- KeywordInfo
- 広告グループレベルで、キーワードをターゲットに設定するか除外できます。
- LifeEventInfo
- デフォルトでは、新しい広告グループにはライフイベントの条件は設定されません。つまり、ライフイベントを明示的にターゲットに設定したり除外したりすることはありません。個々のライフイベントは、
LifeEvent
リソースのid
フィールドの値に従って識別する必要があります。使用可能なLifeEvent
のリストは、GoogleAdsService.SearchStream
を使用して取得できます。 - ListingGroupInfo
- リスティング グループは、ホテル広告とショッピング キャンペーンの条件のツリーベース構造を定義します。
- MobileAppCategoryInfo
- 広告グループ単位で、モバイルアプリ カテゴリ条件をターゲットに設定したり、ターゲットから除外したりできます。
- MobileApplicationInfo
- デフォルトでは、新しい広告グループにモバイルアプリの条件は設定されません。個々のモバイルアプリは、
app_id
フィールドの値によって識別する必要があります。 - ParentalStatusInfo
- デフォルトでは、新しい広告グループには子供の有無の条件はありません。つまり、子供の有無に関するすべてのカテゴリが含まれます。子供の有無のカテゴリは、広告グループ単位で入札したり、除外したりできます。
- PlacementInfo
- 顧客の URL を使用して作成されます。使用される URL の長さ(250 文字)と深さ(2 レベル)には上限があります。除外としてのみ設定可能です。デフォルトでは、新しい広告グループにはプレースメントの条件は含まれません。URL が
adsenseformobileapps.com
と完全に一致する除外プレースメントは使用できません。 - TopicInfo
- デフォルトでは、新しい広告グループにトピックの条件は設定されません。広告グループ単位で、収入の範囲に対して入札または除外できます。
- UserInterestInfo
デフォルトでは、新しい広告グループにユーザーの興味 / 関心の条件は設定されません。広告グループ単位では、ユーザーの興味や関心に基づいて入札または除外できます。
UserInterest
を取得してUserInterestInfo
に設定する場合は、availabilities[]
がキャンペーン タイプに対応していることを確認してください。一部のUserInterest
オプションは、特定のキャンペーン タイプでのみ使用できます。- UserListInfo
デフォルトでは、新しい広告グループにユーザーリストの条件は追加されません。ユーザーリストの ID を使用して、条件のユーザーリストを識別します。広告グループ単位で、ユーザーリストによる入札か除外が可能です。
- WebpageInfo
広告グループ単位で、ウェブページの条件をターゲットに設定したり、除外したりできます。
- YouTubeChannelInfo
広告グループ単位で、YouTube チャンネルの条件によるターゲティングか除外が可能です。
- YouTubeVideoInfo
広告グループ単位で、YouTube 動画の条件によるターゲティングか除外が可能です。
お客様の条件
CustomerNegativeCriterionService を使用すると、以下のタイプのターゲット除外をアカウント単位で指定できます。
- LifeEventInfo
- ライフイベントを
id
で除外します。使用可能なLifeEvent
のリストを取得するには、GoogleAdsService.SearchStream
を使用します。 - MobileAppCategoryInfo
- MobileAppCategoryConstant リストでモバイルアプリ カテゴリを除外します。
- MobileApplicationInfo
app_id
フィールドの値に基づいて、個々のモバイルアプリを除外します。- NegativeKeywordList
SharedSet
個のキーワードを除外します。除外キーワード リストの条件は、アカウントごとに 1 つだけ適用できます。- PlacementInfo
- 顧客の URL を使用して作成されます。使用される URL の長さ(250 文字)と深さ(2 レベル)には上限があります。URL が
adsenseformobileapps.com
と完全に一致する除外プレースメントは使用できません。 - YouTubeChannelInfo
- チャンネル ID またはチャンネル コードで YouTube チャンネルを除外する。
- YouTubeVideoInfo
- YouTube 動画再生ページに表示される動画 ID で、特定の YouTube 動画を除外します。