プロファイル サービスの機能強化
プロファイルは、性別、年齢、地域、頻度などの一連のターゲット パラメーターである プロファイル サービスを使用して、スマート広告申込情報レベルでターゲットを定義できます。 Smart Line Item (および Smart insertion order) 機能を機能させるには、 Smart Line Item Service によって生成された行項目に特定のパラメーター ベースのプロファイルが追加されます。 明細レベルで、プロファイル ID を含むスマート明細を対象とするプロファイルを使用する必要があるのは、 enhanced_performance 明細のみです。
注:
- Smart 広告申込情報のプロファイルは、ターゲット パラメーターのサブセットに対応できます。これは、以下の JSON フィールド に一覧表示されます。 JSON フィールドに含まれていないターゲット パラメーターが参照されている場合、エラーが発生します。
現在の プロファイル サービス は、エンドポイントとメソッドの点では変更されません。 同じを使用して、プロファイルの表示、編集、作成を行うことができます。
プロファイル サービスの JSON
| フィールド | 型 (長さ) | 説明 |
|---|---|---|
age_targets |
文字列の配列 | このプロファイルの対象となる年齢範囲の一覧。 [ allow_unknown ] フィールドは、ユーザーの年齢が利用できない広告通話を考慮するためにブール値として使用できます。 詳細と例については、「 年齢ターゲット 」セクションを参照してください。 許可されるのは、次の範囲のみです。- ['low' => 18, 'high' => 24],- ['low' => 25, 'high' => 34],- ['low' => 35, 'high' => 49],- ['low' => 50, 'high' => 64],- ['low' => 65, 'high' => 100] |
city_action |
列挙 |
city_targets一覧で実行するアクション。
使用可能な値:- include - excludeデフォルト： exclude |
city_target |
オブジェクトの配列 | [ city_action ] フィールドで定義されているように、プロファイルに含めるか除外する都市の ID。
City Service を使用して、市区町村 ID の一覧を取得できます。 詳細と形式については、以下の 「都市ターゲット 」を参照してください。必須: POST/PUT( city_action がインクルードされている場合)。 |
country_action |
列挙 |
country_targets一覧で実行するアクション。
使用可能な値:- include - excludeデフォルト： exclude |
country_targets |
オブジェクトの配列 | [ country_action ] フィールドで定義されている、除外またはプロファイルに含める国 ID。
Country Service を使用して、国 ID の一覧を取得できます。 詳細と形式については、「 国のターゲット」を参照してください。必須: POST/PUT( country_action がインクルードされている場合)。 |
daypart_targets |
オブジェクトの配列 | キャンペーンを提供する日の部分。 詳細については、「 Daypart Targets」を参照してください。 手記： デイパートのターゲットを設定しない場合、キャンペーンはすべての曜日に常に配信されます。 |
device_type_targets |
文字列の配列 | [ device_type_action ] フィールドで定義されているように、ターゲット設定に含めるか、ターゲットから除外するデバイスの種類。使用可能な値: - phone - tablet - pc 詳細と形式については、「デバイスの種類のターゲット」を参照してください。 |
device_type_action |
列挙 |
device_type_targetsに対して実行するアクション。
device_type は、 device_type_action = includeを使用してのみ定義でき、上記のデバイスの種類のみを対象にすることができます。使用可能な値: include 又は exclude デフォルト： exclude |
gender_targets |
object | プロファイルに使用される性別ターゲティング。 性別に使用できる値は次のとおりです。 - m(male) - f(female).[ allow_unknown ] フィールドは、ユーザーの性別が利用できない広告通話を考慮するためにブール値として使用できます。 詳細については、「 性別ターゲット」を参照してください。 |
postal_code_targets |
object | ターゲットにする郵便番号 ID。 ID は、 郵便番号サービスを使用してフェッチできます。 |
postal_code_action_include |
オブジェクトの配列 | 郵便番号一覧 API を使用すると、購入者は郵便番号のリストを作成し、ターゲット設定のためにさまざまなオブジェクト間で再利用できます。 詳細については、「郵便番号一覧サービス」を参照してください。 |
region_action |
列挙 |
region_targets一覧で実行するアクション。使用可能な値: - include - exclude デフォルト： exclude |
region_targets |
オブジェクトの配列 |
region_action フィールドで定義されているように、プロファイルに含めるか除外されるリージョン/状態 ID。
リージョン サービスを使用して、リージョン ID の一覧を取得できます。 詳細と形式については、「 リージョン ターゲット」を参照してください。必須: POST/PUT( region_action がインクルードされている場合)。 |
segment_group_target |
オブジェクトの配列 | ターゲットとなるセグメント グループ。
segment_targets配列では個々のセグメント間でブール論理を定義できますが、この配列を使用すると、セグメントのグループを確立し、グループ間と各グループ内のセグメント間でブール論理を定義できます。 グループ間のブールロジックは、配列の外部にある segment_boolean_operator フィールドで定義します。グループオブジェクト内の boolean_operator フィールドを持つグループ内のセグメント間のブール論理を定義します。 詳細については、「 セグメント グループ ターゲット」を参照してください。 セグメント グループ ターゲットでは、1 つの除外グループと 1 つのインクルード グループのみを定義でき、これら 2 つのグループは OR'ed のみを定義できます。 対象となるのは、"市場内" セグメントのみです。 手記： Null セグメントを追加できません。 POSTまたはPUTを使用して、この配列に null セグメントを追加することはできません。 |
クリエイティブ サービスの機能強化
クリエイティブ サービスを使用して、システムにクリエイティブを追加できます。 クリエイティブをスマート広告申込情報に関連付ける場合は、ネイティブ広告タイプのみをアップロードできます。 上記のプロファイル サービスと同様に、クリエイティブを追加するときは、クリエイティブ サービス内の JSON フィールド で次のパラメーターを使用する必要があります。
クリエイティブ サービスの JSON フィールド
| フィールド | 型 (長さ) | 説明 |
|---|---|---|
native_attribute |
object | これは、ネイティブ広告に必要な要素を含む新しいネイティブ オブジェクトです。 詳細については、以下の 「Native Attribute オブジェクト」を参照してください。 既定値: null 必須: テンプレート 39461 のネイティブ広告に必要です。 |
ネイティブ属性
native_attribute オブジェクトには、次のフィールドが含まれています。
| フィールド | 型 (長さ) | 説明 |
|---|---|---|
link |
object | これは、ネイティブ クリエイティブに関連付けられている null 以外の URL です。 詳細については、「 Link オブジェクト」を参照してください。 |
data_assets |
object | ネイティブ クリエイティブのアセットの種類。 詳細については、「データ資産」を参照してください。 必須の値: - title: クリエイティブのタイトル。- description: アドバタイズされる製品またはサービスの説明。 - sponsored_by:スポンサーのブランド名。 最大長は 25 文字です。省略可能: - 入札者は、指定された場合、 custom_title_1、 custom_title_2、 custom_title_3、 custom_title_4 のデータ資産の種類を利用します。 各データ資産の種類の最大長は 30 文字です。 長さがこの制限を超えた場合、クリエイティブをスマート広告申込情報に関連付けることはできません。 - custom_title_5 エントリがある場合、このカスタム タイトルは入札者によって無視されますが、クリエイティブは引き続き Smart 広告申込情報に関連付けられます。- 入札者は、指定されている場合は、 custom_body_1、 custom_body_2、 custom_body_3、 custom_body_4 のデータ資産の種類を利用しますが、省略可能です。 各データ資産の種類の最大長は 90 文字です。 長さがこの制限を超えた場合、クリエイティブをスマート広告申込情報に関連付けることはできません。 - custom_body_5 エントリがある場合、このカスタム タイトルは入札者によって無視されますが、クリエイティブは引き続き Smart 広告申込情報に関連付けられます。 - call_to_action などのその他のフィールドは許可されますが、入札者によって無視されます。 |
image_assets |
オブジェクトの配列 | 個々のイメージの属性。 詳細については、「 Image Asset」を参照してください。 必須の値: - main_image: ネイティブ クリエイティブのレンダリング時に表示されるプライマリ イメージ。注: - main_image型のすべてのimage_assetsは、custom_image_1 - custom_image_5703ピクセルの最小幅と368ピクセルの最小高さを持っている必要があります。- icon_image’、‘custom_icon_1 - custom_icon_5’ は許可されますが、入札者によって無視されます。 |