การดําเนินการบริการ GetEstimatedPositionByKeywords - ข้อมูลเชิงลึกของโฆษณา

รับตําแหน่งโดยประมาณในผลลัพธ์การค้นหาถ้าจะใช้ค่าการเสนอราคาที่ระบุสําหรับคําสําคัญที่ระบุ นอกจากนี้ การดําเนินการยังประมาณการจํานวนคลิก ต้นทุนเฉลี่ยต่อการคลิก (CPC) และการแสดงผลที่อาจสร้างคีย์เวิร์ดด้วยการเสนอราคาโดยประมาณ

การประเมินไม่ใช่การคาดการณ์หรือการรับประกันประสิทธิภาพในอนาคต

หมายเหตุ

การดําเนินการนี้สําหรับแคมเปญการค้นหาที่ใช้กลยุทธ์การเสนอราคา CPC ที่ปรับปรุงประสิทธิภาพแล้ว

ร้องขอองค์ประกอบ

วัตถุ GetEstimatedPositionByKeywordsRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP

หมายเหตุ

เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด

ร้องขอองค์ประกอบเนื้อความ

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AdGroupId	ตัวระบุกลุ่มโฆษณาที่ใช้ข้อมูลประสิทธิภาพการทํางานเพื่อช่วยกําหนดว่าคีย์เวิร์ดอาจทํางานได้ดีเพียงใดในบริบทของกลุ่มโฆษณา การระบุกลุ่มโฆษณาจะช่วยปรับปรุงความแม่นยําของตําแหน่งที่แนะนํา หากคุณระบุกลุ่มโฆษณา คุณต้องระบุแคมเปญที่อยู่ในกลุ่ม	ยาว
รหัสการส่งเสริมการขาย	ตัวระบุแคมเปญที่เป็นเจ้าของกลุ่มโฆษณาที่ระบุใน AdGroupId หากคุณไม่ได้ระบุกลุ่มโฆษณา ระบบจะใช้ข้อมูลประสิทธิภาพของแคมเปญเพื่อช่วยในการพิจารณาว่าคีย์เวิร์ดอาจทํางานในบริบทของแคมเปญได้ดีเพียงใด การระบุแคมเปญและกลุ่มโฆษณาจะช่วยปรับปรุงความแม่นยําของตําแหน่งที่แนะนํา ถ้าไม่มีการระบุ AdGroupId หรือ CampaignId การดําเนินการจะใช้องค์ประกอบส่วนหัว CustomerAccountId ที่ระบุเพื่อช่วยกําหนดว่าคําหลักอาจทํางานได้ดีเพียงใดในบริบทของบัญชี	ยาว
CurrencyCode	รหัส ISO สําหรับหน่วยเงินเพื่อใช้ในการคํานวณการประเมินต้นทุนและค่าเสนอราคาที่แนะนํา ถ้าไม่ได้ตั้งค่า บริการจะกําหนดสกุลเงินจากบัญชีที่ระบุในองค์ประกอบส่วนหัว CustomerAccountId ถ้าไม่มีการตั้งค่า สกุลเงิน หรือ CustomerAccountId บริการจะใช้ USD	CurrencyCode
คำ	อาร์เรย์ของคําสําคัญที่คุณต้องการให้ได้รับตําแหน่งโดยประมาณในผลลัพธ์การค้นหาตามค่าการเสนอราคาที่ระบุ คุณสามารถระบุคําสําคัญได้สูงสุด 1,000 คํา และคําสําคัญแต่ละคําสามารถมีได้สูงสุด 100 อักขระ	อาร์เรย์สตริง
ภาษา	ภาษาที่ใช้ควบคู่ไปกับตัวระบุตําแหน่งที่ตั้งสําหรับการประเมินตําแหน่ง ภาษาต้องได้รับการสนับสนุนในแต่ละตําแหน่งที่ตั้งที่คุณระบุใน LocationIds สําหรับค่าภาษาที่เป็นไปได้ โปรดดู ภาษาโฆษณา หากคุณไม่ได้ระบุภาษา การดําเนินการบริการจะใช้ภาษาของ AdGroupId หรือ CampaignId ที่ระบุ ถ้าไม่มีคุณสมบัติเหล่านี้ถูกตั้งค่า แล้ว EN (ภาษาอังกฤษ) จะถูกใช้ตามค่าเริ่มต้น	สาย อักขระ
LocationIds	ตัวระบุหรือตัวระบุของตําแหน่งที่ตั้งทางภูมิศาสตร์ที่จะใช้สําหรับการประเมินตําแหน่ง ตําแหน่งที่ตั้งทั้งหมดต้องสนับสนุนภาษาที่ระบุในองค์ประกอบ Language แม้ว่าคุณสามารถระบุตัวระบุตําแหน่งที่ตั้งได้หลายรายการ เพื่อเป็นแนวทางปฏิบัติที่ดีที่สุดสําหรับการประเมินตําแหน่งที่ถูกต้องที่สุดต่อตําแหน่งที่ตั้ง แต่คุณควรระบุเพียงหนึ่งตําแหน่งที่ตั้งต่อหนึ่งการโทรบริการ สําหรับตัวระบุตําแหน่งที่ตั้งที่เป็นไปได้ ให้ดู รหัสตําแหน่งที่ตั้งทางภูมิศาสตร์ ถ้าคุณไม่ได้ระบุตําแหน่งที่ตั้งใดๆ การดําเนินการบริการจะใช้เงื่อนไขตําแหน่งที่ตั้งของ AdGroupId หรือ CampaignId ที่ระบุ ถ้าไม่มีคุณสมบัติเหล่านี้ถูกตั้งค่า แล้ว 190 (สหรัฐอเมริกา) จะถูกใช้ตามค่าเริ่มต้น	อาร์เรย์ยาว
MatchTypes	อาร์เรย์ของชนิดการจับคู่ที่ไม่ซ้ํากันที่คุณต้องการรับค่าประมาณ คุณไม่สามารถระบุชนิดเนื้อหาที่ตรงกันได้	อาร์เรย์ MatchType
MaxBid	ค่าการเสนอราคาสูงสุดที่จะใช้เพื่อกําหนดตําแหน่งโดยประมาณในผลลัพธ์การค้นหา	คู่

