نقشه برداری شناسه برای تبلیغات جستجوی جدید 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"
}
معیار نگاشت شناسه برای معیارهای سطح گروه آگهی: 
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"
}
پس از میلاد نقشه برداری شناسه برای تبلیغات 
{
  "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"
}

دلایل رایج برای موجودیت های گم شده

در حالی که فایل نگاشت یک تبلیغ‌کننده شامل بیشتر موجودیت‌های آن‌ها می‌شود، هنوز مواردی وجود دارد که موجودیت‌ها وجود ندارند. در اینجا برخی از رایج ترین دلایل وجود دارد:

  • هر فایل نقشه برداری هر 3 روز یکبار به روز می شود. اگر یک فایل نگاشت بلافاصله پس از ایجاد یک موجودیت جدید دانلود شود، احتمالا موجودیت در فایل نگاشت وجود نخواهد داشت. احتمالاً پس از 3 روز انتظار شامل خواهد شد.
  • حسابی که نهاد به آن تعلق دارد حذف می شود. در این مورد از نگاشت شناسه پشتیبانی نمی‌کنیم.

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

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 ) در سطح جهانی منحصر به فرد است.
شناسه فید جهانی بله
شناسه مورد فید جهانی بله
شناسه ویژگی فید خوراک خیر
شناسه نقشه‌برداری فید جهانی بله
شناسه برچسب جهانی بله
شناسه لیست کاربری جهانی بله