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

แนะนําคําสําคัญที่สามารถทํางานได้ดีกว่าคําสําคัญที่ระบุ

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

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

หมายเหตุ

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
AdGroupId	ตัวระบุกลุ่มโฆษณาสําหรับคีย์เวิร์ดที่แนะนํา องค์ประกอบนี้ยังไม่ได้รับการสนับสนุน และอาจใช้เพื่อมีผลต่อคําแนะนําคําสําคัญในการเผยแพร่ในอนาคต	ยาว
รหัสการส่งเสริมการขาย	ตัวระบุการส่งเสริมการขายสําหรับคําสําคัญที่แนะนํา องค์ประกอบนี้ยังไม่ได้รับการสนับสนุน และอาจใช้เพื่อมีผลต่อคําแนะนําคําสําคัญในการเผยแพร่ในอนาคต	ยาว
ExcludeBrand	ค่าที่กําหนดว่าผลลัพธ์ไม่รวมคําสําคัญของแบรนด์หรือไม่ หากต้องการยกเว้นคีย์เวิร์ดของแบรนด์ในผลลัพธ์ ให้ตั้งค่าเป็น จริง ค่าเริ่มต้นคือ เท็จ	บูลีน
คำ	อาร์เรย์ของคําสําคัญที่คุณต้องการรับคําสําคัญที่แนะนําที่สามารถทํางานได้ดียิ่งขึ้น อาร์เรย์สามารถมีคําสําคัญได้สูงสุด 1,000 คํา และคําสําคัญแต่ละคําสามารถมีได้สูงสุด 100 อักขระ	อาร์เรย์สตริง
ภาษา	ภาษาที่ใช้เขียนคําสําคัญ ค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้คืออังกฤษฝรั่งเศส และเยอรมัน ดูส่วน หมายเหตุ ด้านล่างสําหรับรายการของผู้ให้บริการที่ได้รับการสนับสนุนสําหรับแต่ละภาษา ค่าเริ่มต้นคือภาษาอังกฤษ	สาย อักขระ
MaxSuggestionsPerKeyword	จํานวนสูงสุดของการแนะนําคําสําคัญที่จะส่งกลับสําหรับคําสําคัญแต่ละคําที่ระบุ ถ้า SuggestionType ถูกตั้งค่าเป็น 4 คุณสามารถร้องขอคําแนะนําได้สูงสุด 200 รายการต่อคําสําคัญหนึ่งคํา มิฉะนั้นคําแนะนําสูงสุดที่คุณสามารถร้องขอได้คือ 100 ค่าเริ่มต้นคือ 50	Int
PublisherCountries	รหัสประเทศของประเทศ/ภูมิภาคที่จะใช้เป็นแหล่งข้อมูลสําหรับการกําหนดคําสําคัญที่แนะนํา คุณสามารถระบุรหัสประเทศได้หนึ่งหรือหลายรหัส แต่ละประเทศ/ภูมิภาคที่คุณระบุต้องสนับสนุนภาษาที่คุณระบุในองค์ประกอบภาษา สําหรับค่าที่รองรับ โปรดดูส่วน หมายเหตุ ด้านล่าง ค่าเริ่มต้นคือประเทศ/ภูมิภาคทั้งหมดที่สนับสนุนภาษาที่ระบุ	อาร์เรย์สตริง
RemoveDuplicates	ค่าบูลีนที่กําหนดว่าจะเอาคําสําคัญที่ซ้ํากันออกจากรายการคําสําคัญที่แนะนําหรือไม่ เมื่อต้องการเอารายการที่ซ้ํากันออก ให้ตั้งค่าเป็น จริง ค่าเริ่มต้นคือ เท็จ	บูลีน
SuggestionType	ตัวให้บริการที่จะใช้ในการสร้างข้อเสนอแนะคําสําคัญ สําหรับรายการของผู้ให้บริการที่เป็นไปได้ ข้อจํากัดของภาษาและประเทศ/ภูมิภาคของผู้ให้บริการแต่ละราย และผู้ให้บริการเริ่มต้นตามประเทศ/ภูมิภาค ให้ดูส่วน หมายเหตุ ด้านล่าง	Int

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

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

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

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

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

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

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

องค์ ประกอบ	คำอธิบาย	ชนิดข้อมูล
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">SuggestKeywordsFromExistingKeywords</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>
    <SuggestKeywordsFromExistingKeywordsRequest 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>
      <Language i:nil="false">ValueHere</Language>
      <PublisherCountries i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </PublisherCountries>
      <MaxSuggestionsPerKeyword i:nil="false">ValueHere</MaxSuggestionsPerKeyword>
      <SuggestionType i:nil="false">ValueHere</SuggestionType>
      <RemoveDuplicates i:nil="false">ValueHere</RemoveDuplicates>
      <ExcludeBrand i:nil="false">ValueHere</ExcludeBrand>
      <AdGroupId i:nil="false">ValueHere</AdGroupId>
      <CampaignId i:nil="false">ValueHere</CampaignId>
    </SuggestKeywordsFromExistingKeywordsRequest>
  </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>
    <SuggestKeywordsFromExistingKeywordsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordSuggestions d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordSuggestion>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <SuggestionsAndConfidence d4p1:nil="false">
            <KeywordAndConfidence>
              <SuggestedKeyword d4p1:nil="false">ValueHere</SuggestedKeyword>
              <ConfidenceScore>ValueHere</ConfidenceScore>
            </KeywordAndConfidence>
          </SuggestionsAndConfidence>
        </KeywordSuggestion>
      </KeywordSuggestions>
    </SuggestKeywordsFromExistingKeywordsResponse>
  </s:Body>
