AdWords API: eerste stappen

De Google AdWords Application Programming Interface (API) is ontworpen voor ontwikkel bedrijven die belangrijke adverteerders of derden vertegenwoordigen met uitgebreide technische ervaring.

Welke hulpprogramma’s biedt de AdWords API?

• Genereer automatisch zoekwoorden, advertentietekst, doelpagina’s en aangepaste rapporten.

• Integreer AdWords-gegevens met voorraad systeem om op aandelen gebaseerde campagnes te beheren.

• Extra tools en toepassingen ontwikkelen om u te helpen uw accounts te beheren

De AdWords API instellen

Als u de AdWords-API wilt gebruiken, moet u een ontwikkelaars token krijgen in het MCC-account of de beheerdersaccount.

Als u het ontwikkelaars token wilt aanvragen, gaat u naar de accountinstellingen.

Zodra we toegang hebben tot de accountinstellingen, hebben we toegang tot het “AdWords API Center”.

Wanneer we verbinding maken, zullen we een formulier zien in te vullen en dus vragen dat ze ons een programmeur token nodig om te werken met de AdWords API.

Zodra de toegang wordt gevraagd zal het scherm worden bijgewerkt en onze “programmeur token” zal verschijnen in test accounts mode.

Als u wilt werken met de AdWords-API voor dit account, moet u een aanvraag indienen voor basis toegang, maar in dit geval gaan we werken met de API, met een TEST account in AdWords.

AdWords-TEST account

Als u een test-type account wilt maken in AdWords, moet u de Google-formulier Om dit type account te maken.

AdWords-test-API-formulier

Zodra we de test account hebben gemaakt, zullen we zien dat bij het benaderen van AdWords een bericht verschijnt met de mededeling dat we een testtype account zijn.

Als de MCC-test account is gemaakt, maken we een AdWords-account gekoppeld aan onze MCC-test account. In dit account is waar we zullen al onze tests te doen met de AdWords API.

Zodra wij het hebben, houden wij de cliënt identiteitskaart van de rekening, voor later gebruik het.

Nu zullen we een aantal referenties om de Google-api’s te gebruiken, in ons geval voor de AdWords API.

OAUTH2 accreditatie voor ontwikkel-

Google API’S gebruiken referenties om deze API’S te gebruiken.

Om die geloofsbrieven te krijgen moeten we de Developer console.

Als we gaan naar de testtype account dat we zojuist hebben gemaakt te gebruiken, loggen we in de developer console met die account (als we gaan naar de API te gebruiken met de normale account, zullen we hetzelfde doen).

Console API Google-referenties

Al ingelogd, hebben we toegang tot het menu “referenties”, als we niet al een project gemaakt, zal vragen om een nieuw project te maken.

Klik op “Create a project”, geef de gewenste naam op en klik op Create.

OAuth-referenties

Nu we ons project hebben gecreëerd, kunnen we de geloofsbrieven creëren die we wilden. Om dit te doen, in “Create referenties”, selecteer “OAuth client ID”.

In de vorm die zal verschijnen voor ons, selecteren we “andere” en voeg de naam die we willen toewijzen aan hem. En zodra wij het creëren, zullen wij onze geloofsbrieven hebben!

We zullen onze klant-ID en het geheim van de klant zien.

We bewaren deze gegevens voor later en we zullen dichter bij de start met behulp van de ADWORDS API .

De clientbibliotheek ophalen

Het AdWords API-platform stelt ons in staat om deze API te gebruiken met verschillende programmeertalen, in ons geval zullen we gebruik maken van PHP.

Naast PHP ook de bibliotheken van JAVA, PYTHON, etc…

• • Voor het downloaden van de bibliotheek in PHP, moet je de bestanden te downloaden van Github.
  • Als u wilt downloaden van andere talen, u dit doen vanuit Hier

Nu moeten we gewoon de API te starten.

API-instellingen

