נתוני גרסה

כאן אפשר לקרוא על השינויים בכל גרסה של 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.
  • נוסף ה-enum‏ WarningReason כדי להגדיר סיבות לאזהרות, כמו משתנים מותאמים אישית שלא הופעלו או מזהי מוֹכרים חסרים בנתוני עגלת הקניות.
• נוספה תמיכה בשליחת שדות נוספים של כתובות לצורך הטמעה של אירועים ב-Google Analytics.
  • הוספנו את השדות address_line,‏ city ו-administrative_area אל AddressInfo (בשימוש ב-UserData).
• נוספו הסיבות לשגיאה INVALID_REMOVE_AS_OF_TIME ו-REQUIRED_PREREQUISITE_LINK_MISSING לאנום 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 v1.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 מחייבת את כל הלקוחות להצהיר בעצמם אם המודעות שלהם נחשבות פוליטיות בהתאם לתקנות האלה. מה ההגדרה של מודעה שקשורה לפוליטיקה באיחוד האירופי ומה ההגבלות של Google על מודעות שקשורות לפוליטיקה באיחוד האירופי

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

  • ‪UserListService (create, update, and delete)
  • IngestionService (ingestAudienceMembers)

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

• הוספנו את INVALID_MERCHANT_ID ל-enum‏ 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

• הוספנו תמיכה בשליחת אירועים של 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 כדי לאפשר שימוש במפתחות הצפנה מ-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 והערך המקודד 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

‫2025-06-25 גרסה 1.1

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

‫2025-04-02 v1.0

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