アドカスタマイザーとは、検索広告の広告文面を動的に変更できる機能です。
広告のタイトルや説明文に任意のテキストを自動挿入できます。また、カウントダウン関数を使って、セール終了までの時間をカウントダウン表示できます。
アドカスタマイザーについて、詳しくは以下のヘルプをご参照ください。
・アドカスタマイザーについて
・レスポンシブ検索広告とは
検索広告APIではアドカスタマイザーを利用するために、以下のServiceを使用します。
カスタマイザー属性の取得および追加・削除を行います。
アカウント/キャンペーン/広告グループ/キーワードとカスタマイザー属性間の設定情報の追加をする際、先にカスタマイザー属性の追加を行ってください。
アカウントとカスタマイザー属性間の設定情報の取得および追加・削除を行います。
キャンペーンとカスタマイザー属性間の設定情報の取得および追加・削除を行います。
広告グループとカスタマイザー属性間の設定情報の取得および追加・削除を行います。
キーワードとカスタマイザー属性間の設定情報の取得および追加・削除を行います。
登録したデータを挿入する広告（データ挿入用の関数を使用した広告）に関する情報の取得および追加・更新・削除を行います。
A社は、販促施策の一環として、検索広告APIを使い、以下のデータセットを作成します。
| アカウント名 （AccountId） |
キャンペーン名 （CampaignId） |
広告グループ （AdGroupId） |
キーワード （CriterionId） |
商品名 （TEXT） |
最安値 （PRICE） |
モデル数 （NUMBER） |
割引率 （PERCENT） |
|---|---|---|---|---|---|---|---|
| てすと１50 （111111） |
最新モデル | $100 | 50 | 10% | |||
| てすと１50 （111111） |
家電セール （222222） |
格安家電 | $80 | 100 | 10% | ||
| てすと１50 （111111） |
家電セール （222222） |
テレビ （333333） |
人気テレビ | $500 | 30 | 20% | |
| てすと１50 （111111） |
家電セール （222222） |
テレビ （333333） |
4K （444444） |
4Kテレビ | $800 | 8 | 30% |
※1つのアカウントに対し、属性名は40個まで登録できます。
※アカウント/キャンペーン/広告グループ/キーワードで、同じ属性名で別の属性値が登録されたとき、配信時に下位エンティティの設定が優先されます。
カスタマイザー属性の情報を追加するときは、CustomizerAttributeService/addを使います。
{
"accountId": 111111,
"operand": [
{
"name": "商品名",
"type": "TEXT"
},
{
"name": "最安値",
"type": "PRICE"
},
{
"name": "モデル数",
"type": "NUMBER"
},
{
"name": "割引率",
"type": "PERCENT"
}
]
}
{
"errors": null,
"rid": "23eed375ce1c2d467d88ecaebc22b68c",
"rval": {
"values": [
{
"errors": null,
"customizerAttribute": {
"accountId": 111111,
"customizerAttributeId": 555555,
"name": "商品名",
"type": "TEXT"
},
"operationSucceeded": true
},
{
"errors": null,
"customizerAttribute": {
"accountId": 111111,
"customizerAttributeId": 666666,
"name": "最安値",
"type": "PRICE"
},
"operationSucceeded": true
},
{
"errors": null,
"customizerAttribute": {
"accountId": 111111,
"customizerAttributeId": 777777,
"name": "モデル数",
"type": "NUMBER"
},
"operationSucceeded": true
},
{
"errors": null,
"customizerAttribute": {
"accountId": 111111,
"customizerAttributeId": 888888,
"name": "割引率",
"type": "PERCENT"
},
"operationSucceeded": true
}
]
}
}
アカウントとカスタマイザー属性間の設定情報を追加するときは、AccountCustomizerService/addを使います。
{
"accountId": 111111,
"operand": [
{
"customizerAttributeId": 555555,
"value": "最新モデル"
},
{
"customizerAttributeId": 666666,
"value": "$100"
},
{
"customizerAttributeId": 777777,
"value": "50"
},
{
"customizerAttributeId": 888888,
"value": "10%"
}
]
}
{
"errors": null,
"rid": "a10c6dd1f72911dc3a1cf2c3ac525790",
"rval": {
"values": [
{
"errors": null,
"accountCustomizer": {
"accountId": 111111,
"customizerAttributeId": 555555,
"value": "最新モデル",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"accountCustomizer": {
"accountId": 111111,
"customizerAttributeId": 666666,
"value": "$100",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"accountCustomizer": {
"accountId": 111111,
"customizerAttributeId": 777777,
"value": "50",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"accountCustomizer": {
"accountId": 111111,
"customizerAttributeId": 888888,
"value": "10%",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
}
]
}
}
キャンペーンとカスタマイザー属性間の設定情報を追加するときは、CampaignCustomizerService/addを使います。
{
"accountId": 111111,
"operand": [
{
"campaignId": 222222,
"customizerAttributeId": 555555,
"value": "格安家電"
},
{
"campaignId": 222222,
"customizerAttributeId": 666666,
"value": "$80"
},
{
"campaignId": 222222,
"customizerAttributeId": 777777,
"value": "100"
},
{
"campaignId": 222222,
"customizerAttributeId": 888888,
"value": "10%"
}
]
}
{
"errors": null,
"rid": "ffde17246767f62feff67e26de6c8a79",
"rval": {
"values": [
{
"errors": null,
"campaignCustomizer": {
"accountId": 111111,
"campaignId": 222222,
"customizerAttributeId": 555555,
"value": "格安家電",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"campaignCustomizer": {
"accountId": 111111,
"campaignId": 222222,
"customizerAttributeId": 666666,
"value": "$80",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"campaignCustomizer": {
"accountId": 111111,
"campaignId": 222222,
"customizerAttributeId": 777777,
"value": "100",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"campaignCustomizer": {
"accountId": 111111,
"campaignId": 222222,
"customizerAttributeId": 888888,
"value": "10%",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
}
]
}
}
広告グループとカスタマイザー属性間の設定情報を追加するときは、AdGroupCustomizerService/addを使います。
{
"accountId": 111111,
"operand": [
{
"adGroupId": 333333,
"customizerAttributeId": 555555,
"value": "人気テレビ"
},
{
"adGroupId": 333333,
"customizerAttributeId": 666666,
"value": "$500"
},
{
"adGroupId": 333333,
"customizerAttributeId": 777777,
"value": "30"
},
{
"adGroupId": 333333,
"customizerAttributeId": 888888,
"value": "20%"
}
]
}
{
"errors": null,
"rid": "07651bf1409e00247ad811ffd1004bb3",
"rval": {
"values": [
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"adGroupId": 333333,
"customizerAttributeId": 555555,
"value": "人気テレビ",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"adGroupId": 333333,
"customizerAttributeId": 666666,
"value": "$500",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"adGroupId": 333333,
"customizerAttributeId": 777777,
"value": "30",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"adGroupId": 333333,
"customizerAttributeId": 888888,
"value": "20%",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
}
]
}
}
キーワードとカスタマイザー属性間の設定情報を追加するときは、AdGroupCriterionCustomizerService/addを使います。
{
"accountId": 111111,
"operand": [
{
"criterionId": 444444,
"customizerAttributeId": 555555,
"value": "4Kテレビ"
},
{
"criterionId": 444444,
"customizerAttributeId": 666666,
"value": "$800"
},
{
"criterionId": 444444,
"customizerAttributeId": 777777,
"value": "8"
},
{
"criterionId": 444444,
"customizerAttributeId": 888888,
"value": "30%"
}
]
}
{
"errors": null,
"rid": "080fded16a1a522fce1c4432dc3b13b7",
"rval": {
"values": [
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"criterionId": 444444,
"customizerAttributeId": 555555,
"value": "4Kテレビ",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"criterionId": 444444,
"customizerAttributeId": 666666,
"value": "$800",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"criterionId": 444444,
"customizerAttributeId": 777777,
"value": "8",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
},
{
"errors": null,
"adGroupCustomizer": {
"accountId": 111111,
"criterionId": 444444,
"customizerAttributeId": 888888,
"value": "30%",
"approvalStatus": null,
"disapprovalReasonCodes": null
},
"operationSucceeded": true
}
]
}
}
登録したデータを挿入する広告（データ挿入用の関数を使用した広告）を追加するときは、AdGroupAdService/addを使います。
また、カウントダウン関数を使用すると、広告内にセールやキャンペーンなどの終了までの残り時間を表示できます。そしてカウントダウンの終了とともに、そのAssetは無効になります。
そのため、カウントダウン関数を使用したAssetは、Headlines（タイトル）とDescriptions（説明文）の最低数としてカウントしませんが、最大数としてはカウントする必要があります。
例えば、Descriptionsは最低2件、最大4件の指定が必要ですが、カウントダウン関数を含めないDescriptionsを2件以上、カウントダウン関数の有無関係なしのDescriptionsを4件以内の登録が必要です。
カウントダウン関数（レスポンシブ検索広告用）について、詳しくは以下のヘルプをご参照ください。
・カウントダウン関数（レスポンシブ検索広告用）
{
"accountId": 111111,
"operand": [
{
"ad": {
"adType": "RESPONSIVE_SEARCH_AD",
"finalUrl": "http://www.example.jp",
"responsiveSearchAd": {
"headlines": [
{
"text": "{CUSTOMIZER.商品名:デフォルト値}がお買い得",
"pinnedField": "HEADLINE1"
},
{
"text": "納得価格の{CUSTOMIZER.最安値:デフォルト値}",
"pinnedField": "HEADLINE2"
},
{
"text": "今なら{CUSTOMIZER.割引率:デフォルト値}引き",
"pinnedField": "HEADLINE3"
},
{
"text": "あと{COUNTDOWN(2022-06-01 00:00:00,30)}で終了",
"pinnedField": "UNSPECIFIED"
}
],
"descriptions": [
{
"text": "最新機種の{CUSTOMIZER.商品名:デフォルト値}が今だけ{CUSTOMIZER.最安値:デフォルト値}から！",
"pinnedField": "DESCRIPTION1"
},
{
"text": "全モデル{CUSTOMIZER.モデル数:デフォルト値}種類が{CUSTOMIZER.割引率:デフォルト値}以上オフ",
"pinnedField": "DESCRIPTION2"
},
{
"text": "あと{COUNTDOWN(2022-06-01 00:00:00,30)}で終了するのでお急ぎください。",
"pinnedField": "UNSPECIFIED"
}
]
}
},
"adGroupId": 333333,
"adName": "Auto Ads",
"campaignId": 222222,
"userStatus": "ACTIVE"
}
]
}
{
"errors": null,
"rid": "50ec2df1d0bc693de9289fef50bd9045",
"rval": {
"values": [
{
"adGroupAd": {
"accountId": 111111,
"ad": {
"adType": "RESPONSIVE_SEARCH_AD",
"smartphoneFinalUrl": null,
"finalUrl": "http://www.example.jp",
"appAd": null,
"customParameters": null,
"description1": null,
"devicePreference": null,
"displayUrl": "www.example.jp",
"extendedTextAd": null,
"responsiveSearchAd": {
"headlines": [
{
"text": "{CUSTOMIZER.商品名:デフォルト値}がお買い得",
"pinnedField": "HEADLINE1",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
{
"text": "納得価格の{CUSTOMIZER.最安値:デフォルト値}",
"pinnedField": "HEADLINE2",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
{
"text": "今なら{CUSTOMIZER.割引率:デフォルト値}引き",
"pinnedField": "HEADLINE3",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
{
"text": "あと{COUNTDOWN(2022-06-01 00:00:00,30)}で終了",
"pinnedField": "UNSPECIFIED",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
}
],
"descriptions": [
{
"text": "最新機種の{CUSTOMIZER.商品名:デフォルト値}が今だけ{CUSTOMIZER.最安値:デフォルト値}から！",
"pinnedField": "DESCRIPTION1",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
{
"text": "全モデル{CUSTOMIZER.モデル数:デフォルト値}種類が{CUSTOMIZER.割引率:デフォルト値}以上オフ",
"pinnedField": "DESCRIPTION2",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
},
{
"text": "あと{COUNTDOWN(2022-06-01 00:00:00,30)}で終了するのでお急ぎください。",
"pinnedField": "UNSPECIFIED",
"approvalStatus": "REVIEW",
"disapprovalReasonCodes": null
}
],
"path1": null,
"path2": null
},
"headline1": null,
"textAd2": null,
"dynamicSearchLinkedAd": null,
"trackingUrl": null,
"url": null
},
"adGroupId": 333333,
"adGroupName": "テレビ",
"adGroupTrackId": 134525846777,
"adId": 999999,
"adName": "Auto Ads",
"adTrackId": 0,
"approvalStatus": "REVIEW",
"campaignId": 222222,
"campaignName": "家電セール",
"campaignTrackId": 17246010137,
"disapprovalReasonCodes": null,
"feedId": null,
"invalidedTrademarks": null,
"labels": null,
"trademarkStatus": "NO_RESTRICTION",
"userStatus": "ACTIVE",
"createdDate": "20220513"
},
"errors": null,
"operationSucceeded": true
}
]
}
}