מסך
הוסף מיקום לקבוצת מודעות קיימת
function addPlacementToAdGroup(adGroupName, url, cpc) {
const adGroups = AdsApp.adGroups()
.withCondition(`ad_group.name = '${adGroupName}'`)
.get();
if (!adGroups.hasNext()) {
throw new Error(`No ad group with the name '${adGroupName}' was found.`);
}
const adGroup = adGroups.next();
if (adGroups.totalNumEntities() > 1) {
console.warn(`Found ${adGroups.totalNumEntities()} ad groups with the ` +
`name '${adGroupName}'. Adding placement to the ad group in campaign ` +
`'${adGroup.getCampaign().getName()}'.`);
}
// Other display criteria can be built in a similar manner using the
// corresponding builder method in the AdsApp.CampaignDisplay or
// AdsApp.AdGroupDisplay class.
const placementBuilder = adGroup.display()
.newPlacementBuilder()
.withUrl(url); // required
if (cpc) {
placementBuilder.withCpc(cpc); // optional
}
const operation = placementBuilder.build();
if (operation.getStatus() == 'SUCCESS') {
const placement = operation.getResult();
console.log(`Placement with id = ${placement.getId()} and url = ${placement.getUrl()} was created.`);
} else {
console.warn(`Failed to create placement. Errors = ${operation.getErrors().join(', ')}`);
}
}
אחזר את כל הנושאים בקבוצת מודעות קיימת
function getAllTopics(campaignName, adGroupName) {
return AdsApp.display()
.topics()
.withCondition(`campaign.name = '${campaignName}'`)
.withCondition(`ad_group.name = '${adGroupName}'`);
}
רישום נתונים סטטיסטיים של כל הקהלים בקבוצת מודעות קיימת
function logAudienceStats(campaignName, adGroupName, dateRange = 'LAST_MONTH') {
// Other display criteria can be retrieved in a similar manner using
// the corresponding selector methods in the AdsApp.Display,
// AdsApp.CampaignDisplay or AdsApp.AdGroupDisplay class.
const audienceIterator = AdsApp.display()
.audiences()
.withCondition(`campaign.name = '${campaignName}'`)
.withCondition(`ad_group.name = '${adGroupName}'`)
.get();
console.log('ID, Audience ID, Clicks, Impressions, Cost');
for (const audience of audienceIterator) {
const stats = audience.getStatsFor(dateRange);
// User List IDs (List IDs) are available on the details page of
// a User List (found under the Audiences section of the Shared
// Library)
console.log(`${audience.getId().toFixed(0)}, ${audience.getAudienceId()}, `
+ `${stats.getClicks()}, ${stats.getImpressions()}, ${stats.getCost()}`);
}
}
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-09-11 (שעון UTC).
[null,null,["עדכון אחרון: 2024-09-11 (שעון UTC)."],[[["The provided code snippets demonstrate how to manage display targeting in Google Ads using scripts."],["It includes functionalities to add placements to ad groups, specifying URLs and optional CPC bids."],["Additionally, it showcases retrieving topics and audience performance statistics within specific ad groups and campaigns."],["Example functions cover topics such as adding placements, retrieving topics by campaign/ad group, and logging audience stats with customizable date ranges."]]],[]]