נתוני גרסה

כאן אפשר לראות מה השתנה בכל גרסה של Data Manager API.

‫30.07.2026 גרסה 1.8

• הוספנו את השיטה RemoveAllAudienceMembers ל-IngestionService כדי להסיר או להחליף את כל המשתמשים מקהל היעד ברשימות המשתמשים שצוינו.
  • כדי להתחיל, עיינו במדריך להסרת כל החברים מקהל בשילוב הספציפי שלכם. לדוגמה, עיינו במדריכים בנושא התאמה ללקוחות ב-Google Ads או ב-Display & Video 360.
• הוספנו תמיכה בהחזרת אזהרות מפורטות במהלך הטמעת אירועים וקהלים.
  • הוספנו את השדה field_warnings ל-IngestEventsResponse ול-IngestAudienceMembersResponse, שמכיל רשימה של אובייקטים מסוג FieldWarning.
  • הוספנו את המשאב FieldWarning, שמכיל את הנתיבים reason (WarningReason), description ו-field.
  • הוספנו את הטיפוס המוגדר מראש WarningReason כדי להגדיר סיבות לאזהרות, כמו משתנים מותאמים אישית שלא מופעלים או מספרי חשבונות Merchant שחסרים בנתוני עגלות הקניות.
• נוספה תמיכה בשליחת שדות כתובת נוספים להטמעת אירועים ב-Google Analytics.
  • הוספנו את השדות address_line,‏ city ו-administrative_area ל-AddressInfo (שמשמש ב-UserData).
• הוספנו את סיבות השגיאה INVALID_REMOVE_AS_OF_TIME ו-REQUIRED_PREREQUISITE_LINK_MISSING לערך ה-enum‏ ErrorReason.

‫28.05.2026 גרסה 1.7

• הוספנו תמיכה בשליחת אירועי המרות אופליין למוצרי Google Marketing Platform, כולל Campaign Manager 360,‏ Search Ads 360 ו-Display & Video 360, באמצעות IngestEventsRequest.

  • הוספנו את FLOODLIGHT_CONFIG ל-enum‏ AccountType כדי לתמוך ביעדים של Floodlight.
  • הוספנו את השדות dclid,‏ impression_id,‏ match_id ו-encrypted_user_ids ל-AdIdentifiers.
  • הוספנו את השדה conversion_count למשאב Event כדי לתמוך במעקב אחרי כמויות ההמרות.

  כדי להתחיל, כדאי לעיין במדריך לשליחת אירועים או ללמוד איך לשדרג מ-Campaign Manager 360 API.

• הוספנו את השדה composite_data למשאב AudienceMember, שמקבל אובייקט CompositeData ומאפשר לשלב כמה סוגים של מזהים, כמו UserData ו-IpData. מידע נוסף זמין במאמר נתונים מורכבים.

  • הוספנו סטטוסים חדשים, IngestCompositeDataStatus ו-RemoveCompositeDataStatus, שכוללים אבחון (record_count ו-data_type_counts) לבקשות של משתמשים מקהל היעד שמשתמשים ב-CompositeData.

• הוספנו תמיכה בהטמעה של כתובות IP לצורך התאמה ללקוחות ב-Google Ads על ידי שליחת IpData בנתונים מורכבים.

• הוספנו סיבות חדשות לשגיאות: FIELD_VALUE_TOO_SHORT,‏ TOO_FEW_ELEMENTS,‏ BASELINE_LOCATION_AUTO_DETECTION_FAILED ו-INSIGHTS_MISSING_FOR_DIMENSION ל-enum‏ ErrorReason.

• הוספנו ערכי אבחון חדשים ל-ProcessingErrorReason כדי לספק משוב מפורט יותר על כשלים במהלך הטמעת אירועים.

‫2026-05-07 גרסה 1.6

• נוספה תמיכה בשליחת המרות למכירות בחנות הפיזית ב-Google Ads באמצעות IngestEventsRequest. כדי להשתמש בתכונה הזו, חשבון Google Ads שלכם צריך לעמוד בדרישות סף מסוימות.
  • הוספנו את השדה event_location ל-Event, שמאפשר לספק store_id. פיזי.
  • הוספנו את השדה third_party_user_data ל-Event, כדי לאפשר לסמן באופן מפורש נתונים שהוטמעו כנתונים שבבעלות צד שלישי.
    • רק שותפי נתונים יכולים לאכלס את השדה הזה.
  • הוספנו את השדות הבאים למשאב Item:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • ‫custom_variables (מקבלת רשימה של אובייקטים מסוג ItemCustomVariable)
  • כדי להתחיל, כדאי לעיין במדריכים הבאים:
    • שדרוג מ-Google Ads
    • שליחת אירועים
