CampaignCriterionService、AdGroupCriterionService、CustomerNegativeCriterionService は、さまざまな種類の条件のターゲティングまたは除外をサポートしています。
キャンペーン クライテリア
CampaignCriterionService を使用すると、以下のタイプのターゲティングをキャンペーン単位で指定できます。調整比を使用してこのレベルで入札単価調整比を指定することもできますが、絶対的な入札単価を設定することはできません。
- AdScheduleInfo
デフォルトでは、新しいキャンペーンに広告スケジュールはありません。つまり、広告はすべての期間に掲載されます。広告をいつ掲載するかをより正確に決定するために、15 分単位で広告スケジュールを設定することができます。
広告スケジュールはターゲティングのみ可能です。除外はサポートされていません。
- AgeRangeInfo
デフォルトでは、新しいキャンペーンには年齢層の条件はありません。つまり、すべての年齢層が含まれます。
- BrandInfo
デフォルトでは、新しいキャンペーンにはブランド条件はありません。つまり、ブランドが明示的にターゲット設定または除外されることはありません。
- CarrierInfo
デフォルトでは、新しいキャンペーンにはコンテンツ キャリア条件はありません。つまり、すべてのキャリアが含まれます。キャンペーン単位でサポートされるのは、非除外条件のみです。
- CombinedAudienceInfo
組み合わせオーディエンスでは、オーディエンスの条件をいくつでも組み合わせることができます。デフォルトでは、新しいキャンペーンには組み合わせオーディエンスは含まれません。詳しくは、統合オーディエンスに関するヘルプセンター記事をご覧ください。
- ContentLabelInfo
デフォルトでは、新しいキャンペーンにはコンテンツ ラベルの条件はありません。つまり、すべてのカテゴリが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- CustomAffinityInfo
デフォルトでは、新しいキャンペーンにはカスタム アフィニティ条件は含まれません。カスタム アフィニティ条件は、ユーザーが作成する CustomInterest リソースによって定義されます。非除外条件のみがサポートされています。この記事では、カスタム アフィニティ条件の仕組みと使用方法について説明します。
- DeviceInfo
定義済みの Device 列挙型のいずれかを使用して、
DeviceInfo
条件を定義します。デバイス ターゲティングの主なユースケースは、CampaignCriterion のbid_modifier
値を使って特定のデバイスの入札単価を調整することです。ターゲティングできるのはデバイスのみです。除外はサポートされていません。
- GenderInfo
デフォルトでは、新しいキャンペーンには性別の条件はありません。つまり、すべての性別が含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- IncomeRangeInfo
デフォルトでは、新しいキャンペーンには所得別グループの条件はありません。つまり、すべての所得別グループが含まれます。キャンペーン単位でサポートされるのは、除外条件のみです。
- IpBlockInfo
デフォルトでは、新しいキャンペーンに 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
- YouTube チャンネルをチャンネル ID またはチャンネル コードで除外します。
- YouTubeVideoInfo
- YouTube 動画再生ページに表示される動画 ID で、特定の YouTube 動画を除外します。