מזהים

רוב הישויות ב-Google Ads חושפות שיטת getId() שמחזירה את המזהה שלהן. ברוב המקרים, התעודות המזהות יכולות להועיל לכם כאשר:

עבודה עם דוחות

בעזרת מזהים, אפשר לקשר שורה בדוח לישות בפועל ב-Google Ads.

ניהול מיפוי באמצעות מאגר נתונים חיצוני

יכול להיות שכבר יש לכם מידע שמבוסס על המזהה ומאוחסן במסד הנתונים שלך.

מחפשים שיפור קל בביצועים

אחזור לפי מזהים בדרך כלל מהיר יותר מהחלופות. גם הקוד לאחזור ישות יחידה הוא קצת יותר קל:

let campaigns = AdsApp.campaigns()
   .withIds([678678])
   .get();
// vs.
let campaigns = AdsApp.campaigns()
   .withCondition("Name='My Campaign'")
   .get();

ייחודיות

מזהי הקמפיין ומזהי קבוצות המודעות הם ייחודיים: אין שני קמפיינים או קבוצות של מודעות עם אותו מזהה. עם זאת, למודעות ולמילות מפתח יש מזהים מורכבים: מזהה ייחודי של מילת מפתח הוא שילוב של מזהה קבוצת המודעות ומזהה מילת המפתח שלה. באופן דומה, מזהה ייחודי של מודעה הוא שילוב של מזהה קבוצת המודעות ומזהה המודעה. לכך יש השלכות על הדרך שבה נקרא selector.withIds().

בקמפיינים ובקבוצות של מודעות, selector.withIds() מצפה למערך של מספרים:

let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);

עם זאת, למודעות ומילות מפתח, selector.withIds() זקוק למערך של מערכי שני רכיבים, הרכיב הראשון הוא מזהה קבוצת המודעות. קטע הקוד הבא מאחזר שלוש מילות מפתח מקבוצת מודעות:

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

אותו מבנה חל בעת אחזור מודעות.