การแมปรหัสสำหรับ 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"
}
แคมเปญ การแมปรหัสสําหรับแคมเปญ 
{
 "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"
}
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 วัน
  • ระบบจะนำบัญชีที่บุคคลนั้นเป็นเจ้าของออก เราไม่รองรับการแมปรหัสในกรณีนี้
  • Search Ads 360 เวอร์ชันใหม่ไม่รองรับการอัปเดตเอนทิตี (เช่น แคมเปญ) ฝั่งเครื่องมือค้นหา การอัปเดตได้รับการจัดการโดยการสร้างเอนทิตี Search Ads 360 ใหม่ มีการอัปเดตและนําเอนทิตี Search Ads 360 เวอร์ชันเก่าออก
  • เป็นไปได้ว่าระบบนําการแมปก่อนหน้าออกเนื่องจากการซิงค์ระหว่าง Search Ads 360 เวอร์ชันเก่ากับเวอร์ชันใหม่ ซึ่งจะเก็บเฉพาะการแมปล่าสุดไว้ ระบบจะแก้ไขการแมปหลายรายการระหว่างรหัสเดิมรายการเดียวกับรหัส Search Ads 360 ใหม่หลายรายการ โดยเก็บรหัสที่มีการประทับเวลาล่าสุดไว้
  • ระบบไม่ซิงค์บัญชีเครื่องมือเนื่องจากข้อผิดพลาดในการซิงค์ระหว่าง Search Ads 360 เวอร์ชันเก่ากับเวอร์ชันใหม่
  • ระบบจะนำบัญชีออกหรือปิดใช้

ดาวน์โหลดรายงาน

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 ใหม่

รหัสออบเจ็กต์ ขอบเขตของการไม่ซ้ำกัน ซ้ำกันทั่วโลกไหม
รหัสงบประมาณ ทั่วโลก ใช่
รหัสแคมเปญ ทั่วโลก ใช่
รหัส AdGroup ทั่วโลก ใช่
รหัสโฆษณา กลุ่มโฆษณา ไม่ คู่ (AdGroupId, AdId) ซ้ำกันทั่วโลก
รหัส AdGroupCriterion กลุ่มโฆษณา ไม่ คู่ (AdGroupId, CriterionId) ซ้ำกันทั่วโลก
รหัส CampaignCriterion แคมเปญ ไม่ คู่ (CampaignId, CriterionId) ซ้ำกันทั่วโลก
ส่วนขยายโฆษณา แคมเปญ ไม่ คู่ (CampaignId, AdExtensionId) ซ้ำกันทั่วโลก
รหัสฟีด ทั่วโลก ใช่
รหัสรายการฟีด ทั่วโลก ใช่
รหัสแอตทริบิวต์ฟีด ฟีด ไม่
รหัสการแมปฟีด ทั่วโลก ใช่
รหัสป้ายกำกับ ทั่วโลก ใช่
รหัส UserList ทั่วโลก ใช่