تعيين رقم التعريف لتجربة "إعلانات شبكة البحث 360" الجديدة

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على المزيد من المعلومات عن نقل البيانات إلى واجهة Search Ads 360 Reporting API الجديدة واستخدامها.

تحتوي الكيانات في التجربة الجديدة من "إعلانات شبكة البحث 360" على مساحة أرقام تعريف مختلفة عن تلك التي تحتوي عليها التجربة السابقة من "إعلانات شبكة البحث 360". لربط رقم التعريف بين التجربتَين السابقة والجديدة من "إعلانات شبكة البحث 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 لمسار الكيان الكامل في التجربة السابقة من "إعلانات شبكة البحث 360"

  • New IDs: سلسلة JSON لمسار الكيان الكامل في التجربة الجديدة من "إعلانات شبكة البحث 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"
}
أندورا تعيين رقم تعريف 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"
}

تنزيل التقرير

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()

تفرد رقم تعريف العنصر

يتم التعرّف على كل عنصر في تجربة "إعلانات شبكة البحث 360" الجديدة من خلال رقم تعريفه. وتكون بعض أرقام التعريف هذه فريدة على المستوى العالمي في جميع الحسابات في التجربة الجديدة من "إعلانات شبكة البحث 360"، في حين تكون أرقام تعريف أخرى فريدة ضمن نطاق محدود. على سبيل المثال، عليك استخدام كلٍّ من أرقام تعريف المجموعات الإعلانية وأرقام تعريف الإعلانات لتحديد الإعلانات بشكلٍ فريد، لأنّه يتم تخصيص أرقام تعريف الإعلانات بشكلٍ فريد لكل مجموعة إعلانية، وليس على مستوى المجموعات الإعلانية. في ما يلي توضيح لمدى التفرّد في كل رقم تعريف عنصر ضمن التجربة الجديدة من "إعلانات شبكة البحث 360". ويمكن أن تكون قواعد المعرّف هذه مفيدة عند تصميم مساحة تخزين محلية لعناصر التجربة الجديدة من "إعلانات شبكة البحث 360".

رقم تعريف العنصر نطاق التفرّد هل هي فريدة من نوعها عالميًا؟
معرِّف الميزانية البلدان المتحدثة نعم
معرّف الحملة البلدان المتحدثة نعم
معرف المجموعة الإعلانية البلدان المتحدثة نعم
الرقم التعريفي للإعلان المجموعة الإعلانية لا. الزوج (AdGroupId، AdId) فريد عالميًا.
الرقم التعريفي لمعيار المجموعة الإعلانية المجموعة الإعلانية لا. الزوج (AdGroupId، CriterionId) فريد عالميًا.
الرقم التعريفي لمعيار الحملة الحملة لا. الزوج (CampaignId، CriterionId) فريد عالميًا.
معلومات الإعلان الإضافية الحملة لا. الزوج (CampaignId، AdExtensionId) فريد عالميًا.
الرقم التعريفي للخلاصة البلدان المتحدثة نعم
الرقم التعريفي لعنصر الخلاصة البلدان المتحدثة نعم
الرقم التعريفي لسمة الخلاصة الخلاصة لا
رقم تعريف تخطيط الخلاصة البلدان المتحدثة نعم
الرقم التعريفي للتصنيف البلدان المتحدثة نعم
رقم تعريف UserList البلدان المتحدثة نعم