องค์ประกอบส่วนหัวของคําขอ

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AuthenticationToken	โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth	สาย อักขระ
CustomerAccountId	ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ	สาย อักขระ
CustomerId	ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ	สาย อักขระ
DeveloperToken	โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา	สาย อักขระ
รหัส ผ่าน	องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้	สาย อักขระ
ชื่อ	องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้	สาย อักขระ

องค์ประกอบการตอบสนอง

วัตถุ GetEstimatedPositionByKeywordsResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP

องค์ประกอบเนื้อความการตอบสนอง

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
คําสําคัญที่ประเมินแล้ว	อาร์เรย์ของวัตถุข้อมูล KeywordEstimatedPosition อาร์เรย์ ประกอบด้วยรายการสําหรับคําสําคัญแต่ละรายการที่ระบุในคําขอ ถ้าคําสําคัญไม่ถูกต้อง หน่วยข้อมูลที่สอดคล้องกันในอาร์เรย์จะเป็น Null หากข้อมูลพร้อมใช้งานสําหรับคีย์เวิร์ด EstimatedPositionAndTraffic จะแสดงตําแหน่งโดยประมาณในผลการค้นหาที่โฆษณาของคุณอาจปรากฏ ตามค่าการเสนอราคาที่ระบุ มิฉะนั้น องค์ประกอบ EstimatedPositions จะถูกตั้งค่าเป็น Null	อาร์เรย์ KeywordEstimatedPosition

องค์ประกอบส่วนหัวการตอบสนอง

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
TrackingId	ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API	สาย อักขระ

ร้องขอ SOAP

เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดง ลําดับ ขององค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับคําขอ SOAP สําหรับชนิดที่สนับสนุนที่คุณสามารถใช้กับการดําเนินการบริการนี้ โปรดดูการอ้างอิง องค์ประกอบเนื้อความคําขอ ด้านบน

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <Action mustUnderstand="1">GetEstimatedPositionByKeywords</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetEstimatedPositionByKeywordsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Keywords>
      <MaxBid>ValueHere</MaxBid>
      <Language i:nil="false">ValueHere</Language>
      <LocationIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </LocationIds>
      <CurrencyCode i:nil="false">ValueHere</CurrencyCode>
      <MatchTypes i:nil="false">
        <MatchType>ValueHere</MatchType>
      </MatchTypes>
      <CampaignId i:nil="false">ValueHere</CampaignId>
      <AdGroupId i:nil="false">ValueHere</AdGroupId>
    </GetEstimatedPositionByKeywordsRequest>
  </s:Body>