• הוספנו תמיכה בשליחה ל-Google Analytics של כל אירוע באתר או באפליקציה שהוא לא אירוע שמור.
  • הוספת השדה app_instance_id למשאב Event.
  • הוספנו שדות ל-DeviceInfo כדי לספק מטא-נתונים על המכשיר של המשתמש.
  • הוספנו את השדה mobile_device_id ל-AdIdentifiers.
  • הוספנו את השדה event_location ל-Event כדי לתעד שדות כמו city,‏ subdivision_code,‏ region_code,‏ subcontinent_code ו-continent_code.
  • כדי להתחיל, כדאי לעיין במדריכים הבאים:
    • שליחת אירועים מומלצים ואירועים בהתאמה אישית
    • שדרוג מ-Measurement Protocol
    • מקורות מידע מומלצים לגבי אירועים
• הוספנו תמיכה בשליחת כל אירוע עם מזהה עסקה למקורות נתונים של אתרים ושל אפליקציות, כמקור נתונים נוסף להטמעות של התג או של Google Analytics for Firebase (GA4F) SDK.
  • התכונה הזו מוגבלת לנכסים ב-Google Analytics שנמצאים ברשימת ההיתרים. אם אתם רוצים להוסיף את הנכס שלכם לרשימת ההיתרים, אתם צריכים למלא את הטופס הזה.
• הוספנו את השדה coupon_codes ל-CartData כדי לעקוב אחרי כל קודי השוברים שהוחלו על עגלת הקניות באירועים שנשלחו אל Google Ads ואל Google Analytics.
  • כדי למדוד מימוש שוברים ב-Google Ads, צריך להשתמש בסוג ההמרה OFFLINE_PROMOTION_REDEMPTION.
• הוספנו היקף הרשאות חדש של OAuth,‏ https://www.googleapis.com/auth/datamanager.partnerlink, לשיטות שקשורות ליצירה, לחיפוש ולמחיקה של קישורים לשותפים.
• הוספנו ערכים חדשים למאפיין enum‏ ErrorReason כדי לתמוך באימות מפורט של הטמעת אירועים ב-Google Analytics ובמכירות בחנות הפיזית.
• הוספנו את השדות youtube_members_count ו-gmail_members_count למשאב SizeInfo.

2026-03-26

• הוספנו את EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED לאינם (enum) ErrorReason.

  בהתאם לתקנה של האיחוד האירופי בנושא מודעות פוליטיות (EU PAR), ‏ Google דורשת מכל הלקוחות להצהיר בעצמם אם המודעות שלהם נחשבות פוליטיות לפי EU PAR. מה ההגדרה של מודעה שקשורה לפוליטיקה באיחוד האירופי ומה ההגבלות של Google על מודעות שקשורות לפוליטיקה באיחוד האירופי

  החל מ-1 באפריל 2026, יכול להיות שהפעולות הבאות בחשבונות שלא תהיה בהם ההצהרה הזו יוגבלו או ייכשלו עם השגיאה EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create, update ו- delete)
  • IngestionService (ingestAudienceMembers)

  כדי לפתור את השגיאה, המפרסמים צריכים לספק את ההצהרה הנדרשת בממשק המשתמש של Google Ads. איך מצהירים לגבי חשבון

• הוספנו את INVALID_MERCHANT_ID לאינם (enum) ErrorReason.

‫17 בפברואר 2026, גרסה 1.5

‫Data Manager API תומך עכשיו בכל תהליך העבודה מקצה לקצה לניהול קהלים, כולל יצירה, הטמעה ואחזור של קהלים.

• הוספנו את המשאב UserList ואת UserListService כדי לאפשר יצירה, אחזור, עדכון ומחיקה של רשימות משתמשים.
  • במדריכים של Google Ads ו-Display & Video 360 מוסבר איך ליצור, לאכלס ולאמת קהלים מסוג "התאמה ללקוחות" באמצעות Data Manager API.
  • כדי לראות את שלבי ההעברה, עיינו במדריכי השדרוג של Google Ads או של Display & Video 360.
• הוספנו תמיכה בשליחת מזהה משתמש באמצעות הטמעת משתמשים מקהל היעד, כדי לאפשר שימוש במזהה הזה עם התאמה ללקוחות ב-Google Ads.
  • הוספת את UserIdData אל AudienceMember.
  • הוספנו את IngestUserIdDataStatus ואת RemoveUserIdDataStatus לסטטוסים שמוחזרים על ידי ה-method‏ RetrieveRequestStatus. אפשר להשתמש בשדות האלה כדי לאחזר מידע לאבחון לגבי הטמעה והסרה של מזהי משתמשים.
• הוספנו את המשאב PartnerLink ואת PartnerLinkService כדי ליצור ולנהל קישורים בין חשבונות של מפרסמים ושותפי נתונים.
  • כדי להתחיל, כדאי לעיין במדריכים לקישורי שותפים.

2026-02-10

התכונה "שליחת המרות עם כמה מקורות נתונים" זמינה עכשיו לכלל המשתמשים בכל חשבונות Google Ads, והיא עוזרת לשפר את הביצועים ואת איכות הנתונים.

התכונה הזו עדיין זמינה רק לנכסים ב-Google Analytics שנמצאים ברשימת ההיתרים. אם אתם רוצים להוסיף את הנכס שלכם ב-Google Analytics לרשימת ההיתרים, אתם יכולים למלא את הטופס.

