Codes für geografische Standorte
Geografische Standortdaten können für Standortadressierung verwendet werden, z. B. Anzeigen für Personen in einem bestimmten Land/einer bestimmten Region, einem Bundesland/einer bestimmten Provinz, einem Bezirk, einem Metro-Gebiet (Microsoft Market Area im USA), der Postleitzahl oder dem Ort. Sie können den Vorgang GetGeoLocationsFileUrl aufrufen, um eine temporäre Datei-URL abzurufen, die zum Herunterladen der daten der neuesten geografischen Standorte verwendet werden kann. Sie können die Standortdaten auch aus dem Microsoft Advertising-Entwicklerportal abrufen. Sie müssen beim Entwicklerportal mit einem Microsoft-Kontobenutzer angemeldet sein, der über Microsoft Advertising-Anmeldeinformationen verfügt.
Hinweis
Als bewährte Methode sollten Sie die Datei herunterladen, anstatt sie direkt über eine Anwendung wie Microsoft Excel zu öffnen. Wenn Sie die Standortdaten in einem Text-Editor anzeigen, achten Sie darauf, utf-8-Codierung anstelle von ANSI zu verwenden. Andernfalls werden einige Zeichen nicht korrekt angezeigt.
Codebeispiele zum Herunterladen der Codes für geografische Standorte finden Sie unter Codebeispiel für geografische Standorte.
Dateiformat für Speicherortcodes
Die CSV-Datei (Comma Separated Value) enthält Daten, die in den folgenden nicht lokalisierten Spaltenüberschriften organisiert sind. Nur der Bing-Anzeigename wird je nach der oben verwendeten Datei-URL lokalisiert.
Wichtig
Neue Spalten können jederzeit hinzugefügt werden, sodass Ihre Implementierung unbekannte Spalten ignorieren muss.
Die Reihenfolge der Speicherorte ist nicht garantiert, sodass Sie keine Abhängigkeiten von einer wahrgenommenen Spaltensortierreihenfolge oder Hierarchie annehmen sollten.
DateiformatVersion 2.0
Wenn Sie version als 2.0 angegeben haben, wenn Sie den GetGeoLocationsFileUrl-Vorgang aufrufen, sind die folgenden Daten in der heruntergeladenen Datei verfügbar. Die Bing Ads-API unterstützt derzeit nur Dateiformatversion 2.0.
| Spaltenname | Beschreibung |
|---|---|
| Standort-ID | Der eindeutige Microsoft Advertising-Systembezeichner für den Standort. Sie müssen diesen Wert verwenden, um das Standortkriterium festzulegen. |
| Bing-Anzeigename | Der optionale Name, den Sie verwenden können, um die Standortdaten anzuzeigen, z. B. für Benutzer Ihrer Anwendung. Vertikale Balken werden verwendet, um die Standortkomponenten von den meisten und den geringsten spezifisch zu trennen. Beispiel: Seattle|Washington|USA die spezifischste Komponente ist die Stadt Seattle im Bundesstaat Washington der USA. Mehrere Speicherort-IDs können denselben Anzeigenamen aufweisen. Sie dürfen den Anzeigenamen nur für Präsentationen verwenden, z. B. keine Hierarchie annehmen oder Abhängigkeiten vom Anzeigenamen übernehmen. |
| Speicherorttyp | Bestimmt den Standortuntertyp (z. B. City, County, Country, MetroArea, PostalCode oder State), der der Spalte Standort-ID entspricht. Nachbarschaftsstandorte sind in Kürze verfügbar. Neue Standortuntertypen können jederzeit hinzugefügt werden. In seltenen Fällen ändert sich der Standorttyp für eine bestimmte Standort-ID. |
| Ersetzt | Für die zukünftige Verwendung reserviert, um anzugeben, welche Position bzw. welche Standorte durch den Standort in dieser Zeile ersetzt werden. |
| Status | Gibt an, ob der Speicherort in dieser Zeile aktiv ist, aussteht oder veraltet ist. - Aktiv: Sie können den Standort als Ziel festlegen oder ausschließen. - Ausstehende Einstellung: Der Speicherort wird weiterhin von der Übermittlungs-Engine für Ziel- oder Ausschlüsse verwendet; Der Standort wird jedoch innerhalb der nächsten 30 Tage als veraltet gekennzeichnet. - Veraltet: Das Standortkriterium wird nicht mehr für Ziel- oder Ausschlüsse verwendet. Veraltete Standortkriterien können weiterhin über die Bing Ads-API abgerufen werden, z. B. GetCampaignCriterionsByIds. Sie können jedoch keine veralteten Standortkriterien hinzufügen oder aktualisieren. Rufen Sie den Vorgang GetGeoLocationsFileUrl einmal oder zweimal im Monat auf, um festzustellen, ob sich der Inhalt der Datei geändert hat, z. B. status. Sie sollten die gesamte Datei nicht herunterladen müssen, es sei denn, der zurückgegebene LastModifiedTimeUtc-Wert hat sich seit der letzten Synchronisierung der Standortdaten geändert. |
| AdWords-Standort-ID | Die Google Ads-Standort-ID, die der ID des geografischen Standorts von Microsoft Advertising am nächsten kommt. Sie können dies verwenden, um Microsoft Advertising-Standorte den geschätzten Google Ads-Standorten zuzuordnen. Dieser Wert ist eine heuristische Schätzung, die für die Zuordnung der geografischen Standorte von Google Ads und Microsoft Advertising verwendet werden kann. Das Feld ist leer, wenn der Speicherort nicht zugeordnet wurde. |
Ländercodes
In einigen Kontexten erfordert die API eine Ländercodezeichenfolge, z. B. für die Geschäftsadresse eines AdvertiserAccount-Objekts . Die folgenden Ländercodes werden von Microsoft Advertising unterstützt.
| Country Code | Name des Landes/der Region |
|---|---|
| AF | Afghanistan |
| AL | Albanien |
| DZ | Algerien |
| AS | Amerikanisch-Samoa |
| AD | Andorra |
| AO | Angola |
| AI | Anguilla |
| AQ | Antarktis |
| AG | Antigua und Barbuda |
| AR | Argentinien |
| BIN | Armenien |
| AW | Aruba |
| AU | Australien |
| AT | Österreich |
| AZ | Aserbaidschan |
| BS | Bahamas, die |
| BH | Bahrain |
| BD | Bangladesch |
| BB | Barbados |
| BY | Belarus |
| WERDEN | Belgien |
| BZ | Belize |
| BJ | Benin |
| BM | Bermuda |
| BT | Bhutan |
| BO | Bolivien |
| EINE | Bonaire, Curaçao, Saba, Sint Eustatius, Sint Maarten |
| BA | Bosnien und Herzegowina |
| BW | Botsuana |
| BR | Brasilien |
| MRD | Brunei |
| BG | Bulgarien |
| BF | Burkina Faso |
| BI | Burundi |
| Kostenabweichung (KA) | Cabo Verde |
| KH | Kambodscha |
| CM | Kamerun |
| CA | Kanada |
| KY | Kaimaninseln |
| CF | Zentralafrika |
| TD | Tschad |
| CL | Chile |
| CN | China |
| CX | Weihnachtsinsel |
| CC | Kokosinseln |
| CO | Kolumbien |
| KM | Komoren |
| CG | Congo |
| CD | Congo (DRC) |
| CK | Cookinseln |
| CR | Costa Rica |
| CI | Côte d'Ivoire |
| HR | Kroatien |
| CY | Zypern |
| CZ | Tschechien |
| DK | Dänemark |
| DJ | Dschibuti |
| DM | Dominica |
| TUN | Dominikanische Republik |
| EG | Ecuador |
| ZB | Ägypten |
| Planabweichung (PA) | El Salvador |
| GQ | Äquatorialguinea |
| ER | Eritrea |
| EE | Estland |
| ET | Äthiopien |
| FK | Falklandinseln |
| FO | Färöer |
| FJ | Fidschi-Inseln |
| FI | Finnland |
| FR | Frankreich |
| GF | Französisch-Guayana |
| PF | Französisch-Polynesien |
| Allgemein verfügbar | Gabun |
| GM | Gambia, die |
| GE | Georgien |
| DE | Deutschland |
| GH | Ghana |
| GI | Gibraltar |
| GR | Griechenland |
| GL | Grönland |
| GD | Grenada |
| GP | Guadeloupe |
| GU | Guam |
| Gt | Guatemala |
| GN | Guinea |
| GW | Guinea-Bissau |
| GY | Guyana |
| HT | Haiti |
| HN | Honduras |
| HK | Hongkong (SAR) |
| HU | Ungarn |
| IST | Island |
| IN | Indien |
| ID | Indonesien |
| IQ | Irak |
| IE | Irland |
| IL | Israel |
| IT-Abteilung | Italien |
| JM | Jamaika |
| JP | Japan |
| JO | Jordanien |
| KZ | Kasachstan |
| KE | Kenia |
| KI | Kiribati |
| KR | Korea |
| KW | Kuwait |
| KG | Kirgisistan |
| LA | Laos |
| LV | Lettland |
| LB | Libanon |
| LS | Lesotho |
| LR | Liberia |
| LY | Libyen |
| LI | Liechtenstein |
| LT | Litauen |
| LU | Luxemburg |
| MO | Macao SAR |
| MK | Nordmazedonien, ehemalige jugoslawische Republik |
| MG | Madagaskar |
| MW | Malawi |
| MEINE | Malaysia |
| MV | Malediven |
| ML | Mali |
| MT | Malta |
| MH | Marshall-Inseln |
| MQ | Martinique |
| HERR | Mauretanien |
| MU | Mauritius |
| YT | Mayotte |
| MX | Mexiko |
| FM | Mikronesien |
| MD | Republik Moldau |
| MC | Monaco |
| MN | Mongolei |
| ICH | Montenegro |
| MS | Montserrat |
| MA | Marokko |
| MZ | Mosambik |
| MM | Myanmar |
| – | Namibia |
| NR | Nauru |
| NP | Nepal |
| NL | Niederlande |
| NC | Neukaledonien |
| NZ | Neuseeland |
| NI | Nicaragua |
| NE | Niger |
| NG | Nigeria |
| NU | Niue |
| NF | Norfolkinsel |
| MP | Nördliche Marianen |
| NEIN | Norwegen |
| OM | Oman |
| PK | Pakistan |
| PW | Palau |
| PS | Palästinensische Gebiete |
| PA | Panama |
| PG | Papua-Neuguinea |
| PY | Paraguay |
| PE | Peru |
| PH | Philippinen |
| PN | Pitcairninseln |
| PL | Polen |
| PT | Portugal |
| PR | Puerto Rico |
| QA | Katar |
| RE | Reunion |
| RO | Rumänien |
| RU | Russland |
| RW | Ruanda |
| SH | St. Helena |
| KN | St. Kitts und Nevis |
| LC | St. Lucia |
| PM | St. Pierre und Miquelon |
| VC | St. Vincent und die Grenadinen |
| WS | Samoa |
| SM | San Marino |
| ST | Sao Tomé und Príncipe |
| SA | Saudi Arabien |
| SN | Senegal |
| RS | Serbien |
| SC | Seychellen |
| SL | Sierra Leone |
| SG | Singapur |
| SK | Slowakei |
| SI | Slowenien |
| SB | Salomonen |
| ALSO | Somalia |
| ZA | Südafrika |
| ES | Spanien |
| LK | Sri Lanka |
| SR | Suriname |
| SZ | Swasiland |
| SE | Schweden |
| CH | Schweiz |
| TW | Taiwan |
| TJ | Tadschikistan |
| TZ | Tansania |
| TH | Thailand |
| TL | Timor-Leste |
| SF | Togo |
| TK | Tokelau |
| TO | Tonga |
| TT | Trinidad und Tobago |
| TN | Tunesien |
| TR | Türkei |
| TM | Turkmenistan |
| TC | Turks- und Caicosinseln |
| TV | Tuvalu |
| UG | Uganda |
| UA | Ukraine |
| AE | Vereinigte Arabische Emirate |
| GB | Vereinigtes Königreich |
| US | Vereinigte Staaten |
| UY | Uruguay |
| UZ | Usbekistan |
| VU | Vanuatu |
| VA | Vatikanstadt |
| VE | Venezuela |
| VN | Vietnam |
| VG | Jungferninseln, Britisch |
| VI | Jungferninseln, USA |
| WF | Wallis und Futuna |
| IHR | Jemen |
| ZM | Sambia |
| ZW | Simbabwe |