Yahoo! JAPAN Ads Script | Developer Center
日本語Targeting
・Set location and bid modifiers・Set device and bid modifiers
・Set schedule and bid modifiers
・Set age and bid modifiers
Set location and bid modifiers
function setLocationAndBidModifiers() {
const dictionaries = Display.DictionaryService.getGeographicLocation({
lang: 'JA',
}).rval;
const geoName = '東京都';
let targetId;
for (let i = 0; i < dictionaries.totalNumEntries; i++){
let geographicLocation = dictionaries.values[i].geographicLocation;
if (geographicLocation.fullName == geoName){
targetId = geographicLocation.code;
break;
}
}
if (targetId == undefined) {
Logger.log('code of ' + geoName + ' is not found');
return;
}
const accountId = AdsUtilities.getCurrentAccountId();
const adGroupTargetArray = [
{
campaignId: 11111111,
adGroupId: 222222222,
target: {
targetId: targetId,
targetType: 'GEO_TARGET',
}
},
{
campaignId: 33333333,
adGroupId: 444444444,
bidMultiplier: 1.5,
target: {
targetId: targetId,
targetType: 'GEO_TARGET',
}
}
];//Multiple selections are possible
const adGroupTargets = Display.AdGroupTargetService.add({
accountId: accountId,
operand: adGroupTargetArray,
}).rval;
for (let i = 0; i < adGroupTargets.values.length; i++) {
if (adGroupTargets.values[i].operationSucceeded) {
let adGroupTargetList = adGroupTargets.values[i].adGroupTargetList;
Logger.log('adGroupId-> ' + adGroupTargetList.adGroupId
+ ', campaignId-> ' + adGroupTargetList.campaignId
+ ' set as geoNameJa-> ' + adGroupTargetList.target.geoTarget.geoNameJa
+ ', targetId-> ' + adGroupTargetList.target.targetId
+ ', targetType-> ' + adGroupTargetList.target.targetType
+ ', bidMultiplier-> ' + adGroupTargetList.bidMultiplier);
} else {
Logger.log('adGroupId-> ' + adGroupTargetArray[i].adGroupId
+ ', campaignId-> ' + adGroupTargetArray[i].campaignId
+ ' could not set as geoNameJa-> ' + geoName
+ ', targetId-> ' + adGroupTargetArray[i].target.targetId
+ ', targetType-> ' + adGroupTargetArray[i].target.targetType);
}
}
}
Set device and bid modifiers
function setDeviceAndBidModifiers() {
const accountId = AdsUtilities.getCurrentAccountId();
const adGroupIds = [111111111, 222222222, 333333333];//Empty when not specified
const devices = ['DESKTOP', 'SMARTPHONE', 'TABLET'];//Multiple selections are possible
const deviceApp = ['APP', 'WEB'];
const deviceOs = ['IOS', 'ANDROID'];
const desktopBid = 1.0;
const smartphoneBid = 1.5;
const tabletBid = 2.0;
const adGroupsGet = Display.AdGroupService.get({
accountId: accountId,
adGroupIds: adGroupIds,
}).rval;
if (adGroupsGet.totalNumEntries == 0) {
Logger.log('AdGroup does not exist.');
return;
}
let adGroupArray = [];
for (let i = 0; i < adGroupsGet.values.length; i++) {
let adGroup = adGroupsGet.values[i].adGroup;
let setAdGroup = {
accountId: accountId,
campaignId: adGroup.campaignId,
adGroupId: adGroup.adGroupId,
device: devices,
deviceApp: deviceApp,//No necessary when devices is only 'DESKTOP'
deviceOs: deviceOs//No necessary when devices is only 'DESKTOP'
};
adGroupArray.push(setAdGroup);
}
Display.AdGroupService.set({
accountId: accountId,
operand: adGroupArray,
}).rval;
const adGroupTargetsGet = Display.AdGroupTargetService.get({
accountId: accountId,
adGroupIds: adGroupIds,
targetTypes: ['DEVICE_TARGET'],
}).rval;
if (adGroupTargetsGet.totalNumEntries == 0) {
Logger.log('AdGroupTarget does not exist.');
return;
}
let adGroupTargetArray = [];
for (let i = 0; i < adGroupTargetsGet.totalNumEntries; i++) {
let adGroupTargetList = adGroupTargetsGet.values[i].adGroupTargetList;
let setTargetList = {
accountId: accountId,
campaignId: adGroupTargetList.campaignId,
adGroupId: adGroupTargetList.adGroupId,
target: {
targetType: adGroupTargetList.target.targetType,
targetId: adGroupTargetList.target.targetId,
deviceTarget: adGroupTargetList.target.deviceTarget
}
};
switch (adGroupTargetList.target.deviceTarget.deviceType) {
case 'DESKTOP':
setTargetList.bidMultiplier = desktopBid;
break;
case 'SMARTPHONE':
setTargetList.bidMultiplier = smartphoneBid;
break;
case 'TABLET':
setTargetList.bidMultiplier = tabletBid;
break;
default:
break;
}
adGroupTargetArray.push(setTargetList);
}
const adGroupTargetsSet = Display.AdGroupTargetService.set({
accountId: accountId,
operand: adGroupTargetArray,
}).rval;
for (let i = 0; i < adGroupTargetsSet.values.length; i++) {
if (adGroupTargetsSet.values[i].operationSucceeded) {
let adGroupTargetList = adGroupTargetsSet.values[i].adGroupTargetList;
Logger.log('adGroupId-> ' + adGroupTargetList.adGroupId
+ ', campaignId-> ' + adGroupTargetList.campaignId
+ ' have set to bidMultiplier-> ' + adGroupTargetList.bidMultiplier
+ ', deviceType-> ' + adGroupTargetList.target.deviceTarget.deviceType);
} else {
let adGroupTargetList = adGroupTargetArray[i];
Logger.log('adGroupId-> ' + adGroupTargetList.adGroupId
+ ', campaignId-> ' + adGroupTargetList.campaignId
+ ' could not to set to bidMultiplier-> ' + adGroupTargetList.bidMultiplier
+ ', deviceType-> ' + adGroupTargetList.target.deviceTarget.deviceType);
}
}
}
Set schedule and bid modifiers
function setScheduleAndBidModifiers() {
const accountId = AdsUtilities.getCurrentAccountId();
const adGroupTargetArray = [
{
adGroupId: 111111111,
bidMultiplier: 1.2,
campaignId: 22222222,
target: {
adScheduleTarget: {
dayOfWeek: 'MONDAY',
startHour: 12,
endHour: 15,
},
targetType: 'AD_SCHEDULE_TARGET',
},
},
{
adGroupId: 333333333,
bidMultiplier: 1.5,
campaignId: 44444444,
target: {
adScheduleTarget: {
dayOfWeek: 'SUNDAY',
startHour: 17,
endHour: 18,
},
targetType: 'AD_SCHEDULE_TARGET',
},
}
];//Multiple selections are possible
const adGroupTargets = Display.AdGroupTargetService.add({
accountId: accountId,
operand: adGroupTargetArray,
}).rval;
for (let i = 0; i < adGroupTargets.values.length; i++) {
if (adGroupTargets.values[i].operationSucceeded) {
let adGroupTargetList = adGroupTargets.values[i].adGroupTargetList;
Logger.log('adGroupId-> ' + adGroupTargetList.adGroupId
+ ', campaignId-> ' + adGroupTargetList.campaignId
+ ' have set to dayOfWeek-> ' + adGroupTargetList.target.adScheduleTarget.dayOfWeek
+ ', Hour->' + adGroupTargetList.target.adScheduleTarget.startHour
+ '-' + adGroupTargetList.target.adScheduleTarget.endHour
+ ', bidMultiplier-> ' + adGroupTargetList.bidMultiplier);
} else {
let adScheduleTarget = adGroupTargetArray[i].target.adScheduleTarget;
Logger.log('adGroupId-> ' + adGroupTargetArray[i].adGroupId
+ ', campaignId-> ' + adGroupTargetArray[i].campaignId
+ ' could not to set to dayOfWeek-> ' + adScheduleTarget.dayOfWeek
+ ', Hour->' + adScheduleTarget.startHour + '-' + adScheduleTarget.endHour
+ ', bidMultiplier-> ' + adGroupTargetArray[i].bidMultiplier);
}
}
}
Set age and bid modifiers
function setAgeAndBidModifiers() {
const accountId = AdsUtilities.getCurrentAccountId();
const adGroupTargetArray = [
{
campaignId: 11111111,
adGroupId: 222222222,
bidMultiplier: 1.2,
target: {
ageTarget: {
age: 'GT_RANGE20_24',
},
targetType: 'AGE_TARGET',
},
},
{
campaignId: 33333333,
adGroupId: 444444444,
bidMultiplier: 1.5,
target: {
ageTarget: {
age: 'GT_RANGE70_UL2',
},
targetType: 'AGE_TARGET',
},
}
];//Multiple selections are possible
const adGroupTargets = Display.AdGroupTargetService.add({
accountId: accountId,
operand: adGroupTargetArray,
}).rval;
for (let i = 0; i < adGroupTargets.values.length; i++) {
if (adGroupTargets.values[i].operationSucceeded) {
let adGroupTargetList = adGroupTargets.values[i].adGroupTargetList;
let age = adGroupTargetList.target.ageTarget.age;
let ageRange = 'UNKNOWN';
if (age == 'GT_RANGE70_UL2') {
ageRange = '70-';
} else if (age.indexOf('GT_RANGE') >= 0) {
ageRange = age.replace('GT_RANGE', '').replace('_', '-');
}
Logger.log('adGroupId-> ' + adGroupTargetList.adGroupId
+ ', campaignId-> ' + adGroupTargetList.campaignId
+ ' have set to age-> ' + ageRange
+ ', bidMultiplier-> ' + adGroupTargetList.bidMultiplier);
} else {
let age = adGroupTargetArray[i].target.ageTarget.age;
let ageRange = 'UNKNOWN';
if (age == 'GT_RANGE70_UL2') {
ageRange = '70-';
} else if (age.indexOf('GT_RANGE') >= 0) {
ageRange = age.replace('GT_RANGE', '').replace('_', '-');
}
Logger.log('adGroupId-> ' + adGroupTargetArray[i].adGroupId
+ ', campaignId-> ' + adGroupTargetArray[i].campaignId
+ ' could not to set to age-> ' + ageRange
+ ', bidMultiplier-> ' + adGroupTargetArray[i].bidMultiplier);
}
}
}