מיפוי מזהים לממשק החדש של Search Ads 360

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מאפשר גמישות רבה יותר לבנות דוחות בהתאמה אישית ולשלב את הנתונים באפליקציות ובתהליכים שמשמשים לדיווח. מידע נוסף על המעבר ל-Search Ads 360 Reporting API החדש ועל השימוש בו

לממשק החדש של Search Ads 360 יש מרחב מזהי ישויות שונה מזה של הממשק הקודם של Search Ads 360. כדי לקבל את מיפוי המזהים בין הממשק הקודם לממשק החדש של Search Ads 360, שולחים בקשה Reports.getIdMappingFile(). התגובה כוללת מיפויים של מזהי רוב הישויות של מפרסם מסוים. במאמר סיבות נפוצות לכך שישויות חסרות מפורט מידע נוסף על הסיבות לכך שישות מסוימת לא נכללת בקובץ המיפוי.

דוגמה לקובץ המוחזר (פורמט CSV בקידוד UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

קובץ ה-CSV מכיל 3 עמודות:

  • Entity Type: סוג הישות של השורה הזו.

  • Legacy IDs: מחרוזת JSON של נתיב הישות המלא בממשק הקודם של Search Ads 360

  • New IDs: מחרוזת JSON של נתיב הישות המלא בממשק החדש של Search Ads 360

בטבלה הבאה מופיעה רשימה של ישויות נתמכות ומיפויים לדוגמה של מזהים:

סוג ישות תיאור מזהי דור קודם מזהים חדשים
לקוח מיפוי מזהה עבור: לא ניתן ליצור מיפויים לחשבונות ניהול ולסוכנויות. 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
קמפיין מיפוי מזהה של campaign. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP מיפוי מזהה של adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
CRITERION מיפוי מזהי קריטריונים ברמת קבוצת המודעות: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD מיפוי מזהה של ad. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION מיפוי מזהה לקריטריונים ברמת הקמפיין: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP מיפוי מזהה של קבוצת קמפיינים. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET מיפוי מזהה של יעד ביצועים של קבוצת קמפיינים. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE מיפוי מזהה לטבלת הפיד. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM מיפוי מזהה של feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

סיבות נפוצות לכך שחסרות ישויות

קובץ המיפוי של המפרסם יכיל את רוב הישויות שלו, אבל עדיין יש מקרים שבהם יהיו חסרות ישויות. אלה כמה מהסיבות הנפוצות ביותר לכך:

  • כל קובץ מיפוי מתעדכן כל 3 ימים. אם מורידים קובץ מיפוי מיד אחרי יצירת ישות חדשה, סביר להניח שהישות לא תופיע בקובץ המיפוי. סביר להניח שהיא תתווסף לאחר המתנה של עד 3 ימים.
  • החשבון שאליו הישות שייכת יוסר. במקרה כזה, אנחנו לא תומכים במיפוי זהויות.
  • אין תמיכה בממשק החדש של Search Ads 360 בעדכון של ישות (לדוגמה, קמפיין) בצד המנוע. העדכונים טופלו על ידי יצירת ישות חדשה ב-Search Ads 360, עם העדכון וההסרה של הישות הקודמת ב-Search Ads 360.
  • יכול להיות שהמיפויים הקודמים הוסרו כתוצאה מסנכרון בין הממשק הקודם לממשק החדש של Search Ads 360, שבו נשמר רק המיפוי האחרון. מתבצעת פתרון של מספר מיפויים בין מזהה קודם אחד למספר מזהי Search Ads 360 חדשים, תוך שמירה על המזהה עם חותמת הזמן העדכנית ביותר.
  • חשבון המנוע לא מסתנכרן בגלל שגיאות בסנכרון בין הממשק הקודם לממשק החדש של Search Ads 360.
  • החשבון הוסר או הושבת.

הורדת הדוח

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

הייחודיות של מזהה האובייקט

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

מזהה האובייקט היקף הייחודיות ייחודי בעולם?
מזהה תקציב גלובלי כן
מזהה קמפיין גלובלי כן
קוד זיהוי של קבוצת מודעות גלובלי כן
מזהה המודעה קבוצת מודעות לא. הצמד (AdGroupId, AdId) הוא ייחודי ברמת המערכת.
מזהה AdGroupCriterion קבוצת מודעות לא. הצמד (AdGroupId, CriterionId) הוא ייחודי ברמת המערכת.
CampaignCriterion ID קמפיין לא. הצמד (CampaignId, CriterionId) הוא ייחודי ברמת המערכת.
תוספים למודעות קמפיין לא. הצמד (CampaignId, AdExtensionId) הוא ייחודי ברמת המערכת.
מזהה העדכון גלובלי כן
מזהה הפריט בפיד גלובלי כן
מזהה מאפיין פיד פיד לא
מזהה מיפוי הפיד גלובלי כן
קוד זיהוי תווית גלובלי כן
מזהה רשימת משתמשים גלובלי כן