מיפוי מזהים לממשק החדש של 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 ימים.
  • החשבון שאליו הישות שייכת יוסר. במקרה כזה, אנחנו לא תומכים במיפוי זהויות.

הורדת הדוח

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.

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