Nu we de bibliotheek hebben, zullen we het configuratie bestand te wijzigen, in dit bestand zal worden toegevoegd de referenties en de nodige accountgegevens.

Het bestand heet auth. ini en bevindt zich op:

googleads-php-lib / src / Google / API / Ads / AdWords / auth.ini

Als we het bewerken, zullen we zien dat er verschillende commentaar lijnen en dat we vragen om bepaalde informatie in de variabelen.

• • DeveloperToken: in deze variabele moeten we de ontwikkelaar token dat we besteld in onze productie-account toe te voegen.
  • clientCustomerId: deze lijn is commentaar, zoals we zullen beginnen met het accounttype test, zullen we uncomment en voeg de id van de rekening die we eerder hadden gemaakt. Als wanneer we in productie zijn willen we werken met verschillende accounts, gewoon commentaar en geef die identifier op een dynamische manier.

• • client_id: hier moeten we de identificatie van de geloofsbrieven invoegen OAuth we al hebben gemaakt.

• • Client_secret: hier moeten we het geheim ook verkregen uit OAuth.
  • Refresh_token: dit is de laatste gegevens die we missen, om het te verkrijgen hebben we uit te voeren in de console het bestand GetRefreshToken. php.

Ontvang Refresh_token:

Eerst slaan we het bestand auth. ini met de geloofsbrieven die we al hebben ingevoegd.

Open de console of terminal van ons besturingssysteem, in mijn geval zal ik gebruik maken van de Windows-console (cmd).

Vanuit naar de lessenaar wij vlaag naar de pad waarheen welk woninggids zit, hiervoor wij voordragen naar de volgend troepenleiding:

php googleads-php-lib-masterexamplesAdWordsAuthGetRefreshToken.php

Wanneer u het uitvoert, zult u ons vragen om verbinding te maken met onze AdWords-account (in dit geval in onze testtype account) en toegang tot een URL.

Sluit niet de console want dan zullen we de geretourneerde code te plakken!

GetRefreshToken console

Als de URL enigszins lijkt op INSERT_OAUTH2_CLIENT_ID_HERE, betekent dit dat we het bestand auth. ini niet hebben opgeslagen met de gegevens van de referenties.

Daarom, wanneer we het commando uit te voeren aangegeven, moeten we merken dat de URL die ons terugkeert, bevat in die sectie de client-ID.

Machtigingen voor AdWords API

Als alles goed gaat, zal Google toestemming vragen om onze AdWords-campagnes te beheren.

Wanneer wij de toestemmingen goedkeuren, zullen wij een code zien, moeten wij het kopiëren en kleven in de uitvoering van het bevel dat wij enkel in console hebben gemaakt.

Plak de code waar aangegeven, druk op ENTER en… onze refresh_token zal verschijnen!

Token-API AdWords vernieuwen

Nu deze code, we opnemen in het bestand auth. ini en we zullen hebben geconfigureerd en het uitvoeren van de AdWords API!

AdWords API-uitvoering

Om de AdWords API te kunnen gebruiken, gebruiken we de voorbeelden bestanden die in de gedownloade bibliotheek verschijnen.

Laten we het voorbeeld uitvoeren dat nieuwe campagnes maakt. Om dit te doen, gaan we naar de console, en voer het bestand AddCampaigns. PHP, gelegen in:

examplesAdWordsv201609BasicOperations

Voorbeeld van AdWords API

Standaard worden deze bestanden alleen uitgevoerd in de console, maar als je ze wilt draaien in een serveromgeving, moeten we reageren op deze regels van de code.

if (__FILE__ != realpath($_SERVER['PHP_SELF'])) {   return; }

En tot nu toe het proces van het configureren van de AdWords-API is een enigszins lang proces, maar het resultaat is de moeite waard.

Voor vragen aarzel dan niet om te vragen! Ook hier laat ik de referentie van de AdWords API. Succes!