</s:Envelope>

Response SOAP

เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงลําดับขององค์ประกอบ เนื้อ ความและ ส่วนหัว สําหรับการตอบสนอง SOAP

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <GetEstimatedPositionByKeywordsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordEstimatedPositions d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordEstimatedPosition>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <EstimatedPositions d4p1:nil="false">
            <EstimatedPositionAndTraffic>
              <MatchType>ValueHere</MatchType>
              <MinClicksPerWeek>ValueHere</MinClicksPerWeek>
              <MaxClicksPerWeek>ValueHere</MaxClicksPerWeek>
              <AverageCPC>ValueHere</AverageCPC>
              <MinImpressionsPerWeek>ValueHere</MinImpressionsPerWeek>
              <MaxImpressionsPerWeek>ValueHere</MaxImpressionsPerWeek>
              <CTR>ValueHere</CTR>
              <MinTotalCostPerWeek>ValueHere</MinTotalCostPerWeek>
              <MaxTotalCostPerWeek>ValueHere</MaxTotalCostPerWeek>
              <CurrencyCode>ValueHere</CurrencyCode>
              <EstimatedAdPosition>ValueHere</EstimatedAdPosition>
            </EstimatedPositionAndTraffic>
          </EstimatedPositions>
        </KeywordEstimatedPosition>
      </KeywordEstimatedPositions>
    </GetEstimatedPositionByKeywordsResponse>
  </s:Body>
</s:Envelope>

ไวยากรณ์โค้ด

ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม

public async Task<GetEstimatedPositionByKeywordsResponse> GetEstimatedPositionByKeywordsAsync(
	IList<string> keywords,
	double maxBid,
	string language,
	IList<long> locationIds,
	CurrencyCode? currencyCode,
	IList<MatchType> matchTypes,
	long? campaignId,
	long? adGroupId)
{
	var request = new GetEstimatedPositionByKeywordsRequest
	{
		Keywords = keywords,
		MaxBid = maxBid,
		Language = language,
		LocationIds = locationIds,
		CurrencyCode = currencyCode,
		MatchTypes = matchTypes,
		CampaignId = campaignId,
		AdGroupId = adGroupId
	};

	return (await AdInsightService.CallAsync((s, r) => s.GetEstimatedPositionByKeywordsAsync(r), request));
}

static GetEstimatedPositionByKeywordsResponse getEstimatedPositionByKeywords(
	ArrayOfstring keywords,
	double maxBid,
	java.lang.String language,
	ArrayOflong locationIds,
	CurrencyCode currencyCode,
	ArrayOfMatchType matchTypes,
	java.lang.Long campaignId,
	java.lang.Long adGroupId) throws RemoteException, Exception
{
	GetEstimatedPositionByKeywordsRequest request = new GetEstimatedPositionByKeywordsRequest();

	request.setKeywords(keywords);
	request.setMaxBid(maxBid);
	request.setLanguage(language);
	request.setLocationIds(locationIds);
	request.setCurrencyCode(currencyCode);
	request.setMatchTypes(matchTypes);
	request.setCampaignId(campaignId);
	request.setAdGroupId(adGroupId);

	return AdInsightService.getService().getEstimatedPositionByKeywords(request);
}

static function GetEstimatedPositionByKeywords(
	$keywords,
	$maxBid,
	$language,
	$locationIds,
	$currencyCode,
	$matchTypes,
	$campaignId,
	$adGroupId)
{

	$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];

	$request = new GetEstimatedPositionByKeywordsRequest();

	$request->Keywords = $keywords;
	$request->MaxBid = $maxBid;
	$request->Language = $language;
	$request->LocationIds = $locationIds;
	$request->CurrencyCode = $currencyCode;
	$request->MatchTypes = $matchTypes;
	$request->CampaignId = $campaignId;
	$request->AdGroupId = $adGroupId;

	return $GLOBALS['AdInsightProxy']->GetService()->GetEstimatedPositionByKeywords($request);
}

response=adinsight_service.GetEstimatedPositionByKeywords(
	Keywords=Keywords,
	MaxBid=MaxBid,
	Language=Language,
	LocationIds=LocationIds,
	CurrencyCode=CurrencyCode,
	MatchTypes=MatchTypes,
	CampaignId=CampaignId,
	AdGroupId=AdGroupId)

ข้อกําหนด

บริการ: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13