‫2025-11-05 גרסה 1.4

• הוספנו תמיכה בשליחת אירועים של Google Analytics purchase כמקור נתונים נוסף למעקב המרות באמצעות תג, כדי למקסם את האותות של אינטראקציות עם מודעות ולשפר את הנתונים והביצועים הכוללים.

  • הוספנו את GOOGLE_ANALYTICS_PROPERTY לערך הטיפוס המוגדר AccountType.
  • נוספו כמה שדות אל Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • הוספת את additional_user_properties אל UserProperties.

  במדריך בנושא אירועים מוסבר איך לשלוח אירועים ב-Google Analytics purchase ואיך למפות פרמטרים של אירועים ומאפייני משתמשים ב-Google Analytics לפרמטרים ומאפיינים מקבילים ב-Data Manager API.

• הוספנו את AwsWrappedKeyInfo כדי לתמוך בשימוש במפתחות הצפנה מ-שירות ניהול מפתחות (KMS) של AWS.

• הוספנו את ערכי ה-enum הבאים ל-ErrorReason:

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

‫2025-10-06 גרסה 1.3

• ‫Data Manager API זמין עכשיו לכלל המשתמשים (GA).

  האפשרות לשלוח המרות עם כמה מקורות נתונים כדי לשפר את הביצועים ואת איכות הנתונים עדיין זמינה רק לחשבונות שנמצאים ברשימת ההיתרים. אם אתם רוצים להוסיף את החשבון שלכם, מלאו את הטופס.

  כדי להביע עניין בהצטרפות כשותף נתונים, ממלאים את טופס ההתעניינות להצטרפות כשותף.

• הוספנו את השיטה RetrieveRequestStatus כדי לאחזר מידע אבחוני לגבי בקשות להטמעת אירועים וקהלים.

• השדה product של ProductAccount והערך המקודד Product הוצאו משימוש. במקום זאת, צריך להשתמש בשדה account_type ובערך החדש AccountType של enum.

• הוספנו תמיכה בהגדרת destination לכל AudienceMember ב-IngestAudienceMembersRequest. אתם יכולים להשתמש בתכונה הזו כדי לשלוח נתוני קהלים לכמה יעדים נפרדים בבקשה אחת.

• קהלים שהוטמעו באמצעות ה-API יכולים עכשיו לשמש לטירגוט ברגע שיש בהם לפחות 100 חברים. בעבר, הסף היה 1,000 חברים.

• השדה transaction_id של Event הוא עכשיו אופציונלי כששולחים המרות אופליין או המרות משופרות לצורך שיוך ללידים. עדיין צריך להשתמש ב-transaction_id כששולחים המרות אופליין כמקור נתונים נוסף כדי לשפר את הביצועים ואת חוזק הנתונים.

‫2025-08-06 גרסה 1.2

• הוספנו תמיכה בשליחת המרות אופליין והמרות משופרות לצורך שיוך ללידים ליעדים ב-Google Ads באמצעות השיטה IngestEvents. במדריך המעודכן בנושא הצפנה מוסבר איך להגדיר הצפנה להמרות האלה.
• הוספנו את הערכים APP,‏ IN_STORE,‏ PHONE ו-OTHER ל-enum‏ EventSource. כדי להשתמש בהמרות אופליין ובהמרות משופרות לצורך שיוך ללידים, צריך event_source.
• השדה user_properties נוסף אל Event. כדי להוסיף מידע שהמפרסם העריך לגבי משתמש בזמן שהאירוע התרחש, צריך להגדיר את השדה הזה לאובייקט UserProperties.
• נוסף שדה חוזר מסוג destination_references אל CustomVariable. אפשר להשתמש בשדה הזה כדי להחיל ערך של משתנה מותאם אישית רק על קבוצת משנה של היעדים של Event.
• הוספנו את השגיאות הבאות שקשורות להמרות אופליין ולהמרות משופרות לצורך שיוך ללידים:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

‫25.06.2025 גרסה 1.1

• הוספנו את ה-method‏ IngestEvents ל-IngestionService. השתמשו ב-IngestEvents כמקור נתונים נוסף למעקב המרות באמצעות תג, כדי למקסם את האותות של האינטראקציות עם המודעות ולשפר את הנתונים ואת הביצועים הכוללים.

‫2025-04-02 גרסה 1.0

• הגרסה הראשונה של Data Manager API, עם תמיכה בשליחת נתוני קהלים אל Google Ads ואל Display & Video 360.
• הוספנו תמיכה ב-gRPC וב-REST.
• הוספנו את IngestionService עם השיטות IngestAudienceMembers ו-RemoveAudienceMembers לניהול משתמשים מקהל היעד באמצעות סוגי הנתונים הבאים:
  • פרטים ליצירת קשר
  • Mobile ID (mID)
  • מזהי PAIR
• קהלים שמנוהלים באמצעות Data Manager API יכולים לשמש לטירגוט רק אם יש בהם לפחות 1,000 חברים.