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

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن توفر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات إعداد التقارير والعمليات. مزيد من المعلومات عن نقل البيانات إلى التجربة الجديدة من "إعلانات شبكة البحث 360" واستخدامها 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"
}
معيار الوظائف تعيين رقم التعريف لـ: 
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 ربط المعرّف 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) فريد عالميًا.
الرقم التعريفي للخلاصة عالمي نعم
الرقم التعريفي لعنصر الخلاصة عالمي نعم
رقم تعريف سمة الخلاصة الخلاصة لا
الرقم التعريفي لتخطيط الخلاصة عالمي نعم
الرقم التعريفي للتصنيف عالمي نعم
رقم تعريف قائمة المستخدمين عالمي نعم