نقشه برداری شناسه برای تبلیغات جستجوی جدید 360

API جدید Search Ads 360 Reporting اکنون در دسترس است. 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"
}
پویش نقشه برداری شناسه برای کمپین . 
{
 "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"
}
معیار نقشه برداری شناسه برای: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
آگهی نقشه برداری شناسه برای تبلیغات 
{
  "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 نقشه برداری شناسه برای خوراک آیتم . 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

گزارش را دانلود کنید

JSON

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

پایتون

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 جدید شما مفید باشد.

شناسه شی دامنه منحصر به فرد بودن در سطح جهانی منحصر به فرد؟
شناسه بودجه جهانی آره
شناسه کمپین جهانی آره
شناسه AdGroup جهانی آره
شناسه آگهی گروه تبلیغات شماره ( AdGroupId ، AdId ) در سطح جهانی منحصر به فرد است.
AdGroupCriterion ID گروه تبلیغات شماره ( AdGroupId , CriterionId ) در سطح جهانی منحصر به فرد است.
CampaignCriterion ID پویش جفت ( CampaignId , CriterionId ) در سطح جهانی منحصر به فرد است.
پسوندهای تبلیغاتی پویش خیر. جفت ( CampaignId , AdExtensionId ) در سطح جهانی منحصر به فرد است.
شناسه فید جهانی آره
شناسه مورد فید جهانی آره
شناسه ویژگی فید خوراک خیر
شناسه نقشه‌برداری فید جهانی آره
شناسه برچسب جهانی آره
شناسه لیست کاربری جهانی آره