נתוני גרסה

כאן אפשר לקרוא על השינויים שבוצעו בכל גרסה של Data Manager API.

‫2026-05-28 גרסה 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 objects)
  • כדי להתחיל, מומלץ לעיין במדריכים הבאים:
    • שדרוג מ-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 לספירה ErrorReason.

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

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

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

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

• הוספנו את INVALID_MERCHANT_ID לספירה ErrorReason.

‫2026-02-17 גרסה 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

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

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

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

• נוסף AwsWrappedKeyInfo כדי לתמוך בשימוש במפתחות הצפנה מ-AWS Key Management Service.

• נוספו ערכי ה-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 זמין עכשיו לכל המשתמשים.

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

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

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

• השדה product של ProductAccount וה-enum‏ Product הוצאו משימוש. במקום זאת, משתמשים בשדה account_type ובסוג ה-enum החדש AccountType.

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

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

• השדה 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 לניהול חברי קהל באמצעות סוגי הנתונים הבאים:
  • פרטים ליצירת קשר
  • תעודות מזהות בנייד
  • מזהי זוגות
• קהלים שמנוהלים באמצעות Data Manager API יכולים לשמש לטירגוט רק אם יש בהם לפחות 1,000 חברים.