</s:Envelope>

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

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

public async Task<SuggestKeywordsFromExistingKeywordsResponse> SuggestKeywordsFromExistingKeywordsAsync(
	IList<string> keywords,
	string language,
	IList<string> publisherCountries,
	int? maxSuggestionsPerKeyword,
	int? suggestionType,
	bool? removeDuplicates,
	bool? excludeBrand,
	long? adGroupId,
	long? campaignId)
{
	var request = new SuggestKeywordsFromExistingKeywordsRequest
	{
		Keywords = keywords,
		Language = language,
		PublisherCountries = publisherCountries,
		MaxSuggestionsPerKeyword = maxSuggestionsPerKeyword,
		SuggestionType = suggestionType,
		RemoveDuplicates = removeDuplicates,
		ExcludeBrand = excludeBrand,
		AdGroupId = adGroupId,
		CampaignId = campaignId
	};

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

static SuggestKeywordsFromExistingKeywordsResponse suggestKeywordsFromExistingKeywords(
	ArrayOfstring keywords,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	int maxSuggestionsPerKeyword,
	int suggestionType,
	boolean removeDuplicates,
	boolean excludeBrand,
	java.lang.Long adGroupId,
	java.lang.Long campaignId) throws RemoteException, Exception
{
	SuggestKeywordsFromExistingKeywordsRequest request = new SuggestKeywordsFromExistingKeywordsRequest();

	request.setKeywords(keywords);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setMaxSuggestionsPerKeyword(maxSuggestionsPerKeyword);
	request.setSuggestionType(suggestionType);
	request.setRemoveDuplicates(removeDuplicates);
	request.setExcludeBrand(excludeBrand);
	request.setAdGroupId(adGroupId);
	request.setCampaignId(campaignId);

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

static function SuggestKeywordsFromExistingKeywords(
	$keywords,
	$language,
	$publisherCountries,
	$maxSuggestionsPerKeyword,
	$suggestionType,
	$removeDuplicates,
	$excludeBrand,
	$adGroupId,
	$campaignId)
{

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

	$request = new SuggestKeywordsFromExistingKeywordsRequest();

	$request->Keywords = $keywords;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->MaxSuggestionsPerKeyword = $maxSuggestionsPerKeyword;
	$request->SuggestionType = $suggestionType;
	$request->RemoveDuplicates = $removeDuplicates;
	$request->ExcludeBrand = $excludeBrand;
	$request->AdGroupId = $adGroupId;
	$request->CampaignId = $campaignId;

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

response=adinsight_service.SuggestKeywordsFromExistingKeywords(
	Keywords=Keywords,
	Language=Language,
	PublisherCountries=PublisherCountries,
	MaxSuggestionsPerKeyword=MaxSuggestionsPerKeyword,
	SuggestionType=SuggestionType,
	RemoveDuplicates=RemoveDuplicates,
	ExcludeBrand=ExcludeBrand,
	AdGroupId=AdGroupId,
	CampaignId=CampaignId)

หมาย เหตุ

ต่อไปนี้คือตัวให้บริการคําแนะนําที่เป็นไปได้ที่คุณสามารถระบุได้

ชนิดคําแนะนํา	คำอธิบาย
1	แสดงคิวรีการค้นหาที่มีคําสําคัญ
2	ส่งกลับคีย์เวิร์ดจากกลุ่มโฆษณาอื่น ๆ ที่มีคีย์เวิร์ดที่ระบุ
3	แสดงคิวรีการค้นหาที่เกี่ยวข้องกับคําสําคัญที่ระบุ
4	ส่งกลับคําแนะนําที่ดีที่สุดจากผู้ให้บริการรายอื่น

ต่อไปนี้คือผู้ให้บริการที่แต่ละประเทศ/ภูมิภาคสนับสนุน

ประเทศ/ภูมิภาค	ภาษา	ชนิดผู้ให้บริการที่ได้รับการสนับสนุน	ชนิดผู้ให้บริการเริ่มต้น
ออสเตรเลีย (AU)	English	2,3,4	4
แคนาดา (CA)	English	2,3,4	4
ฝรั่งเศส (FR)	French	2,3,4	4
เยอรมนี (DE)	German	1,2,3,4	4

ข้อกําหนด

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