การดําเนินการบริการ GetKeywordIdeas - ข้อมูลเชิงลึกของโฆษณา
รับรายการแนวคิดคําสําคัญ
แนะนํากลุ่มโฆษณาและคีย์เวิร์ดใหม่โดยอิงตามคีย์เวิร์ด ที่มีอยู่ เว็บไซต์ และหมวดหมู่ผลิตภัณฑ์ คุณยังสามารถร้องขอสถิติในอดีตสําหรับคีย์เวิร์ด เช่น การค้นหารายเดือน การแข่งขัน CPC เฉลี่ย และการแชร์การแสดงผลโฆษณา คุณสามารถใช้การเสนอราคาคําสําคัญที่แนะนําที่ส่งคืนเป็นข้อมูลป้อนเข้าในการดําเนินการ GetKeywordTrafficEstimates ได้
เคล็ดลับ
สําหรับภาพรวม โปรดดูคําแนะนําทางเทคนิคเกี่ยวกับแนวคิดคําสําคัญและการประเมินปริมาณการใช้งาน
ร้องขอองค์ประกอบ
วัตถุ GetKeywordIdeasRequest จะกําหนดองค์ประกอบ เนื้อ ความและ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP
หมายเหตุ
เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด
ร้องขอองค์ประกอบเนื้อความ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
ExpandIdeas | กําหนดว่าคุณต้องการแนวคิดคําสําคัญใหม่ หรือถ้าคุณต้องการเฉพาะแอตทริบิวต์คําสําคัญสําหรับชุดของคําสําคัญที่คุณระบุในรายการ SearchParameters ถ้าคุณตั้งค่าองค์ประกอบนี้เท็จ วัตถุ QuerySearchParameter จะต้องรวมอยู่ในรายการ SearchParameters | บูลีน |
IdeaAttributes | แอตทริบิวต์แนวคิดคําหลักที่คุณต้องการให้รวมอยู่ในการตอบกลับ เช่น คําสําคัญ, การแข่งขัน, MonthlySearchCounts และ SuggestedBid ต้องระบุแอตทริบิวต์การแข่งขัน แอตทริบิวต์ คําสําคัญ จะถูกส่งกลับสําหรับแต่ละ KeywordIdea ที่ส่งกลับไม่ว่าคุณจะใส่ค่า คีย์เวิร์ด ในรายการแอตทริบิวต์แนวคิดที่ร้องขอหรือไม่ |
อาร์เรย์ KeywordIdeaAttribute |
SearchParameters | พารามิเตอร์การค้นหาจะกําหนดเกณฑ์และตัวกรองของคุณสําหรับแนวคิดคําหลักที่ร้องขอ อย่าสร้างอินสแตนซ์ของ SearchParameter คุณสามารถรวมวัตถุอย่างน้อยหนึ่งวัตถุต่อไปนี้ที่มาจากวัตถุนั้น: CategorySearchParameterCompetitionSearchParameter, DateRangeSearchParameter, DeviceSearchParameter, ExcludeAccountKeywordsSearchParameter, IdeaTextSearchParameter, ImpressionShareSearchParameter, LanguageSearchParameter, LocationSearchParameter, NetworkSearchParameter, QuerySearchParameter, SearchVolumeSearchParameter, SuggestedBidSearchParameter และ UrlSearchParameter วัตถุอื่นๆ ที่สืบทอดมาจาก SearchParameter ไม่ถูกต้องสําหรับการดําเนินการนี้ คุณไม่สามารถรวมรายการซ้ําของชนิดพารามิเตอร์การค้นหาใดๆ ได้ รายการต้องมีพารามิเตอร์การค้นหาเหล่านี้ทั้งหมด: LanguageSearchParameter, LocationSearchParameter และ NetworkSearchParameter รายการต้องมีอย่างน้อยหนึ่งพารามิเตอร์การค้นหาเหล่านี้: CategorySearchParameter, QuerySearchParameter หรือ UrlSearchParameter ถ้าองค์ประกอบ ExpandIdeas เป็นเท็จ แล้ว QuerySearchParameter เป็นสิ่งจําเป็นไม่ว่าคุณจะใส่พารามิเตอร์การค้นหาเพิ่มเติมหรือไม่ อาจใช้เวลาถึง 72 ชั่วโมงเพื่อให้ข้อมูลของเดือนปฏิทินก่อนหน้าพร้อมใช้งาน ตัวอย่างเช่น ถ้าคุณร้องขอแนวคิดคําหลักในวันที่ 1 สิงหาคม 2nd หรือ 3 สิงหาคม และข้อมูลของเดือนกรกฎาคมไม่พร้อม การตอบสนองจะขึ้นอยู่กับข้อมูลของเดือนมิถุนายน ถ้าคุณไม่รวม DateRangeSearchParameter ในคําขอ GetKeywordIdeas คุณจะไม่สามารถยืนยันได้ว่าข้อมูลในรายการแรกเป็นข้อมูลสําหรับเดือนก่อนหน้าหรือเดือนก่อนหน้า ถ้ามีการระบุช่วงวันที่และข้อมูลของเดือนล่าสุดยังไม่พร้อมใช้งาน GetKeywordIdeas จะส่งกลับข้อผิดพลาด |
อาร์เรย์ SearchParameter |
องค์ประกอบส่วนหัวของคําขอ
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
AuthenticationToken | โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth |
สาย อักขระ |
CustomerAccountId | ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
CustomerId | ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ |
สาย อักขระ |
DeveloperToken | โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา |
สาย อักขระ |
รหัส ผ่าน | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
ชื่อ | องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ | สาย อักขระ |
องค์ประกอบการตอบสนอง
วัตถุ GetKeywordIdeasResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP
องค์ประกอบเนื้อความการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
KeywordIdeas | รายการแนวคิดคําหลัก สามารถส่งกลับข้อมูลในรายการได้สูงสุด 3,000 รายการในขณะนี้ แม้ว่าขีดจํากัดอาจเปลี่ยนแปลงได้ |
อาร์เรย์ KeywordIdea |
องค์ประกอบส่วนหัวการตอบสนอง
องค์ ประกอบ | คำอธิบาย | ชนิดข้อมูล |
---|---|---|
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">GetKeywordIdeas</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>
<GetKeywordIdeasRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
<ExpandIdeas i:nil="false">ValueHere</ExpandIdeas>
<IdeaAttributes i:nil="false">
<KeywordIdeaAttribute>ValueHere</KeywordIdeaAttribute>
</IdeaAttributes>
<SearchParameters i:nil="false">
<SearchParameter i:type="-- derived type specified here with the appropriate prefix --">
<!--This field is applicable if the derived type attribute is set to QuerySearchParameter-->
<Queries i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:string>ValueHere</a1:string>
</Queries>
<!--This field is applicable if the derived type attribute is set to UrlSearchParameter-->
<Url i:nil="false">ValueHere</Url>
<!--This field is applicable if the derived type attribute is set to CategorySearchParameter-->
<CategoryId>ValueHere</CategoryId>
<!--These fields are applicable if the derived type attribute is set to SearchVolumeSearchParameter-->
<Maximum i:nil="false">ValueHere</Maximum>
<Minimum i:nil="false">ValueHere</Minimum>
<!--These fields are applicable if the derived type attribute is set to SuggestedBidSearchParameter-->
<Maximum i:nil="false">ValueHere</Maximum>
<Minimum i:nil="false">ValueHere</Minimum>
<!--These fields are applicable if the derived type attribute is set to IdeaTextSearchParameter-->
<Excluded i:nil="false">
<Keyword>
<Id i:nil="false">ValueHere</Id>
<MatchType>ValueHere</MatchType>
<Text i:nil="false">ValueHere</Text>
</Keyword>
</Excluded>
<Included i:nil="false">
<Keyword>
<Id i:nil="false">ValueHere</Id>
<MatchType>ValueHere</MatchType>
<Text i:nil="false">ValueHere</Text>
</Keyword>
</Included>
<!--This field is applicable if the derived type attribute is set to ExcludeAccountKeywordsSearchParameter-->
<ExcludeAccountKeywords>ValueHere</ExcludeAccountKeywords>
<!--These fields are applicable if the derived type attribute is set to ImpressionShareSearchParameter-->
<Maximum i:nil="false">ValueHere</Maximum>
<Minimum i:nil="false">ValueHere</Minimum>
<!--This field is applicable if the derived type attribute is set to LocationSearchParameter-->
<Locations i:nil="false">
<LocationCriterion>
<LocationId>ValueHere</LocationId>
</LocationCriterion>
</Locations>
<!--This field is applicable if the derived type attribute is set to NetworkSearchParameter-->
<Network i:nil="false">
<Network>ValueHere</Network>
</Network>
<!--This field is applicable if the derived type attribute is set to DeviceSearchParameter-->
<Device i:nil="false">
<DeviceName i:nil="false">ValueHere</DeviceName>
</Device>
<!--This field is applicable if the derived type attribute is set to LanguageSearchParameter-->
<Languages i:nil="false">
<LanguageCriterion>
<Language i:nil="false">ValueHere</Language>
</LanguageCriterion>
</Languages>
<!--This field is applicable if the derived type attribute is set to CompetitionSearchParameter-->
<CompetitionLevels i:nil="false">
<CompetitionLevel>ValueHere</CompetitionLevel>
</CompetitionLevels>
<!--These fields are applicable if the derived type attribute is set to DateRangeSearchParameter-->
<EndDate i:nil="false">
<Day>ValueHere</Day>
<Month>ValueHere</Month>
<Year>ValueHere</Year>
</EndDate>
<StartDate i:nil="false">
<Day>ValueHere</Day>
<Month>ValueHere</Month>
<Year>ValueHere</Year>
</StartDate>
</SearchParameter>
</SearchParameters>
</GetKeywordIdeasRequest>
</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>
<GetKeywordIdeasResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
<KeywordIdeas d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<KeywordIdea>
<AdGroupId d4p1:nil="false">ValueHere</AdGroupId>
<AdGroupName d4p1:nil="false">ValueHere</AdGroupName>
<AdImpressionShare d4p1:nil="false">ValueHere</AdImpressionShare>
<Competition d4p1:nil="false">ValueHere</Competition>
<Keyword d4p1:nil="false">ValueHere</Keyword>
<MonthlySearchCounts d4p1:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<a1:long>ValueHere</a1:long>
</MonthlySearchCounts>
<Relevance d4p1:nil="false">ValueHere</Relevance>
<Source d4p1:nil="false">ValueHere</Source>
<SuggestedBid d4p1:nil="false">ValueHere</SuggestedBid>
</KeywordIdea>
</KeywordIdeas>
</GetKeywordIdeasResponse>
</s:Body>
</s:Envelope>
ไวยากรณ์โค้ด
ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม
public async Task<GetKeywordIdeasResponse> GetKeywordIdeasAsync(
bool? expandIdeas,
IList<KeywordIdeaAttribute> ideaAttributes,
IList<SearchParameter> searchParameters)
{
var request = new GetKeywordIdeasRequest
{
ExpandIdeas = expandIdeas,
IdeaAttributes = ideaAttributes,
SearchParameters = searchParameters
};
return (await AdInsightService.CallAsync((s, r) => s.GetKeywordIdeasAsync(r), request));
}
static GetKeywordIdeasResponse getKeywordIdeas(
boolean expandIdeas,
ArrayOfKeywordIdeaAttribute ideaAttributes,
ArrayOfSearchParameter searchParameters) throws RemoteException, Exception
{
GetKeywordIdeasRequest request = new GetKeywordIdeasRequest();
request.setExpandIdeas(expandIdeas);
request.setIdeaAttributes(ideaAttributes);
request.setSearchParameters(searchParameters);
return AdInsightService.getService().getKeywordIdeas(request);
}
static function GetKeywordIdeas(
$expandIdeas,
$ideaAttributes,
$searchParameters)
{
$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];
$request = new GetKeywordIdeasRequest();
$request->ExpandIdeas = $expandIdeas;
$request->IdeaAttributes = $ideaAttributes;
$request->SearchParameters = $searchParameters;
return $GLOBALS['AdInsightProxy']->GetService()->GetKeywordIdeas($request);
}
response=adinsight_service.GetKeywordIdeas(
ExpandIdeas=ExpandIdeas,
IdeaAttributes=IdeaAttributes,
SearchParameters=SearchParameters)
ข้อกําหนด
บริการ: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13